2 min read

github으로 페이지 만들기

2020-06-18

.github.io가 url에 들어가는 페이지를 보셨나요?

  • 간단하게 만들 수 있으면서 깔끔하고 아주 편하다
  • 설치할 필요가 따로 없다
  • 매우 많은 수의 테마를 골라 사용할 수 있다

새 github 저장소(repository) 만들기

  • 개인 페이지일 경우 github username 뒤에 .github.io 붙여 이름을 짓는다
  • 프로젝트 페이지일 경우 아무 이름이나 넣어도 된다. 이 경우 username.github.io/projectname의 형태가 된다.

(선택)원하는 jekyll 테마 선택

  • 여기에서 구할 수 있다.

_config.yml 만들기

  • 테마를 지정했다면 테마 저장소에서 가져올 수 있다.
highlighter: rouge
# text highlighter로 rouge이용
# 2016.02월 이후로 syntax highlighter는 rouge만 지원.
# Pygments 사용불가.

paginate: 
# 작성한 모든 post를 하나의 페이지에 열거할 수 없으니
# pagination이 필요하고 몇개의 post를 하나의 page에서
# 보여줄 건지를 설정.

language: 
# 언어 설정

url:
# Google Search Console에서 사용하는 sitemap.xml 생성시
# 이 url key값이 존재하지 않으면 sitemap.xml이
# 정상적으로 생성되지 않는다.
# 또한 disqus(댓글시스템)를 이용하기 위해서도 필요.
# 자신의 github page url을 입력
# ( https://your_github_id.github.io 형식 )

baseurl: /

# Website info
title:
# 자신의 blog title.

description:
# blog home에 표시될 blog에 대한 전반적인 설명.

cover:
# blog home에 표시될 blog cover image.

logo:
logo_dark:

favicon:
# favicon으로 사용할 image

production_url:
# 최종적으로 blog가 운영될 url

source_url:
# blogmaker(jekyll source folder)에 대한 github repository

# Social info
navigation:
# Navigation bar link를 보여줄건지 여부

subscribers:
# subscriber 기능을 사용할건지의 여부
# 저는 약간의 수정을 통해 subscriber 기능대신
# lunr.js를 이용한 검색 기능으로 대체 사용했습니다.
# 검색기능으로 대체하기 위해서
# `_includes/subscribe-form.html` 파일의 수정이 필요합니다.

twitter:
facebook:
# 만약 twitter와 facebook을 이용하면 username을 입력

# Disqus
disqus: 
disqus_shortname: 
# disqus는 온라인 댓글 시스템. 댓글 기능을 사용하기 위해
# disqus를 이용할 것인지 여부와 만약 사용하면
# disqus shortname을 입력 ( disqus username이 아님 )


# Google Analytics
google_analytics:
# Google Analytics을 사용할 경우 GA tracking identifier를 입력

# Permalinks
permalink:
# permalink:
# permalink:
# 각각의 post에 고정주소를 어떤 방식으로 할당할 것인지를 결정
# 이 값을 바꾸면 작성한 포스트의 저장위치나 파일이름이 변경된다.

# gems and other configs
plugins: 

feed:
  path: 

# Travis-CI 설정입니다.
safe:
lsi: 

username:
repo:
# username : travis-ci와 연동하는 github의 username
# repo: travis-ci와 연동하는 github의 repository이름
# https://github.com/<username>/<repository>

branch:
# 사용할 branch명

relative_source:

destination: ./output/
# compile된 결과가 생성되는 폴더
# 이 폴더안의 내용이 우리가 운영하는 블로그 내용이 컴파일되서 들어간다.
# 이 폴더안의 내용을 github repository(https://username.github.io)에 push
# 만약 Travis-CI를 이용할 예정이면 이 부분을 git submodule로
# github repository(https://username.github.io)에 연결해야 한다.


# exclude는 Jekyll컴파일 시 destination에 포함될 필요가
# 없는것들을 명시한다. (node_modules와 필요없는 것들은 제외)
exclude:

config 설정까지 완료했다면

  • 마크다운 문서를 html로 knit해서 github에 push한다.
  • 기본 설정을 건드리지 않았다면 으로 해당 repo의 맨 윗 폴더의 index.html 이 페이지의 내용이 된다.