GitHub Pages로 작성한 특정 포스트가 누락되어 발행되는 이유

깃허브 페이지로 작성한 글이 디플로이 되지 못하는 경우 해결 방법

GitHub Pages에서 포스트를 작성하는 기본 규칙은 아래와 같습니다.

• _/posts 디렉토리에 포스트를 작성해야 함.
• 파일명은 YYYY-MM-DD로 시작해야 함.
• 확장자를 md 파일이어야 함.

위와 같은 규칙으로 포스트를 작성하더라도 누락되어 발생되는 경우가 있습니다. 본 페이지는 포스트가 누락되는 여러 원인들을 살펴보고 해결 방법을 설명합니다.

포스트가 누락되어 발행되는 케이스는 아래와 같습니다.

• 미래의 날짜로 포스팅을 올렸을 경우
• 오늘 날짜이지만 오전 9시 이전일 경우 (시차 문제)

미래의 날짜로 포스팅을 올렸을 경우

오늘 날짜가 2022년 11월 1일인데, 2022년 11월 2일로 파일을 작성해서 발행하면 해당 포스트는 발행에서 자동으로 누락됩니다. 이는 Jekyll에서 의도한 기능입니다.

빌드 로그를 살펴보면 아래와 같이 의도적으로 해당 포스트를 skip 했다는 것을 알 수 있습니다.

Skipping: _posts/bash/2022-11-02-md has a fure date

이 때는 날짜를 오늘 날짜로 수정하거나, 추후에 다시 빌드하면 됩니다.

오늘 날짜이지만 오전 9시 이전일 경우 (시차 문제)

오늘 날짜의 포스팅이라고 하더라도 발행이 누락될 수 있습니다. Jekyll에서 포스트의 날짜를 체크하는 기능은 KST 기준이 아니라 UDT 기준입니다. 서울 시간으로 오늘 날짜라고 하더라도, UDT 기준으로는 어제일 수 있기 때문에 UDT 날짜가 변경되는 오전 9시 이전에는 오늘 날짜의 포스트라고 하더라도 누락될 수 있습니다.

_posts 이외의 디렉토리를 빌드하려면?

_posts 이외의 디렉토리를 빌드하려면 _config.yml 파일에 해당 경로를 추가해주면 됩니다. 만약 _pages 디렉토리에 포함된 콘텐츠들도 발행에 포함하고 싶다면 설정 파일에 아래와 같이 추가해주면 됩니다.

include:
  - _pages

위와 같이 입력하면 빌드시에 _pages 디렉토리에 포함되 콘텐츠들도 발행에 포함됩니다.