Github.io 블로그 버그 수정기

사건번호 01. 포스트 링크 오류 발생 사건

사건의 발단.

• 마크다운 문법 글의 업로드를 하기 위해 커밋을 완료.
• 빌드 적용되는 시간에 답답함을 느껴 어제 쓴 글에 적혀있는 Repository 이름 변경 꼼수를 사용.
• 잘 올라갔는지 확인하기 위해 블로그를 순찰하던 도중 벌어진 일련의 버그들에 대한 Trouble shooting을 기록함.

버그 내용.

• 어제 쓴 글의 링크가 오늘 쓴 글의 링크로 바뀌어있는 버그 발생.
  • 원인 파악을 위해 블로그 글에 걸린 링크를 크롬 개발자 도구를 사용하여 확인해봤다.

    1geraldine1.github.io/2021-08%20til/TIL
    

• 두 글의 링크 모두 위의 링크로 동일함을 확인할수 있었다.

문제 분석 및 해결.

• 우선, 내가 쓰고 있는 블로그 테마의 url구성은 다음과 같이 이루어져 있었다.

  유저이름.github.io/카테고리이름/파일이름
  

• 여기가 문제가 발생한 부분이었다.
  나는 파일명을 작성할 당시
  “2021-08-23-TIL”,”2021-08-24-TIL”
  과 같이 작성을 하고 있었는데, 블로그 시스템이 날짜부분은 split해서 날려버리고 TIL이라는 파일 이름만 인식하여 링크로 쓰고 있었던 것.
• 게다가 글에 작성된 카테고리 역시 “2021-08 TIL”로 동일했고, 두 게시물은 결국 “TIL”이라는 파일 하나만을 가리키게 되어 버그가 발생한 것.
• 결국 포스트 이름을 전부 제목과 동일하게 바꿔주는 것으로 해당 사건은 마무리되었다.

사건번호 02. 블로그 테마 증발 사건

사건의 발단.

• 위에 서술된 사건을 해결하기 위해 커밋을 하며 디버깅을 진행하던 도중, 어제 쓴 글에서도 언급한 빌드 제한시간때문에 답답함을 느낌.
• 수정사항을 커밋할때마다 어제 찾아두었던 해결법인 repository 이름 변경을 사용.
• 수정사항이 5분에 4,5개쯤 발생하며 repository 이름이 자주 변경되다보니 문제 발생.

버그 내용.

• 마치 css파일이 없어진것처럼 블로그 레이아웃이 깨지는 현상 발생.
• 또한, 포스팅된 글들의 링크가 전부

  1geraldine1.github.io/1geraldine1.github.io2/카테고리이름/파일이름
  

  으로 변경됨.

• 당연히 저 위치에는 어떤 파일도 없기에, 들어간 글에서는 404에러 발생.

문제 분석 및 해결

• 링크의 중간에 있던 1geraldine1.github.io2는 내가 repository 이름 변경시 사용했던 이름이었다.

• 따라서, Jekyll의 remote theme 기능이 자주 변경된 repository 이름을 인식하지 못하고, 바꾸기 전의 이름이 그대로 남아버린것.

• github.io의 설정파일인 _config.yml 파일에서 remote theme부분을 지워고 커밋한 후, 다시 복구하여 커밋을 실행하자 블로그 테마가 정상적으로 나오는것을 확인할 수 있었다.

결론.

1. Github.io의 포스트 업로드시, 파일 이름도 성의있게 지어야 한다.
2. remote_theme 기능을 쓰고 있다면, Repository 이름은 적당히 바꾸자.