Git 블로그 만들기

필자가 Git에서 Build를 계속 실패해서 찾아낸 방법으로 정석은 아니다.
(오직 블로그 개설이 목표!)

준비

일단 명령 프롬프트에 해당 커맨드들을 입력하여 설치 여부를 확인한다.

ruby -v
node -v
git -v
jekyll -v
bundler -v

버전이 나오지 않으면 설치를 하고 오도록하자!

방법

1. 해당 링크에 들어가서 fork 클릭 후 Repository name을 username.github.io 로 생성한다.

2. Repository생성 후 Settings->Pages->Deplot from a branch-> GitHub Actions

3. 다음 사진과 같이 생겼을 것 Configure->Commit changes-> Sign off and commit changes

4. 다음 사진처럼 나올 경우 Code를 눌러 이동한다.

자신의 원하는 로컬 위치에 git clone을 한다.
필자는 GitHub Desktop을 이용했다.

5. clone한 로컬 Repository에서 사진과 같이 cmd를 입력한다.
(관리자 권한 실행으로 직접 디렉토리로 옮기는게 좋다)

명령 프롬프트 창에서 순차적으로 완료가 되면 입력한다.

bundle

npm install

npm run build

jekyll serve

마지막 jekyll serve 입력 후 해당 로컬 주소로 들어가면 블로그가 나온다.

6. 이제 Git 배포를 하기위해 레포지토리에 있는 .gitignore 를 다음 사진과 같이 #을 붙여준다.

_config.yml 파일을 열어서 url 부분을 자신의 닉네임에 맞게 주소를 설정한다.
(title, tagline 도 자신에 맞게 설정해보자)

_posts 폴더에서 해당 사진과 같이 저 파일을 복사 후 이름을 바꿔주자

바꾼 테스트 파일에서 다음 사진과 같이 수정한다.

7. push 하기위해 테스트를 Commit 해보자 다음과 같은 에러가 뜬다.

Commit 규약이 있기 때문에 에러가 뜨는 것 Commit 제목을
다음과 같이 docs: test로 바꿔보자 그럼 커밋이 되고 push가 가능해진다.
(Commit 규약 해제는 제일 아래에 있습니다)

push 후 자신의 Git Repository에서 Actions로 가면 빌드 중이다.

빌드가 성공 후 Deploy로 시작되는 workflow를 클릭 후 링크에 들어가 확인해보자.

블로그 만들기 성공!

테스트용 포스팅이 보이고 수정한 title, tagline 이 반영되어있다.

이 화면이 나온다면 Update를 누르면 잘 반영된다.

Commit 규약 해제 방법

블로그 만들기를 마치기 전에 아까 Commit 규약 해제 방법으로 레포지토리/.husky/commit-msg 파일에 #을 추가하자

블로그에 잘 반영되는지 테스트용 포스팅에 추가해보자.

커밋이 잘 될 것이고 push를 하고 Actions을 보면 사진과 같이 하나가 실패한다 정상이다 링크로 가보자

사진과 같이 변경내용이 반영이 되어있지 않아도 테스트용을 들어가서 확인하면 잘 되어 있다
(업데이트 주기가 있는거 같은데 잘 모르겠다)

최근 업데이트되어 빌드오류 해결?

/.github/workflows/jekyll.yml 파일을 열어서 다음 두개를 바꿔준다

uses: ruby/setup-ruby@8575951200e472d5f2d95c625da0c7bec8217c42 # v1.161.0
        -> uses: ruby/setup-ruby@v1

           ruby-version: '3.1' # Not needed with a .ruby-version file
        ->  ruby-version: '3.1.4' # Not needed with a .ruby-version file

글을 마무리하면서

이 글은 필자와 같이 오직 블로그 개설이 목표인 분들을 위해 쓴 글입니다.
방법이 부족하고 보완이 필요한 부분이 많을 수도 있습니다.
이 부분은 양해 부탁드리며, 피드백은 언제나 환영입니다!
처음 글을 올리다 보니 두서 없고 정리가 잘되지 않으며, 어색하고 이상한 부분도 있을 수 있습니다.

끝까지 읽어주셔서 감사합니다.