기본 콘텐츠로 건너뛰기

[node.js] Jade Template Engine을 활용한 효율적 관리

node.js에서는 jade와 ejs라는 템플릿 엔진을 이용하여 html파일로 렌더링을 할 수 있습니다. 블로그 주인은 ejs보다 jade를 애용합니다. 이유는 {/% /%}, <>와 같은 특수 문자를 조금 덜 사용하는 jade를 선호합니다. 하지만 jade는 tab과 space로 구문을 해석하는 단점이 있습니다.
이번 시간에는 어떻게 하면 효율적인 html파일 관리를 할 수 있을지 설명을 해보도록 하겠습니다. (아래 내용은 100% 정답이 아니라 다양한 방식으로 사용해오면서 발전된 방법입니다. 앞으로도 계속 변할 것이고, 추후에 추가되거나 바뀌는 부분에 대해서는 추가적으로 포스팅을 하겠습니다.)
jade의 문법적인 내용을 다루지 않습니다.
express를 활용하여 프로젝트를 생성을 해보도록 하겠습니다.
  • project create
$ express helloWorld  # CREATED helloWorld Directory
$ cd helloWorld       # MOVED helloWorld
  • project structure
+-- app.js
+-- bin
|   +-- www
+-- package.json
+-- public
|   +-- javascript
|   +-- css
|   +-- images
+-- routes
|   +-- user.js
|   +-- indexs.js
+-- views
|   +-- error.jade
|   +-- index.jade
|   +-- layout.jade
views를 집중적으로 탐구를 해 볼 것이다.
  • error.jade
extends layout

block content
  h1= message
  h2= error.status
  pre #{error.stack}
  • index.jade
extends layout

block content
  h1= title
  p Welcome to #{title}
error.jade, index.jade파일에서 layout을 extends하고 있다. 또한 block content가 보입니다. 다른 프로그래밍 언어에서 extends가 대충 어떤 느낌으로 작동하는지 감이 오셨을 겁니다.
아래의 layout.jade코드를 살펴 보도록 하겠습니다.
  • layout.jade
doctype html
html
  head
    title= title
    link(rel='stylesheet', href='/stylesheets/style.css')
  body
    block content
기본적인 html구조가 보입니다. 그런데 user.jade와 error.jade에서 보았던 block content가 보이는 군요 이 부분이 바로 해당 소스 코드를 붙여서 만들어 주는 부분입니다.
index.jade파일을 랜더링을 시도를 하게 되면 우선 extent layout을 했기 때문에 layout.jade파일을 읽어 드립니다.
그리고 block content를 index.jade에 있는 block content 이하 부분으로 채우게 됩니다. 최종적으로는 아래와 같은 코드가 만들어 질겁니다.
  • index.jade 렌더링시 만들어지는 중간 결과물
doctype html
html
  head
    title= title
    link(rel='stylesheet', href='/stylesheets/style.css')
  body
    h1= title
    p Welcome to #{title}
content부분을 그대로 옮기게 됩니다.
여기까지 extends의 사용 방법에 대해서 알아 보았습니다.
여기까지 보고 첫번째로 왜 굳이 이렇게 layout을 나누는 것일지 의문을 가질 수 있습니다.
이유는 반복되는 코드(dry한 코드 작성)를 줄이기 위해서 입니다. 이는 매우 중요한 이론입니다.
하나가 수정이 이루어져야 하면 반드시 하나만 수정이 일어나야 합니다.
우리가 보는 웹 사이트들을 잘 살펴보면 상단에 위차한 header, 하단에 위치한 footer와 같은 것들은 고정이 되어있는것을 확인을 할 수 있을겁니다.
만약 html로 페이지를 만들게 되면 모든 페이지의 header, footer가 같은 코드로 반복적으로 작성이 이루어지게 될 것입니다.
하지만 jade와 같은 템플릿 엔진을 활용하면 이러한 반복된 코드 작성을 줄여줍니다.
  • layout.jade
