'Github Page'에 해당되는 글 1건

  1. 2020.04.11 Github.io + Jekyll로 블로그 만들기
반응형

Github.io + Jekyll로 블로그 만들기

개요

  • Github.io에 개인 프로젝트 & 공부 블로그를 만들고 싶다.
  • 찾아보니 Jekyll을 이용하여 만든다고 한다.
  • 어떻게 만드는지 간단하게 정리해보자.

Github.io

  • Github Pages를 이용하여 개인 프로젝트 웹사이트를 만들 수 있다.
    • Github Pages
    • 위에 링크에 나온대로만 만들어주면 금방 페이지가 완성된다.
  • 만드는 방법
    1. repository를 만들어준다.
      • username.github.io를 이름으로한 repository를 만들어준다.
    2. 만들어진 repository를 clone 해온다.
    3. 만들어진 repository 폴더에 들어가 index.html 파일을 하나 만들어준다.
    4. commit, push 하고 https://username.github.io 에 접속해본다.

Jekyll

  • 설치방법
    1. 내 환경은 Windows이므로 RubyInstaller를 다운 받는다.
    2. 설치 후 ridk install
    3. gem install jekyll bundler
    4. jekyll -v 로 설치된 버전을 확인해본다.
  • 사이트 생성
    1. 위에서 만들어진 repository 폴더에 간다.
    2. jekyll new .
      • 내 경우에는 index.html을 하나 올려놓은 상태여서 빈 폴더가 아니니까 생성하려면 –force 옵션을 넣으라고 해서 넣어줌
    3. 생성이 완료되면 Gemfile을 열어서 Github Pages일 경우에는 하라는 대로 한다.
      • 위에 Jekyll을 주석처리하고 아래 github-pages를 주석해제하라고 적혀있다.
    4. bundle exec jekyll serve를 실행하여 로컬에서 빌드할 수 있게 한다.
      • markdown을 수정하면 바로 빌드해서 적용된다.
      • localhost:4000에 접속하면 볼 수 있다.
  • 기본 수정
    1. _config.yml에 정보들을 내 정보로 변경해준다.
    2. about.markdown을 내 사이트에 맞게 수정한다.
    3. 기본적으로 _post에 만들어져있는 markdown을 내 post로 변경해준다.
      • YEAR-MONTH-DAY-Title.markdown 이름으로 파일을 만들어야 한다.
      • 미래 시점의 날짜를 입력할 경우 따로 옵션을 주지 않는 한은 빌드가 되지 않는다.
  • 카테고리 추가
    1. _layouts 폴더 추가
    2. _layouts > category.html 추가
    3. _includes 폴더 추가
    4. _includes > index.html 추가
    5. category 폴더 추가
    6. category > 추가하고자 하는 카테고리이름.markdown 추가 (ex> Blog.markdown)
    7. post의 markdown에 categories : [카테고리이름] 추가
      • 자세한 내용은 아래 링크를 참고 (코드 블럭에 일부 코드가 나오지 않아서 일단 링크로)
      • 참고 사이트
반응형
Posted by msparkms
,