Github 블로그 제작기 - 02

저번 글에 이어서, 내가 블로그를 만들면서 마주친 문제들을 짚어보고자 한다.

대부분의 문제는 아래 과정에서부터 발생한다.

‘jekyll new 블로그이름’ + ‘jekyll serve’ 입력

해당 명령어를 입력하면 아래와 같은 화면을 볼 수 있다. 이후에 부족한 gem이 있다면 bundle에 추가하여 재실행 하면 된다.

1

이와같은 설치과정 이후에 프로젝트 폴더가 생성된다.

이후 jekyll serve를 입력했을 때, 문제가 생긴다면 노란색, 빨간색의 경고 문구와 마주할 수 있다.

Untitled

Untitled

이런 상황에서 로컬호스트에 접속해보아도 사이트에 연결할 수 없다는 말만 돌아올 뿐이다.

Untitled

역시나 응답은 없다. 현 시점에서 폴더 상황은 아래와 같다.

블로그 프로젝트를 만든 폴더

Untitled

블로그 프로젝트 폴더의 내부

Untitled

Configuration file : none

가장 위쪽에 나온 경고인 만큼, 해당 부분이 원인이라고 생각했다. 말 그대로 configuration file이 없다는 이야기이다. 블로그 프로젝트 폴더 이미지를 보면, 이미 _config.yml 파일이 존재하지만 인식하지 못하는 상황이다.

우선 기본 파일들이 문제일 수 있으니, 외부에서 가져온 jekyll theme 파일로 변경해보았다.

Untitled

폴더가 좀 더 풍성해졌다. 이 상태로 다시 jekyll serve를 입력해보았다.

Untitled

경고 또한 풍성해진 모습이다.

집어 넣었던 jekyll theme을 모두 삭제하고, 새로운 블로그 프로젝트를 생성했다.

해결법을 검색하다보니 아래의 블로그(Jekyll 설치 및 로컬에 띄우기)에서 완료 메세지를 올려둔 글을 찾았다.

Configuration file: none
Configuration file: none
            Source: C:/jekyll_site
       Destination: C:/jekyll_site/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.025 seconds.
  Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
 Auto-regeneration: enabled for 'C:/jekyll_site'
Configuration file: none
    Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

configuration file : none이어도 실행이 된다! 다른 부분에 문제가 있음을 확인했다.

cannot load such file –webrick(LoadError)

Untitled

해당 부분에 포커스를 맞춰보았다. webrick파일을 로드하지 못했다고 하는데, 이게 뭘까? webrick을 검색해보니 간단한 HTTP 웹 서버를 제공하는 Ruby 라이브러리라고 한다. ruby 3.0.0부터 webrick이 기본 포함 gem에서 빠졌기 때문에 별도의 설치가 필요하다.

bundle add webrick
bundle install

위의 명령어를 통해 번들에 webrick을 추가하고, 설치할 수있다.

다시 서버를 실행해보았다.

Untitled

여전히 Build warning은 발생하지만 Server running이 표시된다!

Untitled

로컬호스트에 들어가보니 실제로 서버가 작동하는 것을 확인할 수 있다.

Build warning: Layout ‘~’ requested

서버는 작동하지만, 올바르게 작동한다고는 할 수 없다. 저 build warning을 해결해보자.

Untitled

참고로 첫 줄의 Incremental build는 마지막으로 빌드한 시점 이후에 갱신된 문서와 페이지만 재생성하여 빌드시간을 줄여주는 것이다. 자세한 내용은 하단의 공식 문서 링크를 참고.

기본 환경설정 - Jekyll 공식문서

Untitled

위과같은 Build warning은 해당 markdown 파일의 layout으로 설정한 내용들이 _layouts 폴더에 존재하지 않기 때문에 발생한다.

Untitled

예를들어 index.markdown파일을 열고 layout을 home → defaults로 바꿔보면

Untitled

경고 문구가 바뀌는 것을 확인할 수 있다.

해결 방법은 _layouts 폴더에 해당 레이아웃을 추가해주면 된다. 레이아웃 추가 과정은 아래 문서 참고.

레이아웃 - Jekyll 공식문서