doctype html
html
  head
    title= title
    link(rel='stylesheet', href='/stylesheets/style.css')
  body
    header
        // header 관련 코드

    block content

    footer
        // footer 관련 코드
  • business_logic1.jade
extends layout

block content
    // logic code1
  • business_logic2.jade
extends layout

block content
    // logic code2
이러한 형태로 header와 footer를 layout에 넣어 줌으로써 서로 다른 부분의 영역만 집중적으로 관리가 가능해집니다.
하지만 이러한 형태도 아직은 불안정 합니다. header와 footer또한 각각의 기능이 뚜렷하고 기능이 추가되어 무거워 질 수 있습니다. 즉 독립적인 파일로 관리를 하는 것이 추후 유지 보수에 좀더 좋을 것 같습니다.
header와 footer도 layout파일과 분리를 해보도록 하겠습니다.
그전에 views의 내부를 좀 수정을 해보도록 하겠습니다.
  • views directory
+-- layouts
+-- business
+-- components
layouts, business, components로 디렉토리를 재 구성 해줍니다.
  • components : 위에서 언급한 header, footer같이 부품처럼 쓰이는 존재
  • layouts : components를 활용하여 반복되는 코드를 미리 만들어 둠
  • business : 실제 로직이 들어가는 부분
디렉토리를 재 구성했으니 각각의 필요한 파일을 재 구성을 해보도록 하겠습니다.
+-- layouts
|   +-- business_logic1_layout.jade
|   +-- business_logic2_layout.jade
+-- business
|   +-- business_logic1
|       +-- index.jade
|       +-- error.jade
|   +-- business_logic2
|       +-- index.jade
|       +-- error.jade
+-- components
|   +-- header.jade
|   +-- footer.jade
우선 위에서 언급한 header, footer를 compoenets에 추가를 해주었습니다.
include를 활용하여 layout에서 해당 파일을 불러와 사용을 해보도록 하겠습니다.
  • ./components/header.jade
header
    // header 관련 코드
  • ./components/footer.jade
footer
    // footer 관련 코드
layout에서 작성했던 header와 footer부분의 코드를 그대로 빼줍니다.
그리고 layouts/business_logic1_layout에서 해당 파일을 include를 해주면 됩니다.
  • ./layouts/business_logic1_layout.jade
doctype html
html
  head
    title= title
    link(rel='stylesheet', href='/stylesheets/style.css')
  body
    include '../components/header'

    block content

    include '../components/footer'
business/business_logic1/error.jade와 business/business_logic1/index.jade에서 layout 호출 부분을 수정을 해보도록 하겠습니다. (디렉토리 생성을 하였기 때문에 경로를 바꾸어 주어야 합니다.)
  • error.jade
extends ../../layouts/business_logic1_layout

block content
  h1= message
  h2= error.status
  pre #{error.stack}
  • index.jade
extends ../../layouts/business_logic1_layout

block content
  h1= title
  p Welcome to #{title}
components, layouts, business의 형태로 좀더 효율적인 구조를 만들었습니다.
각 비지니스 로직이 다른 레이아웃을 사용 할 수 있기 때문에 레이아웃 사용여부에 따라 business내부를 디렉토리를 나누었습니다. 물론 이 부분은 해당 프로젝트에 맞추어 더 세분화 시켜도 되고 굳이 세분화 할 필요는 없습니다. 간단한 대규모가 아닌 이상 레이아웃 하나 만으로도 충분할거거든요 ㅎㅎㅎ
만약 관리자 페이지가 있다면 관리자에 대한 레이아웃을 추가시켜주면 됩니다. 해당 로직 부분을 business에 추가를 시켜주어 만들어 주면 됩니다.
라벨:

댓글

댓글 쓰기

이 블로그의 인기 게시물

[node.js] 파일 리더기 만들기 - 사용 모듈 정리, pdf 구조, hwp 구조

