git-pages: Jekyll 테마 Minimal-mistake Remote Theme 사용(1)

Github pages 에서 지원하는 Jekyll 블로그 엔진에서 사용할 수 있는 여러 테마들이 있는데 Minimal-mistake를 사용해 블로그를 만들려고 한다. Jekyll 블로그 엔진은 아래에서 사용할 수 있다고 한다.

• Netlify
• GitLab Pages
• Continuous Integration (CI) services

 

Minimal-Mistake Theme

https://mmistakes.github.io/minimal-mistakes/about/

About

 

Ruby Gem 을 기반으로 개발된 테마로  Jeykyll 자체로 사용하거나 Github pages 같은 원격 테마로 사용이 가능하다. 여기서는 원격 테마로 구성하는 것을 살펴보겠다.

 

Github의 git-pages Remote Theme 구성

Github 에서 Jekyll 기반의 웹 사이트를 만드려면 USERNAME.github.io 저장소를 생성하고 gh-pages 라는 브랜치를 생성하면 된다 - 자세한 내용은  GitHub’s documentation 참고

About GitHub Pages - GitHub Docs

 

Minimal-mistake 테마로 해당 gh-pages 장소를 만드는 제일 손쉬운 방법은 https://github.com/mmistakes 저장소를 포크하는 방법이 있다. 다음 링크를 클릭해 포크한다.

 

https://github.com/mmistakes/minimal-mistakes/fork

 

Fork 로 저장소를 생성하고 저장소 이름을 USERNAME.github.io 으로 변경하면 완성이 된다.

Fork한후 USERNAME.github.io 로 접속해 보면 Jeykyll 엔진에 의해서 웹 사이트로 보여진다. 왼쪽은 포크한 저장소이고 오른쪽은 USERNAME.github.io 페이지로 랜더링한 결과이다.

 

Remote theme 구성 작업

 

 minimal-mistakes-jekyll 저장소를 포크하거나 다운로드 해서 사용하고 있다면 아래 폴더와 파일을 삭제하도록 한다.

 

• .editorconfig
• .gitattributes
• .github
• /docs
• /test
• CHANGELOG.md
• minimal-mistakes-jekyll.gemspec
• README.md
• screenshot-layouts.png
• screenshot.png

 

여러 방법이 있겠지만 보통

1. USERNAME.github.io 을 로컬로 clone을 하고
2. clone한 master 브랜치를 새 로컬 브랜치 등으로 포크해서 작업한 후에
3. USERNAME.github.io 의 master 에 publish 를 한다

---

여기까지는 Github 에