🔥 시작하기
🐛 1. 새로운 repository 만들기
github에서 새로운 repository를 만드는데 이름을
1
[username].github.io
로 만들어준다. 여기서 username은
빨간 네모에 보여지는 이름
🐛 2. 로컬에 클론하기
만든 repository를 로컬에 클론 해준다.
폴더 생성을 원하는 위치에 가서
1
git clone [주소 붙여넣기]
🔥 jekyll
🐛 1. 로컬에 jekyll 설치하기
아까 클론했던 폴더로 들어가서 jekyll와 bundler 설치 해준다
1
gem install jekyll bundler
🐛 2. jekyll 생성
주의) 아래의 명령어 사용하기 전에 폴더가 비어있어야 함
1
jekyll new ./
나의 경우 위의 명령어 입력 후 jekyll 명렁어를 찾을 수 없다는 오류가 발생했는데
https://jekyllrb.com/docs/installation/macos/
위의 링크에서 해결함
링크에서 시키는대로 쭉~ 하다가
빨간줄 부분
1
ruby -v
하면 현재 자신에게 설치되어 있는 ruby의 버전이 나오는데 사진처럼 3.1.2 로 하면 안되고 자기 버전에 맞게 적어야 한다.
🐛 3. bundle
2번이 정상적으로 해결됬다면
아래의 명령어 실행으로 생성된 파일들을 설치 해주고
1
bundle install
로컬 서버 실행
1
bundle bundle exec jekyll serve
실행 하면 아래의 사진처럼 서버 주소가 나오는데 클릭 해보면 정상적으로 성공 했음을 알 수 있다.
🐛 원격에 push 하기
1
2
3
4
5
git add .
git commit -m 'first commit'
git push origin main
push 하면 github.io 로 되어있는 repository는 자동으로 빌드,배포 되서 https://[username].github.io 로 페이지가 만들어진다.
🔥 테마
🐛 테마 선택
테마를 고를 수 있는 사이트가 몇가지 있는데
여기서 마음에 드는거 고르면됨.
내가 선택한 테마는 현재 블로그에 적용되어 있는
github.com/cotes2020/jekyll-theme-chirpy
🐛 테마 적용하기
테마를 적용하는 방법은 2가지가 대표적인데
원하는 테마의 github repository를 clone 하여 내가 로컬 파일에 덮어쓰고 push
테마의 github repository를 fork 하여 내 github으로 들고와서 사용
두가지 다 알려드림
🐛 1. clone 후 덮어씌우기
간단하게 선택한 테마가 있는 reposiory를 clone 하여 내 로컬로 들고온다.
그대로 내 github.io 폴더에 넣고 겹치는 파일은 덮어쓰기 이후 push 하면 끝
이렇게 했는데 여러가지 오류에 의해 막혀서 다시 찾아본것이 fork 하는 방법
1번의 방법이 정상적으로 작동한다면 2번으로 할 필요 없음
🐛 2. fork 하여 사용
원하는 테마의 repository를 fork 하여 내 github으로 들고온다.
이름은 처음에 우리가 설정했던 username.github.io로 해야되는데 이미 생성되어 있으면 아래처럼 경고표시가 나오기 때문에 지워주고 새로 fork 하자
fork한 repository를 clone 하여 내 로컬에 저장하여 사용하면 끝~
이 방법의 경우 fork한 repository이기 때문에 push해도 잔디가 안박히는 현상이 있을수 있음
그런 경우 아래의 링크로 이동하여 fork한 repository 복사하는법으로 해결 하면된다 다른경우에도 유용하게 사용됨
bekangkyung.tistory.com/entry/
🐛 마무리
_posts 폴더 안에 markdown 형식으로 파일을 생성하면 블로그의 포스트가 된다.
🔥 Error
🐛 Ruby error Code 16
테마까지 다적용하고 내 repository에 push 했는데
github Action에서 빌드 실패로 빨간 표시가 나오고 Ruby error Code 16 이라는 메세지가 나옴
로컬에서
1
bundle lock --add-platform x86_64-linux
명령어 입력 해주고 다시 push 하자
stackoverflow.com/questions/72331753/ruby-and-rails-github-action-exit-code-16
🐛 push 했는데 2번씩 빌드 배포 됨
github Action에서 push 할때마다 commit 메세지가 있는것과 pages-build-and-delpoyment 2가지가 빌드되는데
pages-build-and-delpoyment가 마지막에 빌드되면 페이지가 안나오는 현상이 발생
pages-build-and-delpoyment는 repository이름이 github.io일때 github에서 자동으로 배포해주는 것이고
commit 메세지는 현재 repository의 .github/workflow 폴더에 yml 파일로 배포파일이 있어서 나오는것임
pages-build-and-delpoyment가 빌드되지 않도록
setting -> pages -> github Actions 선택함
🔥 참고
