이제 슬슬 jekyll에 대해서 파보자.
계속 이 친구를 영어로 쓸 수는 없으니, 발음부터 알아보면,
제클(jeh·kl)이라고 발음하는 것 같다.
하지만 한국에서는 지킬이 훨씬 유명한 것 같으니 지킬이라고 사용하도록 하겠다.
지킬을 통해 웹 코드를 생성하기 위해 사용되는 파일 트리는 아래와 같다.
.
├── _config.yml
├── _drafts
├── _includes
| ├── footer.html
| └── header.html
├── _layouts
| ├── default.html
| └── post.html
├── _posts
| ├── 2020-02-10-welcome-to-jekyll.md
├── _sass
| ├── _base.scss
| └── _layout.scss
├── _site <-- 생성되는 폴더
├── 404.html
├── about.md
├── Gemfile
├── Gemfile.lock
└── index.html
이 파일들을 통해 생성되는 파일은 _site폴더에 저장된다.
우선 중요한 파일들에 대해 살펴보자.
- _config.yml : 위 파일 중 가장 중요한 파일이다. 이 파일에서 설정할 수 있는 것은 사이트 제목, 관리자 메일, 사이트 설명 등 사이트에 대한 일반적인 정보들이다. –> 관련 공식 문서
- _drafts : 이 폴더는 아직 작성 중인 문서들을 저장하는 역할을 한다. 사실 사이트에 반영되지 않기 때문에, 자신만의 폴더에서 작업해도 같은 효과를 얻을 수 있을 것 같지만,
jekyll serve 혹은 jekyll build에 --drafts 옵션을 주어서 실행하게 되면 해당 드래프트 문서들도 사이트에 반영할 수 있다. –> 관련 공식 문서
- _includes : 이 폴더는 페이지 레이아웃 및 게시물에 대해 재사용 가능한(include) 콘텐츠가 저장되는 위치이다. (e.g. 머릿글 혹은 바닥글) –> 관련 공식 문서
- _layouts : 이 폴더는 말 그대로 콘텐츠의 기본 레이아웃에 대한 템플릿을 포함한다. –> 관련 공식 문서
- _posts : 실제 게시물 콘텐츠가 저장되는 폴더이다. Markdown, HTML 형식의 게시물 혹은 “동적 콘텐츠”가 포함된다. 게시물의 파일 이름은
YYYY-MM-DD-Title-Of-This-Post.xxx와 같이 날짜로 시작되어야 한다. –> 관련 공식 문서
- _sass : 사이트의 스타일 시트를 저장하는 폴더이다. 폴더 이름에서도 알 수 있듯이 SASS를 사용한다. –> 관련 공식 문서 / Jekyll SASS 지정 예제
- _site : 지킬 엔진에 의해 변환된 모든 콘텐츠가 보관된다. (실제 지킬로 생성한 파일들이 저장되므로, 지킬을 실행만 한다면 이 폴더가 있든 없든 전혀 상관 없다.)
- 404.html : 404 페이지이다. 말 그대로 사이트 이용자가 특정 경로로 접근하였을 때, 해당 파일이 없으면 띄우는 페이지이다.
- about.md : 페이지 정보를 나타내는 사용자 작성 정적 페이지(일반적으로 사이트들에서 보여주는 about 페이지의 그것). 삭제해도 무방하지만 남아있다면 사이트 기본 탐색 시 나타난다.
- Gemfile 및 Gemfile.lock : 사이트의 Gem 종속성을 정의 (Bundler, Jekyll 빌드 시에 사용)
- index.html : 사이트 진입점 (md로도 작성 가능)
내일은 실제 지킬을 사용한 사이트 생성에 대해 작성하고자 한다.
오늘은 여기까지…