- jekyll 은 정적 사이트 생성기입니다. jekyll
- GitHub은 정적 페이지를 올려놓고 서빙하는 기능을 지원합니다. 특히 jekyll 은 빌트인으로 지원합니다. Github pages with Jekyll
- 저장소의
master브랜치에 푸시하면 퍼블리시 됩니다.
- jekyll 을 설치하고, 이 저장소를 클론한 다음에 로컬 서버를 띄워 볼 수 있습니다.
$ gem install jekyll bundler
$ bundle install
$ bundle exec jekyll serve . --incremental
-
만약 미래 날짜로 포스트를 작성했다면,
bundle exec jekyll serve . --future으로 띄우셔야 포스트를 볼 수 있습니다. -
생성된 정적 사이트의 HTML/CSS 소스파일 등은
_site디렉토리 아래에서 확인할 수 있습니다. -
혹은, Docker를 이용하면 컴퓨터에 의존성을 설치할 필요 없이 간편하게 로컬 서버를 띄워 볼 수 있습니다.
$ docker run --rm -it -v "$PWD:/srv/jekyll" -p 4000:4000 jekyll/jekyll jekyll serve
- brew info openssl
$ brew info openssl openssl@3: stable 3.0.3 (bottled) [keg-only] ... For compilers to find openssl@3 you may need to set: export LDFLAGS="-L/opt/homebrew/opt/openssl@3/lib" export CPPFLAGS="-I/opt/homebrew/opt/openssl@3/include" # <-
- gem install eventmachine -v '' -- --with-cppflags=-I/opt/homebrew/opt/openssl@3/include
- Try
rm -rf .cache .jekyll-cache .sass-cache _site
- jekyll 의 설정은 매우 방대해서 필요한 것을 하나씩 찾아보며 할 수밖에 없습니다.
- 하지만 핵심인 컨텐츠(글!)는 디자인/레이아웃/사이트맵과는 별도로 꾸준히 추가할 수 있습니다.
_data디렉토리의authors.yml파일에 자신이 사용한 author 이름 및 정보를을 형식에 맞게 추가 합니다. GitHub username을 포함하면 포스트에 GitHub 프로필 사진이 추가되고 GitHub 프로필 페이지로 링크됩니다.
dgoon:
name: Lee Kangsan
username: dgoon
email: [email protected]
hwan:
name: Cho Hwan
username: FrancescoJo
email: [email protected]
_posts디렉토리에YYYY-mm-dd-Title-of-the-posting.md파일을 만듭니다.- 파일의 앞 부분에 Front matter 를 작성해 넣습니다. 이건 글의 메타정보를 담고 있습니다.
layout,date,title은 아래 예제를 참고해서 작성합니다.author는 위authors.yml파일에 존재하는 값이여야 합니다.tags에는 여러개의tag를 넣을수 있으며 공백으로 구분됩니다.excerpt내용은 포스트 목록에서 표시됩니다.- 포스팅 내용을 수정한 경우
last_modified_at항목을 만들고 수정한 일자를 넣습니다. (아래는 샘플입니다)
---
layout: post
date: 2018-04-03
title: 블로그를 만들어보자
author: dgoon
tags: general posting
excerpt: 블로그 만드는 포스팅으로 블로그를 시작합니다.
last_modified_at: 2018-05-01
---
- Front matter 에
published: false를 추가하면 페이지 생성에서 제외됩니다. - Front matter 뒤쪽에 Markdown 으로 글을 작성하면 됩니다. Github pages 는
kramdown만을 지원합니다. Github pages with Kramdown
GitHub Pages only supports kramdown as a Markdown processor.
GitHub-flavored Markdown is supported by kramdown by default, so you can use Markdown with GitHub Pages the same way you use Markdown on GitHub.
- 혹시 모를 일을 대비하기 위해
master직접 푸시는 막아 두었습니다. 적당한 브랜치를 만들고master를 향해 Pull request 를 만들어 주세요!
루트 디렉토리의 assets 아래에 파일을 넣고,
![ImageName]({{ "/assets/ImageFileName.png" | absolute_url }})
와 같은 식으로 임베딩할 수 있습니다. 더 상세한 것은 jekyll 레퍼런스를 찾아보시면 알 수 있습니다.
- jekyll, 혹은 html/css 등으로 할 수 있는 일이 아주 많습니다. 포스팅이 아니어도 디자인 수정, 오타 수정, 설명 갱신 등 누구라도 PR 을 만들어서 보내주시면 감사히 받겠습니다.
- 이를테면, 태그 클라우드를 만들어 붙인다던가요.