Jekyll을 사용하여 GitHub Pages 만들기 (updated: 2024.05.19)

------------

0. Concept

Jekyll은 GitHub Pages 및 간소화된 빌드 프로세스를 기본적으로 지원하는 정적 사이트 생성기이다.

Jekyll은 Markdown 및 HTML 파일을 가져와 선택한 레이아웃에 따라 완전한 정적 웹 사이트를 만듭니다. Jekyll은 사이트에 동적 콘텐츠를 로드하는 템플릿 언어인 Markdown 및 Liquid를 지원한다.

 

Git 설치

다운로드(https://www.git-scm.com/downloads) 후 설치

// git 설치여부 확인
> git --version 
git version 2.40.1.window

// 로컬에 Git repository 생성
> git init [repositoryname]

 

1. Installing Ruby and Jekyll

https://jekyllrb.com/docs/installation/ > Windows (OS별 가이드 선택)

 

STEP 1. 전체조건  (Jekyll requires the following)

1. Ruby version 2.5.0 or higher
2. RubyGems
3. GCC and Make

// 1. Ruby Installer 설치
   1-1) https://rubyinstaller.org/downloads/
     Ruby+Devkit 3.2.4-1 

// 1-2) Ruby 설치중 옵션에서 3 선택해서 설치할 것!
   ---------------------------------------------------------------------
   1 - MSYS2 base installation
   2 - MSYS2 system update (optional)
   3 - MSYS2 and MINGW development toolchain

	Which components shall be installed? If unsure press ENTER [1,3] 3

	...블라블라....

// 1-3) 설치후 확인 (Ruby & Gem)
    > ruby -v
    ruby 3.2.4 (2024-04-23 revision af471c0e01) [x64-mingw-ucrt]

    > gem -v
    3.4.19

    > ridk version
    ---
    ruby:
      path: C:/Ruby32-x64
      version: 3.2.4
      platform: x64-mingw-ucrt
    ruby_installer:
      package_version: 3.2.4-1
      git_commit: 88d8c1f
    msys2:
      path: C:\Ruby32-x64\msys64
    cc: gcc (Rev6, Built by MSYS2 project) 13.2.0
    sh: GNU bash, 버전 5.2.26(1)-release (x86_64-pc-msys)
    os: Microsoft Windows [Version 10.0.19045.4412]
    
// 2. Jekyll 설치
    > gem install jekyll
    ...블라블라..설치후...

    > jekyll -v
    jekyll 4.3.3

 

STEP 2. 테스트용 Jekll 블로그 생성하고 로컬로 띄우기

// 1. Jekyll을 이용해 사이트 생성
	> jekyll new [myblog]
    
// 2. bundler 로 로컬호스팅
	> cd [myblog]
	> bundle exec jekyll serve
	Server address: http://127.0.0.1:4000/ ◀
  	Server running... press ctrl-c to stop.

 

2. Jekyll 테마 적용하기

참고: https://krauser085.github.io/start-jakyllandgithubpage-2/

// 1. github에 사이트용 repository 생성
// repotory 명은 반드시 [xxx.github.io] 형식이어야 함.

// 2. git clone
	> git clone http://github.com/xxxx/xxx.github.io.git
    
// 3. Jekyll Theme 다운로드해서 git 디렉토리에 압축풀기

// 4. Gemfile에 정의된 라이브러리 설치
	> bundle
    ..블라블라..

// 5. localhost로 띄우기
    > bundle exec jekyll serve  
    ..블라블라..
	Server address: http://127.0.0.1:4000
	Server running... press ctrl-c to stop.
    
// 6. git commit
    git add .
    git commit -m "initial commit"
    git push origin master

 

 

 

 

 

---- to be continue.. ---