Jekyll 글쓰기

해당 글은 minimal-mistake them를 기초로 한다.

---

1. 머리말(Front Matter)

-(Hyphen) 세개로 감싼다.

---
# page
title: "Jekyll 글쓰기"
excerpt: "Jekyll Post Guide"
permalink: /blog/post/jekyll/
layout: single
published: true
# classes: wide

# toc
toc: true 
toc_sticky: true 
toc_label: "Table of contents"
toc_icon: list

# category & tag
categories:
  - post
tags: [post, jekyll, YAML]

# Time
read_time: false
date: 2020-09-15 00:00:00 +09:00
last_modified_at: 2020-09-15T12:00:00+09:00
---

• title

  글의 제목이며, breadcrumbs가 true일 때 최종 파일 명을 나타낸다.

• excerpt

  글을 요약한 것으로, 글 클릭 전 페이지에서 제목 밑에 나온다.

• permalink

  글의 링크 주소를 설정한다.
  e.g. permalink: /blog/post/’ is kkiyou.github.io/blog/post/

• layout

  /_layouts 폴더에 있는 설정을 활용해 페이지를 나타낼 형식을 설정한다.

• published

  사이트에 해당 글을 노출하지 않으려면 fasle를 사용한다.

  기본값(default)은 true이기 때문에 글을 노출할 것이면 사용하지 않아도 무방하다.

• classes

  본문을 최대 너비로 바꾼다.

• toc

  true일 때 헤더를 사이드바 목차로 나타낸다.

• toc_sticky

  true일 때 스크롤 이동할 때 목차가 따라오도록 한다.

• toc_label

  목차 최상단에 보일 title을 설정한다.

• toc_icon

  목차 최상단 title 옆에 나타나는 아이콘을 설정한다. Icon List

• categories

  글의 카테고리를 설정한다.

  []사이에 넣어 사용하거나, -를 사용해 나타낼 수 있다.Reference

• tags

  글의 tag를 설정한다.

  []사이에 넣어 사용하거나, -를 사용해 나타낼 수 있다.

• read_time

  true일 때 /_config.yml에 설정된 words_per_minute를 활용해 글을 읽는데 소요되는 시간을 표시한다.

  따라서 read time을 표시하지 않고 싶다면 false로 설정해야 한다.

• date

  글의 최초 생성일로 글을 정렬할 때 사용된다.

  YYYY-MM-DD HH:MM:SS +/-TTTT 형식이다.(HH:MM:SS +/-TTTT 생략 가능)

  YYYY-MM-DDTHH:MM:SS+/-TTTT도 사용 가능하다. (THH:MM:SS+/-TTTT 생략 가능)

• last_modified_at:

  글의 최종 수정일로 date에 우선한다.

  YYYY-MM-DD HH:MM:SS +/-TTTT 형식이다.(HH:MM:SS +/-TTTT 생략 가능)

  YYYY-MM-DDTHH:MM:SS+/-TTTT도 사용 가능하다. (THH:MM:SS+/-TTTT 생략 가능)

2. 글의 기본값 설정하기

/_config.yml에서 defaults 값을 설정한다. Reference
단, 개별 글의 설정 값이 우선한다. 즉 기본값과 글에서 설정한 값이 다를 경우 개별 글에서 설정한 값을 적용한다.

defaults:
  # _posts
  - scope:
      path: _posts
      type: 
    values:
      layout: single
      author_profile: true
      read_time: false
      comments: true
      share: true
      related: true

  # _pages
  - scope:
      path: ""
      type: pages
    values:
      layout: single
      author_profile: true
      read_time: false
      comments: false
      share: true
      related: false

: 다음에 텍스트를 입력할 때 “(Quotation mark)를 사용하지 않는다. type: "pages"이면 Error가 발생한다.

2.1. scope

value가 적용될 파일을 제한한다.

• path

  적용될 경로를 설정하여, 설정한 폴더 내 모든 파일에 ‘values’값을 적용한다.
  path: ""이면 프로젝트 내 모든 파일에 적용한다.

• type

  설정된 경로 내 설정한 레이아웃이 적용된 파일에만 ‘values’값을 적용한다.

e.g.

path: ""
type: posts

이면 ‘_posts’ 폴더 내에서 레이아웃이 ‘posts’인 파일에만 ‘values’값을 적용한다.

2.2. values

scope로 필터된 글에 적용될 기본값을 설정한다.