jekyll에서 포스팅 하는 방법

작성일 | In | |
머릿말 작성법과 본문에서 사용할 수 있는 유용한 것들

포스트 파일 추가하는 방법

_post 폴더에 다음 형식으로 파일명을 쓰자. 년-월-일-제목.md

1
 
2020-05-23-jekyll에서-포스팅-하는-방법.md

수정은 vscode나 atom 등을 사용하자. 정 없다면 메모장도 좋다

포스팅 파일은 다음과 같이 구성된다

1
2
3
4
5
 
---
머릿말
---

본문

머릿말 쓰는 방법

1
2
3
4
 
---
키1: 값1
키2: 값2
---

title

제목을 나타내는 키이다.

1
 
title: 포스팅 하는 방법

date

포스팅 시각을 나타내는 키로, ‘년-월-일 시:분:초 +/-시:분’의 형식으로 이뤄진다.

뒤에 있는 시는 표준시를 지정하는것이다.

  • 시,분,초 및 표준시는 생략할 수 있다.
1
 
date: 2020-05-23 02:07:08 +9:00

tags, category(categories)

태그와 카테고리를 나타내는 키로, 값을 list형식으로 준다.

  • 태그는 그저 검색용으로 보면 된다.

  • 카테고리는 URI상에서 폴더를 지정해 준다. 태그와 같이 검색도 가능하다.

  • 값이 list일때는 세가지 방법이 있다.
1
2
3
4
5
 
key: [value1,value2,...]
key:
- value1
- value2
key: value1 value2(공백으로_구분)

1
2
 
categories: [tip]
tags: [jekyll]

이 키는 선택적이며, 보통은 URI를 자동 생성하는데 반해 이를 지정하면 특정 URI로 고정된다. ‘고유 주소’라고 생각하자.

1
 
permalink: /tip/2020/05/23/jekyll에서-포스팅-하는-방법.md

published

공개 여부를 지정한다. false 일시 비공개

1
 
published: true

비공개 포스트를 로컬에서는 보고싶으면, 실행할때 –unpublished 옵션을 추가하자.

1
2
 
bundle exec jekyll serve --unpublished
jekyll serve --unpublished

사용자 정의 변수

사용자 지정 변수를 만든다.

1
2
3
4
 
---
author: fienestar
---
{{ page.author }}

fienestar

layout

사용할 레이아웃 파일을 지정한다. _layouts 폴더에서 현재 테마에 사용 가능한 레이아웃들을 확인해보자.

null을 지정할 시(혹은 키 자체를 사용하지 않을 시) 테마에서 지정한 기본값이 적용된다.

기본값은 다음과 같이 설정할 수 있다.

1
2
3
4
5
6
 
defaults:
  -
    scope:
      path: "_post" # 공백을 지정하면 모든 파일을 의미한다.
    values:
      layout: "my_layout" # _layouts/my_layout

link(비표준)

링크된 게시글을 만든다. 제목을 클릭하면 링크로 이동한다. 이는 내가 가진 테마에에서 사용하는 키인데, 다른 테마에서도 범용적으로 사용하는지 몰라 일단 작성해뒀다. 이런식으로 테마에서 쓰는 변수도 있음을 알아두자.

1
 
link: http://www.google.com/

본문 쓰는 방법

html

기존 html 문법과 동일하다.

markdown

문서 작성을 도와주는 녀석으로, 작성법은 이곳을 참고하자.

LaTex

수학 기호를 쓸 수 있는 기능인데, 기본적으로 설치되어 있지 않으므로, _layout에 포스팅용 레이아웃 파일에 다음을 추가하자.

1
2
3
4
 
<script
    type="text/javascript"
    src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

$$ \mathbf{X}\_{n,p} = \mathbf{A}\_{n,k} \mathbf{B}\_{k,p} $$

\[ \mathbf{X}_{n,p} = \mathbf{A}_{n,k} \mathbf{B}_{k,p} \]

포스트 링크

머릿말의 변경등에 의해 실제 주소가 바뀌는 경우도 많으니 다음꼴로 쓰면 알아서 링크로 바꿔준다.

1
2
 
date-title # _post 폴더 내
/path/date-title # _post의 하위폴더에 있을 경우에 _post 기준 상대경로로
  • 이 포스팅은 _post/blog에 있고, 마크다운 작성법 포스팅은 _post/tip에 있다.
1
 
{% post_url /tip/2020-05-24-마크다운-작성법 %}

/tip/2020/05/24/마크다운-작성법/

마크다운으로 응용할 수 있다.

1
 
[이곳]({% post_url /tip/2020-05-24-마크다운-작성법 %})

이곳

이모티콘

1
 
:thinking:

:thinking:

이모티콘은 테마에 따라 지원하지 않는 경우도 있고, 지원하는 경우도 있는데, 만약 해보고 적용되지 않는다면 다음 방법을 따르자.

  1. 이모티콘은 gemfile에 추가 
    1
    		 
    gem 'jemoji'
  2. _config.yml에 추가 
    1
    		 
    plugins: [jemoji]

    jeykyll 버전이 3.5.0미만이라면

    1
    		 
    gems: [jemoji]

    이렇게 두자.

이모티콘 목록은 이곳을 참고하자.