/ GIT

Github Page 기본

Github Page

  • 웹호스팅 서비스
  • 해당 Repository에 대한 설명 웹페이지로 사용되나 기본 블로그로 사용하기도 함
    • 마크다운 언어 사용가능한 정적 사이트 생성기인 Jekyll 프레임워크 지원
      • 마크다운 파일을 HTML로 변환하는 일종의 CMS(Content Management System)
      • .nojekyll 파일을 만들어 루트 디렉토리에 올리면 Jekyll 사용안함
  • 블로그로 사용 시 다양한 Jekyll 테마를 활용할 수 있음 (http://jekyllthemes.org/)

사용방법

  • jekyll 프레임워크를 사용하려면 먼저 ruby 개발환경이 설치되어있어야 함

  • 추가 개발환경 설정 (VS Code, git, markdown 에디터 등)

    • 개발환경설정
    • markdown 에디터는 Typora가 가장 만족스럽지만 유료화됨
      • beta버전은 사용가능
      • 대안으로 MarkText ( https://github.com/marktext/marktext#download-and-installation )

  • http://jekyllthemes.org/에서 원하는 테마를 선택하여 다운로드함

    • 또는 해당 github 사이트에서 git clone을 해도 됨

  • 다운로드한 테마의 소스코드를 원하는 폴더(공백없어야 함)에 압축 해제하여 저장

  • VS Code를 실행하여 압축해제한 테마의 소스코드 폴더 열기

  • VS Code의 터미널을 열어 bundler 설치되어 있는지 확인

    • bundler -v

      으로 버전 확인

    • 설치 안되어 있으면

      gem install bundler

      실행하여 설치

  • 터미널에서 테마의 소스코드 폴더로 이동하여 해당 폴더에서 필요한 gem 패키지 설치

    • 필요한 패키지들은 해당 소스코드 폴더의 Gemfile에 기술됨

      bundle install

  • 해당 테마 블로그를 빌드하여 실행

    bundlle exec jekyll serve

    bundle exec jekyll serve –host HostIP –port PortNumber

    IP와 Port 변경 가능

    • Jekyll 소스 파일들이 변환되어 결과물들이 destination 폴더에 저장
      • destination폴더 내용이 실제 Github Page에 올릴 사이트임
      • 즉, github repository로 push할 변환 결과물

  • 블로그 포스팅하기

    • 해당 소스코드 폴더 내 _post 폴더에 포스팅할 파일을 마크다운 형식으로 작성
    • 작성 후 빌드/실행하면 destination 폴더내에 포스팅 파일이 변환되어 생성됨
    • 생성된 destination 폴더 내 블로그 사이트를 github로 push

Jekyll 환경 설정 (소스코드)

  • _config.yml 파일 : 전체 설정파일

  • build 시 환경변수 default값이 development로 설정 : 빌드시 localhost 설정됨

    • 실제 release버전을 build할 때는 JEKYLL_ENV 환경변수값을 production으로 변경 : 빌드 시 URL 생성

      JEKYLL_ENV=production bundle exec jekyll build
-->