안녕하세요! 오늘은 제가 GitHub 블로그를 만들면서 겪었던 여러 시행착오와 해결 과정을 상세히 공유하려고 합니다. 특히 처음 도전하시는 분들이 겪을 수 있는 문제들과 그 해결방법에 대해 자세히 설명해드리겠습니다.
첫 발걸음과 마주친 벽들
기본 환경 설정
처음에는 모든 것이 순조로워 보였습니다. GitHub Pages를 사용하기 위해 '(원하는 무언가).github.io'라는 이름으로 저장소를 만들었고, 마음에 드는 Jekyll 테마도 찾았죠. 하지만 이때부터 예상치 못한 문제들이 하나둘씩 나타나기 시작했습니다.
첫 번째 난관: Bundle 설치 실패
이 오류를 만났을 때 당황스러웠습니다. 'bundle'이라는 명령어를 찾을 수 없다는 메시지... 분명 모든 것을 가이드대로 했는데 왜 이런 문제가 발생한 걸까요?
Ruby 설치와 새로운 문제들
Ruby를 설치하면 해결될 거라 생각했지만, 여전히 gem 명령어가 작동하지 않았습니다. 심지어 저는 Python의 pip로 설치를 시도하기도 했죠. 나중에 알고 보니 Jekyll은 Ruby 기반이라 pip로는 설치가 불가능했습니다. 이때부터 본격적으로 노가다했습니다.
문제 해결을 위한 고군분투
환경 설정의 복잡성
이 단계에서 마주친 가장 큰 문제는 환경 설정이었습니다. 특히 Windows 환경에서 Ruby와 Jekyll을 설정하는 과정이 생각보다 까다로웠죠.
wdm gem 설치 실패
이 오류는 Windows 환경에서 특히 자주 발생하는 문제였습니다. Ruby 버전과 gem의 호환성 문제였던 것이죠.
Jekyll 명령어 실행 실패
이 오류를 해결하기 위해 많은 시도를 했습니다:
- Ruby를 완전히 제거하고 재설치
- 환경 변수 설정 확인
- 다양한 버전의 Ruby 시도
해결을 위한 시도들
- Ruby 3.2.2 버전으로 다운그레이드
- gem과 bundler의 완전한 재설치
- Jekyll 수동 설치 시도
마침내 찾아온 성공
설정 파일 수정의 중요성
config.yml 파일의 수정이 핵심이었습니다. 특히 두 가지 설정이 매우 중요했죠:
- url 설정:
- destination 설정:
정확한 실행 명령어
마침내 찾아낸 정확한 Jekyll 실행 명령어:
이 명령어를 실행하자 드디어 서버가 정상적으로 작동하기 시작했습니다!
성공의 순간
서버가 http://127.0.0.1:4000/에서 실행되고, 자동 재생성 기능이 활성화되면서 드디어 로컬에서 블로그를 확인할 수 있게 되었습니다. 아 ㅅㅅ!
주요 교훈과 팁
1. 버전 관리의 중요성
- Ruby 버전이 생각보다 매우 중요합니다
- 특히 Windows 환경에서는 3.2.2 버전이 안정적으로 작동했습니다
2. 환경 설정의 세심한 주의
- 경로 설정이 정확해야 합니다
- 환경 변수가 올바르게 설정되어 있어야 합니다
- _config.yml 파일의 설정이 매우 중요합니다
3. 문제 해결 접근 방법
- 오류 메시지를 꼼꼼히 읽고 이해하기
- 한 번에 하나씩 문제 해결하기
- 변경사항을 기록하면서 진행하기
마무리하며
GitHub 블로그를 만드는 과정은 생각보다 복잡했지만, 이 과정에서 많은 것을 배울 수 있었습니다. 특히 문제 해결 능력과 인내심이 많이 성장했죠. 이 글을 읽는 분들은 제가 겪었던 시행착오를 피하고, 좀 더 순조롭게 블로그를 만들 수 있기를 바랍니다.
'오픈소스를 위한 기초 상식' 카테고리의 다른 글
| 초보자를 위한 옵시디언 설정부터 플러그인 활용까지 (0) | 2025.01.07 |
|---|---|
| 개발자의 필수 도구 Git: 기초 명령어부터 (0) | 2025.01.03 |
