github Pages “jekyll serve Error YAML Exception reading” 등등 에러 해결하기

1 minute read

jekyll serve 가 잘 동작하는 것 같다가도, 시뻘건 에러메시지를 왕창 쏟아낼 때가 있다. (ㅠㅠ) 나의 경우 대부분 jekyll serve Error: YAML Exception reading 로 시작하는 에러 메시지들이었는데, jekyll이 포스트를 읽어오기 위해 가장 중요한 YAML에서 오류가 있을 경우에 여러 에러 메시지가 나온다.

1) did not find expected key while parsing a block mapping at ~

제목을 작성하다보면 들어가는 특수문자들이 있을 때 이 에러 메시지가 자주 나왔다. 예를 들어 아래와 같이 제목을 작성한다면 에러가 난다. [ ] {} 괄호와 : 쌍점 때문에….

만약 해당 에러메시지가 나온다면, YAML에서 쓰지 말아야 하는 특수문자를 사용한 것일 수도 있으니 이리저리 바꿔보면 문제가 해결될 것이다.

title: [github_pages] "Error : YAML Exception reading"  #에러!

title: github_pages "Error YAML Exception readinf"  # 문제가 있는 특수문자들을 빼주면 된다

2) could not find expected ‘:’ while scanning a simple key at ~

이 에러는 : 쌍점 뒤에 띄어쓰기를 안했을 때 등장한 에러였다.

date:2019-04-15  # 에러!

date: 2019-04-15  # : 뒤를 한 칸 비우면 된다.

3) found character that cannot start any token while scanning for the next token at ~

해결하고도 조금 어이가 없었던 에러…!!!!! 이 에러는 tags나 categories를 작성할 때, tab을 사용했을 때 나온 에러였다. jekyll은 tab을 인식하지 못하는 모양… space를 이용해줘야 한다.

물론 본문을 작성할 때는 상관없었고, YAML파일의 경우에 문제가 있었다!!

tags:
     - tutorial			# tab을 사용하면 에러가 난다
categories:
	- Github_Pages
	
	
tags:
 - tutorial				# space 사용하기~
categories:
 - Github_Pages

4) 사이트 깨져 보임

page_broken

baseurl을 잘못 설정했을 때 다음과 같은 화면 깨짐이 나타났다. 특별하게 사용할 일이 없을 경우에는 그냥 “” 로 비워두는 게 좋을 것 같다. 이와 관련해서 자세하게 보고싶다면… (참고)

baseurl : "/"   # 이렇게 했다가 에러가 났었음

baseurl : ""

5) 기타 등등

그 외에 jekyll serve 에는 나오지 않는 데 git push를 하고 나니 나오는 것들도 있었다. 처음에는 에러인 줄 알아서 이리저리 검색을 하고 답이 나오지 않아 멘붕 했던 기억이 있다. 이유를 알 수 없고 검색해도 잘 모르겠다면 그냥 push한 다음에 적용된 github pages를 살펴보면 해결 될 수도 있다!

나의 경우에는

  • favicon을 설정할 때

  • date: 9999-12-31 로 설정했을 때

jekyll serve에서는 나오지 않았지만 실제 페이지에 적용했을 때는 잘 나오던 것을 확인 할 수 있었다.

date의 경우, serve할 때 –future 을 붙이면 된다는 글을 본 적이 있다!

Comments