pdf -> html 변환 가장 무난하다. 기본적으로 pdf는 htm와 비슷한 형태의 구조를 가지고 있다. 크게 header , body , xref table , trailer 의 구조로 되어있다. pdf는 환경에 상관없이 표현을 하기 위한 목적을 가지고 있는 파일이다. 이런 이유 때문에 무난히 진행이 된 것 같다. pdf2htmlex와 pdftohtmljs라는 모듈을 이용을 했다. var pdftohtml = require ( 'pdftohtmljs' ) ; var converter = new pdftohtml ( 'test.pdf' , "sample.html" ) ; converter . convert ( 'ipad' ) . then ( function ( ) { console . log ( "Success" ) ; } ) . catch ( function ( err ) { console . error ( "Conversion error: " + err ) ; } ) ; 이미지나, text같은 것들이 거의 100%로 변환이 된다. docx -> html 변환 docx파일을 html파일로 변환을 할 때는 style 적용과 한글이 깨지는 문제가 있다. 텍스트들을 전부 잘 읽기는 하는데 스타일 정보를 제대로 가져오지 못하기 때문에 좀 애매하다 - Headings. - Lists. - Customisable mapping from your own docx styles to HTML. For instance, you could convert WarningHeading to h1.warning by providing an appropriate style ...
댓글 쓰기
자세한 내용 보기

[css] css로 프린트 방지하기

웹에서 프린트 제어가 불가능 한 줄 알았는데 프린트 클릭 시  스크립트로 해당 이벤트를 받아올 수 있다. 하지만 스크립트를 사용하는 방법은 브라우저마다 작동을 하지 않을 수 있다. 좀 더 찾아보니 css로 인쇄되는 영역을 제어를 해줄 수 있다.  @media print 를 이용하면 된다. < html > < head > < title > print test page < / title > < style > @media print { . np { display : none ; } } < / style > < / head > < body > < div class = "np" > test < / div > < div > test1 < / div > < div > test1 < / div > < div > test1 < / div > < / body > < / html > 위 코드를 보면 np 클래스를 @media print에 넣어주었다. @media print는 인쇄됐을 때의 스타일을 지정을 해주는 것이다.  위에서는 해당 페이지를 인쇄할 때 p를 display : none으로 가려주었다. @media print를 이용하면 좀 더 멋진 인쇄물을 만들 수 ...
댓글 쓰기
자세한 내용 보기

[알고리즘] snake게임 알고리즘

막무가네로 알고리즘을 공부하면 재미가 없으니 게임을 접목하여 다루어 보도록 하겠습니다. 게임의 대상은 스네이크 게임입니다. 많은 사람들은 어릴 때 뱀게임을 많이 해봤을 것 입니다. 이번에 다뤄볼 주제는 뱀이 움직임을 어떻게 구현을 할지 알아보겠습니다. 뱀은 크게 3가지의 경우가 있습니다 1. 가장 중요한 뱀을 움직이기 2. 음식먹기 이때 뱀은 크기가 늘어나야 합니다. 3. 뱀이 움직이는 정책   - 뱀이 움직이지 못하는 경우는 : 우측방향에서 좌측 방향으로 OR 위에 아래 방향고 같이 180도 반전되는 움직임은 막겠습니다. 순수한 알고리즘을 만드는 과정이기 때문에 음식을 먹었는지 안먹었는지 판단하는 부분은 랜덤으로 판단을 하도록 하겠습니다. def is_eat(): return random.choice([1, 0]) 랜덤으로 1, 0을 반환을 해줍니다. 실제로 게임을 만든다면 해당 함수는 뱀의 머리가 음식의 좌표와 같은지 검사를 해주면 되겠습니다. key_position_map = { 'w': [-1, 0], # up 's': [1, 0], # down 'a': [0, -1], # left 'd': [0, 1] # right } direction = key_position_map.get('d') 다음으로는 키맵핑을 한 오브젝트 입니다. direction은 현재 뱀의 방향을 나타냅니다. snake_body = [[2, 3], [1, 3],[1, 2], [1, 1]] 주인공이 되는 뱀의 좌표들 입니다. while True: key = input() new_direction = key_position_map.get(key) if new_direction and direction_check(direction, new_direction): directi...
댓글 쓰기
자세한 내용 보기