macOS에서 Jekyll 설치와 Minimalmistake Theme

이 글은 github pages 를 통해서 블로그를 할 수 있도록 다음 작업을 한다:

• 로컬에 ruby를 기반으로한 jekyll 을 설치한다.
• github pages 와 연동한다.
• markdown 으로 작성한 문서를 github pages 에 올린다.

jekyll

jekyllrb.com 의 가이드에 따라 github page에서 블로그로 사용하고자 한다.

설치

Ruby 개발 도구가 반드시 필요 - 여기서 macOS 에서 블로그 작업을 한다고 가정한다.

• macOS는 Ruby 최신 버전이 제공되고 있다.
• 여기선 Homebrew 로 루비를 설치하고 사용한다.

Ruby 환경

Ruby 개발 도구가 반드시 필요한데 다음 같이 rbenv 이라는 가상 개발 환경으로 설치하는게 깔끔하다. Ruby 가상개발환경을 설치한다.

Install Homebrew

Homebrew 를 설치한다.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Homebrew 를 통해 ruby 최신 버전을 설치한다.

• 2020년 3월 현재 2.7.0 을 설치하겠다.

그리고 환경변수 PATH 에 추가해 준다.

echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile

ruby 버전을 확인한다.

$ ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-darwin19]

---

jekyll 설치

Jekyll 을 설치시 시스템의 ruby gem 의 로컬 혹은 글로벌 설치를 선택해야 한다. 가능하면 로컬 설치를 권장하므로 여기서 로컬 설치만 다룬다.

• 글로벌 설치는 여기 Global Install을 참조한다.

로컬 설치

bundler gem은 다른 Ruby gem을 관리하는 gem으로 gem과 gem 버전, 의존성을 지키게 해준다.

gem 으로 설치한다.

$ gem install --user-install bundler jekyll
Fetching bundler-2.1.4.gem
WARNING:  You don't have /Users/qkboo/.gem/ruby/2.7.0/bin in your PATH,
	  gem executables will not run.
Successfully installed bundler-2.1.4
...

현재 루비 버전을 확인후 버전의 앞 두자리 숫자를 아래 경로에 XX 에 추가한다.

$ ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-darwin19]

루비 버전 앞 두 자리를 아래 경로 X.X 에 입력해 실행한다.

$ echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.bash_profile

쉘을 다시 시작한 후 홈 디렉토리에서 gem 경로를 확인한다.

$ gem env

설치한 jekyll 버전을 확인한다.

$ jekyll -v
jekyll 4.0.0

which jekyll

/Users/qkboo/.gem/ruby/2.7.0/bin/jekyll

jekyll 사용

jekyll 명령으로 블로그 사이트를 생성, 갱신, 삭제 등이 가능하다.

• https://jekyllrb.com/docs/#instructions

새 사이트를 구성한다.

$ jekyll new my-site
Running bundle install in /home/qkboo/

이렇게 생성된 사이트는 아래 같은 구조를 갖는다:

my-site/
      ├── Gemfile
      ├── Gemfile.lock
      ├── _config.yml
      ├── _posts
      │   └── 2016-12-04-welcome-to-jekyll.markdown
      ├── about.md
      └── index.md

여기에 bundle로 Gem을 설치한다.

$ cd my-site
$ bundle install

그리고 다음 같이 서버를 실행하면 블로그를 구성할 수 있는 config.yml 파일을 생성한다.

$ bundle exec jekyll serve

Server address: http://127.0.0.1:8080/
  Server running... press ctrl-c to stop.

Ctrl+C

Ctrl+C 종료 시키고 my-site/_config.yml 파일에 다음 같이 외부에서 접속 가능하게 해준다.

# deployment
host: 0.0.0.0
port: 5000

이렇게 해주어야 외부에서 브라우저로 접근할 수 있다.

$ bundle exec jekyll serve

macOS에서 jekyll로 실행한 서버가 4000 포트에서 대기중인지 확인

$ sudo lsof -i :4000

bundle 명령

bundle 명령을 사용해 jekyll 을 실행할 수 있다. 또한 URL Root 위치를 –baseurl 로 변경

$ bundle exec jekyll serve -w --baseurl '/'

Port 변경

$ bundle exec jekyll serve -w --baseurl '/' --port 4000

디버그 메시지 출력 –trace:

$ bundle exec jekyll serve -w --trace

gem list jekyll

RubyGem으로 jekyll 관리

RubyGem 을 사용하기 위해 gem 명령으로 사용한다:

$ jekyll --version

설치한 지킬 또는 gem 패키지 목록은 다음의 명령으로 확인할 수 있다.

$ gem list
or
$ gem list jekyll            # jekyll 목록

RubyGems 으로 gem 버전을 찾을 수 있다.

$ gem search jekyll --remote

지킬 특정 버전을 사용하고 싶다면 아래와 같은 옵션을 주면 된다. (예, 1.5.1)

$ gem install jekyll -v 1.5.1

지킬 삭제는 아래와 같다.

$ sudo gem uninstall jekyll

특정 버전 삭제는 아래와 같다. (예, 1.5.1)

$ gem uninstall jekyll -v 1.5.1

다양한 지킬 버전이 설치되어 있을 때 최신 버전 제외 모두 삭제는 아래와 같다.

$ sudo gem cleanup jekyll

지킬 버전 업데이트는 아래와 같다. gem update를 사용하는 것이 좋다.

$ sudo gem update
or
$ sudo gem update jekyll

위의 내용들은 아래의 명령을 통해 도움을 얻을 수 있다.

$ gem help

gem-based themes에서는 assets, _layouts, _includes, _sass 디렉토리가 테마의 gem에 있다.

MathJax

LaTex 같은 수학 수식을 지원하려면 _include/head.html 같은 위치에 MathJax 를 포함한다.

<script
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
  type="text/javascript"
></script>

---

git-pages 연동하기

참조

• Jekyll Installation:macOS
• Jekyll Quickstart