윈도우 정적 웹콘텐츠 개발 툴체인(Tool Chain)을 이해하고, 윈도우 정적 웹콘테츠 개발환경을 구축한다. 특히,소프트웨어 카펜트리 마크다운 콘텐츠를 HTML로 컴파일 한다.

1 정적 웹콘텐츠 제작환경 - 윈도우즈

정적 웹콘텐츠를 제킬(Jekyll) 기반으로 구축하기 위해서 제킬(Jekyll)과 관련된 소프트웨어도 함께 버젼을 맞추어서 설치해야 된다. 특히, 소프트웨어 카펜트리에서 정적 웹콘텐츠 저작을 위한 좋은 툴을 개발하여 활발히 사용되고 있다. 소프트웨어 카펜트리 저작 도구는 pandoc, jekyll에 기반하고 있고 근본에는 루비언어 기반으로 글로벌 협업도구 GitHub 인프라가 깔려있다.

  • 설치가 필요한 소프트웨어
  • RVM(Ruby Version Manager) : 루비 버젼 관리자
  • 팬독(Pandoc) : 마크다운 문서 변환 소프트웨어
  • 루비(Ruby) : 마츠모토 유키히로가 개발한 동적 객체 지향 스크립트 프로그래밍 언어.
  • 제킬(Jekyll) : GitHub 공동 창업자 Tom Preston-Werner이 루비로 작성한 단순하며, 블로그-인식, 정적사이트 생성 프로그램.
  • therubyracer : 루비 언어내에서 V8 자바스크립트 인터프리터를 내장. NodeJS 대신 경량화된 자바스크립트 인터프리터로 사용.
  • pandocfilters : pandoc 필터를 작성하는 파이썬 모듈. pandoc 필터는 파이프로 JSON을 받아 변환하여 출력한다.
  • kramdown : 루비로 작성된 마크다운 변환기
정적 웹콘텐츠 개발 툴체인

정적 웹콘텐츠 개발 툴체인

2 윈도우 툴체인 구축 절차

팬독(pandoc)과 루비 중 어떤 것을 먼지 설치할 것은 중요하지 않다. 제킬(Jekyll)이 루비에 의존성을 갖고, HTML, PDF 등 문서 생성에 팬독(pandoc)이 필요하기 때문에 독립적으로 각각 설치한다.

특히, 윈도우에서 제킬을 바로 설치하기 까다롭기 때문에 Chocolatey를 통해 제킬을 설치한다.

소프트웨어 카펜트리 교재 작성 템플릿을 사용하기 위해서 Make를 사용해야 하는데, 리눅스 계열은 자체 내장되어 있어 별도 설치가 필요없지만, 윈도우에서는 Git Bash를 사용해야 하는데, Make 가 포함되지 않아서 make를 다운로드 받아 Git Bash가 설치된 bin 폴더에 복사해 넣는 방법과 이전 msysGit net installer 버전 전체를 설치하는 방법이 있다.

  • 팬독(pandoc) 설치
  • 제킬(Jekyll) 설치
  • Git Bash Make
  • pandocfilter 설치 [^windows-pip]
    • 파이썬 2.7을 설치한다. 경로명 추가
    • setuptools 다운로드 받아 설치한다.
      • 윈도우 cmd 에서 python ez_setup.py 타이핑한다.
      • 윈도우 탐색기를 열고 파이썬 홈, C:\Python27\Scripts 이 생성되면 성공한 것이다.
      • 윈도우 환경변수, 경로에 C:\Python27\Scripts을 추가해서 어디서나 easy_install-2.7 명령어가 먹도록 조치한다.
    • easy_install-2.7 pip 명령어로 pip를 설치한다.
    • python -m pip install --upgrade pip 명령어로 pip 최신 버젼으로 올린다.
    • pip install pandocfilters 명령어로 pandocfilters를 마지막으로 설치한다.

3 소프트웨어 카펜트리 예제

소프트웨어 카펜트리를 교재 템플릿을 사용하는 Git 웹페이지를 하나 골라 복제한다. 그리고 나서 make preview 명령어를 실행할 경우, 모든 설정이 잘 된 경우 index.html 파일이 자동으로 생성되게 된다.