GitHub 블로그 FAQ - 일반적인 질문과 해결책

1. Google 검색 활성화하기

1.1 사이트맵 활성화

_config.yml 수정:

plugins: ['jekyll-paginate', 'jekyll-sitemap', 'jekyll-include-cache', 'jekyll-gist']

1.2 robots.txt 추가

루트 디렉토리에 robots.txt 파일 생성:

User-agent: *
Allow:/

Sitemap: https://jayleekr.github.io/sitemap.xml

1.3 Google Search Console에 사이트맵 등록

1. https://www.google.com/webmasters 로 이동
2. SEARCH CONSOLE 클릭
3. 사이트 추가 및 소유권 확인
4. 사이트맵 URL 제출

2. Jekyll 관련 문제

2.1 로컬 블로그 테스트를 위한 의존성 설치

Jekyll 블로그를 로컬에서 테스트하려면 다음 의존성이 필요합니다:

$ sudo apt-get install -y gem 
$ sudo gem install jekyll bundler tzinfo tzinfo-data minima 

2.2 테마 설치하기

minimal-mistakes 테마를 예시로 설치해봅시다:

1. 먼저 Gemfile에 minimal-mistakes 테마 추가:

gem "minimal-mistakes-jekyll"

2. 번들 설치:

$ bundle install 

3. _config.yml 파일에 테마 추가:

theme: minimal-mistakes-jekyll

2.3 Jekyll 실행하기

$ jekyll serve
Configuration file: /home/jayleekr/workspace/00_codes/07_blog/_config.yml
            Source: /home/jayleekr/workspace/00_codes/07_blog
       Destination: /home/jayleekr/workspace/00_codes/07_blog/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.823 seconds.
 Auto-regeneration: enabled for '/home/jayleekr/workspace/00_codes/07_blog'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.

이제 블로그를 http://127.0.0.1:4000에서 확인할 수 있습니다!

2.4 Jekyll 버전 호환성 문제

프로젝트 버전과 설치된 Jekyll 버전이 일치하지 않을 때 발생합니다.

gem 의존성을 올바르게 관리하여 해결할 수 있습니다:

$ sudo gem install bundler
$ bundle install
$ bundle exec jekyll serve
Configuration file: /home/jayleekr/workspace/00_codes/07_blog/_config.yml
            Source: /home/jayleekr/workspace/00_codes/07_blog
       Destination: /home/jayleekr/workspace/00_codes/07_blog/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.823 seconds.
 Auto-regeneration: enabled for '/home/jayleekr/workspace/00_codes/07_blog'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.

bundle exec를 사용하면 Gemfile.lock에 지정된 정확한 gem 버전으로 Jekyll을 실행하여 호환성 문제를 피할 수 있습니다.

프로 팁

• 버전 충돌을 피하기 위해 jekyll serve 대신 항상 bundle exec jekyll serve 사용
• bundle update로 gem을 최신 상태로 유지
• GitHub Pages에 푸시하기 전에 로컬에서 블로그 테스트
• 빌드 실패를 피하기 위해 GitHub Pages 지원 플러그인 사용

GitHub 블로그 설정에 도움이 되길 바랍니다! 🚀