1 minute read

포스트 등록 개요

: 지금까지는 html 을 등록하고 지킬테마가 작동하는지 확인했다. 이번에는 실제로 글을 등록한다.

포스트(post)

: 지킬에서의 게시물은 크게 post와 page로 구분된다. 여기서 post 를 설명한다.

  • 블로그 포스트 각각의 게시물은 post 라고 부르기로 약속했다.
  • 블로그 포스트는 _posts 폴더에 위치한다.
  • _posts 폴더에 속한 post들은 날짜 기반의 규칙으로 파일명이 작성된다.
  • 작성된 포스트파일은 지킬이 html로 변환하여 게시한다.

주인장 소개 페이지나 사이트맵과 같이 날짜와 관련없는 페이지들이 있을 수 있다. 이런 경우를 위해서 지킬은 page를 지원한다. 페이지는 다음에 설명한다.

포스트(post) 디폴트 설정

: _config.yml에서 post와 page의 YFM을 추가하면, 각 post 의 기본 설정이 된다. 이 기본 설정이 post 에서 YFM로 다시 재정의가 되면 그 값으로 변경이 되고, post 에서 정의가 되어 있지 않다면 _config.yml에서의 기본 설정값을 그대로 쓰게 된다.

/_config.yml

# Defaults
defaults:
  # _posts
  - scope:
      path: ""
      type: posts
    values:
      layout: single
      author_profile: true
      read_time: true
      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

위 내용을 보면 포스트의 기본 레이아웃이 single 로 잡혀있다. 즉, 따로 오버라이딩하지 않으면 이 기본 설정이 적용되어진다.

pages 도 동일한 개념이다.

등록 과정

: 게시물(포스트)을 등록하는 과정은 다음과 같다.

잠깐)
minimal-mistakes theme의 초기상태는 _posts 폴더가 없다.

  1. _posts 폴더 생성
  2. 포스트 파일명을 형식에 맞춰서 생성
  3. 내용을 규칙에 맞게 작성

등록

: 실제로 등록해본다. 여기서는 2022-11-01-테스트포스트.md 라고 작성하겠다.

/_posts/2022-11-01-테스트포스트.md

  1. _posts 폴더 생성
    루트 경로에 생성한다.
     mkdir /_posts
    
    
  2. 포스트 파일명을 형식에 맞춰서 생성
    지킬은 이 규칙을 반드시 강제한다. ==> YYYY-MM-DD-제목.md
     cd /_posts
     touch 2022-11-01-테스트포스트.md
    
    
  3. 내용을 규칙에 맞게 작성
    YFM(YAML Front Matter) 포맷에 맞게 작성한다.

    YFM(YAML Front Matter)

    • markdown 파일의 최상단에 위치하며 3개의 하이픈으로 시작과 끝을 표시한다.
    • YAML은 오픈 소스 프로젝트에서 많이 사용하는 구조화된 데이터 형식이라고만 알고 넘어가자.
    • YFM은 이 YAML을 사용해서 글의 제목, 날짜, 카테고리, 태그, 레이아웃 등을 정의할 수 있다.
     vi 2022-11-01-테스트포스트.md
    
    
     ---
     title: "테스트포스트"
     excerpt: "테스트포스트 입니다."
     ---
    
     # 테스트제목
     : 테스트 내용
    
    

결과 확인

: 메인페이지에 가보면 글이 등록되어있다.

Leave a comment