Githubio _ post디렉토리에 업로드 하지 않은 것들이 자꾸 올라오는 문제

1. 문제 발생: 원하지 않는 페이지들이 보임

• docs/posts/, test/posts/ 폴더의 Markdown 파일까지 사이트에 노출됨.
• post 디렉토리만 게시되길 원했지만, 다른 폴더까지 함께 빌드된 것으로 추정.
• 불필요한 마크다운 파일들 삭제 후에도 여전히 문제가 해결되지 않음.

---

2. GPT의 조언 & 디버깅

• jekyll serve --trace 명령어로 디버깅 시도.
• 출력 로그에서 다음 오류 발견:

 

Liquid Exception: Could not find post "2012-03-15-layout-header-image-text-readability" in tag 'post_url'

• 원인:
  docs/_pages/about.md 파일에서 존재하지 않는 포스트를 참조 중

---

3. 깃허브에서 수정 시도 → 권한 오류

• 깃허브 웹에서 직접 수정하려고 했지만, 로그인하지 않아 권한 부족 메시지 발생
• (사실은 로그인을 안 한 거였음 😂)

---

4. 문제 해결 방법

• 로컬에서 about.md 파일을 삭제하고 커밋 & 푸시
• 정상적으로 GitHub Pages에서 빌드 완료됨 ✅
• 예전처럼 2012~2010년 글들이 나타나는 오류도 해결됨

---

5. 로컬에서 수정사항 되돌리기 (GitHub Desktop 활용)

• 사이드바 커스터마이징 도중 여러 파일을 수정하다 오류 발생
• 수정사항이 너무 많고 복잡해져 복구하기 어려웠음
• GitHub Desktop에서 다음 방식으로 깔끔하게 복구:
  • GitHub Desktop 실행
  • Changes 탭에서 수정된 파일 우클릭
  • Discard Changes 클릭 → 로컬 변경사항 삭제됨
• 로컬 변경사항 원복하기
• 덕분에 2시간의 삽질을 리셋하고 다시 시작할 수 있었음 🎉

---

📝 느낀 점

• GitHub Pages는 존재하지 않는 post_url 링크가 있을 경우 전체 빌드 실패함
• _config.yml에 올바른 폴더 구조와 파일만 포함되도록 신경 쓸 것
• GitHub Desktop의 Discard Changes 기능은 위기 탈출용으로 매우 유용!