Home git 블로그 시작하기 - Chirpy theme 사용
Post
Cancel

git 블로그 시작하기 - Chirpy theme 사용

git 계정을 2개 사용하기 위해 세팅한 내용들을 잘 정리해두고 싶어서 개발 블로그를 시작하려했고,

GIT 블로그의 Chirpy 테마 적용을 위해 힘들게 노력한 나의 방법들을 공유하려고 한다.

이 글을 보고 따라하는 분들은 쉽게 Chirpy 테마를 적용했으면 좋겠다😂


기본 준비 할 것

OS : Window 10

  1. git 설치-Standalone Installer
  2. 개인용 GitHub 계정 생성해두기
  3. Ruby 설치-with DevKit

Git Hub Repository 생성 및 Clone 하기

1.GitHub에 접속하여, gitHub계정명.github.io으로 Repository를 생성해준다.
2.생성한 Repository를 Clone하기

사용하는 컴퓨터에서 GIT 계정이 2개 이상인 경우

1
2
3
4
  git clone git@github.com-userA:userA/userA.github.io.git

  git config user.name 사용할 git계정명
  git config user.email git계정 이메일

그냥 일반적인 Clone

1
  git clone https://github.com/userA/userA.github.io.git

Jekyll Theme 가져오기-Chirpy

Git Blog의 테마는 대부분 http://jekyllthemes.org/ 에서 확인 후, 해당 테마의 Git에 접속하여 fork 또는 다운받는다.

나는 해당 사이트에서 Chirpy를 선택했고, 해당 적용방법을 설명하려고 한다.

1.아래 Chirpy 테마 주소에 접속한다.

Chirpy Git 주소 : https://github.com/cotes2020/jekyll-theme-chirpy/

2.접속 후, 아래와 같이 Release에 들어간다.

image

가장 최신 버전이 아닌, 아래 버전으로 다운받는다.

image

3.다운받은 파일을 압축 해제하여, Clone한 폴더에 붙여넣는다.


Chirpy 테마 세팅해주기

Chirpy테마 적용 시, — layout: home # index page — 에러가….아주 많이 발생한다.

Mac에서는 해당 테마가 편리하게 세팅 가능하며, 구글링을 통해 정답을 쉽게 찾을 수 있다.

다만, 나는 Window 환경에서 Chirpy 테마를 적용하다보니 여러 에러가 발생하였고 아래와 같이 해결하였다.

1.본인의 .github.io 레포지토리 > Settings> Actions에서 아래와 같이 설정을 해준다. image

2.아래의 파일들을 확인하여 삭제 및 세팅해준다.

Gemfile.lock 삭제
.travis 삭제
_posts 아래의 .md 파일들 삭제
.github/workflows/pages-deploy.yml.hook 파일만 남기고 다 삭제
.github/workflows/pages-deploy.yml.hook 이름변경을 통해 .hook 지우기

3..gitignore 파일이 아래와 같은지 확인

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# hidden files
.*
!.git*
!.editorconfig
!.nojekyll
!.travis.yml

# bundler cache
_site
vendor
Gemfile.lock

# rubygem
*.gem

# npm dependencies
node_modules
package-lock.json

4..github/workflows/pages-deploy.yml 에서 ruby-version 변경

본인이 다운받은 ruby 버전으로 해준다. 나는 3.2.2로 변경하였다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
name: 'Automatic build'
on:
  push:
    branches:
      - main
    paths-ignore:
      - .gitignore
      - README.md
      - LICENSE

jobs:
  continuous-delivery:

    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v2
        with:
          fetch-depth: 0  # for posts's lastmod

      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: 3.2.2
          bundler-cache: true

      - name: Deploy
        run: bash tools/deploy.sh

5._config.yml 에서 url 변경

1
2
3
4

# fill in the protocol & hostname for your site, e.g., 'https://username.github.io'
url: 'https://userA.github.io/'

6.ruby command 창 실행 후 아래 명령어 입력(관리자 권한으로 실행 권장)

1
2
3
4
5
6
cd 본인이 clone 받은 위치

bundle install

jekyll serve

7.localhost:4000을 통해 사이트가 뜨는지 확인 8.확인 후, 정상적으로 출력이 되면 아래 명령어를 통해 본인 repository에 커밋

1
2
3
4
5
6
7
8
9
#변경된 파일을 모두 스테이징.
git add -A

#메시지 작성 후 커밋
git commit -m "작성하고자 하는 메시지"

#commit 진행하기
git push

9.커밋 및 푸시 완료 후에 레포지토리의 Action탭에서 정상 build가 되는지 확인 image

10.확인 후, Settings에 들어가서 아래와 같이 gh-pages 브랜치가 생겼는지 확인 후 변경할 것.

— layout: home # index page — 에러가 발생해도 아래 사항을 확인 할 것. image


단순하게 git 블로그에 글을 남기고 싶었는데, 글 쓰는 것보다 테마적용이 더 오래걸렸다..😎

나의 글을 통해서 조금은 수월하게 Window에서도 적용했으면 좋겠다:)


참고 사이트

Jekyll Chirpy 테마 사용하여 블로그 만들기

Github 블로그 테마적용하기(Chirpy)

Github Blog 만들기-2

This post is licensed under CC BY 4.0 by the author.

한 대의 컴퓨터에서 Git 계정 두 개 사용하기

git 블로그 시작하기 - 구글/네이버 검색엔진 등록하기

Trending Tags