github 블로그 만들기(3)

github 블로그 만들기 (3) - 게시글 올리기

1. 명명법과 Path

• 파일 이름 : YYYY-MM-DD-TITLE.EXTENSION
  • EXTENSION : md, markdown이러야 함.
  • 시간 저장하려면, Jekyll-Compose 플러그인을 써야 함.
• Path : git/닉네임.github.io/_posts

2. Front Matter (default)

글의 맨 위에 다음과 같이 적어야 함.

---
title: TITLE
date: YYYY-MM-DD HH:MM:SS +/-TTTT
categories: [TOP_CATEGORIE, SUB_CATEGORIE]
tags: [TAG]     # TAG names should always be lowercase
---

3.날짜의 시간 저장법

• _config.yml : timezone setup
• Front Matter 블록에서 +/-TTTT, +0800 으로 적을 것.

4. 카테고리 & Tags

---
categories: [Animal, Insect]
tags: [bee]
---

• tags 는 0 ~ 무한대까지 가능

5. 작성자 정보

• dafault : social.name, social.links
• 오버라이드 : _data/authors.yml (없으면 생성)

//방법1.
<author_id>:
  name: <full name>
  twitter: <twitter_of_author>
  url: <homepage_of_author>
//방법2.
---
author: <author_id>                     # for single entry
# or
authors: [<author1_id>, <author2_id>]   # for multiple entries
---

• author 는 key로 활용 가능.
• _data/authors.yml 에 author 정보 기입 시 메타 tag로 활용되어 트위터에서 사용 가능.

6. 글 정보 작성 (부제목으로 활용됨)

---
description: Short summary of the post.
---

7. 콘텐츠 테이블

• _config.yml 에서 toc: true

  false

8. 댓글

• _config.yml 에서 comments: true

  false

• 선택한 게시글에 댓글을 추가하거나 닫고 싶은 경우 Front Matter 에 comments: true

  false

9. 미디어

1. URL Prefix

   • CDN 이용 시 _config.yml 에 추가

     cdn: [https://cdn.com](https://cdn.com) (cdn 도메인을 적을 것)

   • Path로 설정할 때는 Front Matter에 추가할 것

       ---
       media_subpath: /path/to/media/
       ---
     

   • 둘 다 사용할 때 final resource URL: [site.cdn/][page.media_subpath/]file.ext

10. 이미지

• 이미지 다음 라인에 italics를 추가하면 이미지 아래에 캡션이 생성됨.

    front-style: italics
    ![img-description](/path/to/image)
    _Image Caption_
  

• 사이즈 & 위치 설정

  ![Desktop View](/assets/img/sample/mockup.png){: w="700" h="400" .left||.right||.normal }

  SVG에서 적어도 넓이는 설정해야 함 아니면 오류남.

• 프리뷰 이미지

    ---
    image:
      path: /path/to/image
      alt: image alternative text
    ---
    ---
    image: /path/to/image
    ---
    ---
    image:
      lqip: /path/to/lqip-file # or base64 URI
    ---
    ![Image description](/path/to/image){: lqip="/path/to/lqip-file" }
      
  

마크다운 참고 사이트

1. 마크다운 시작 가이드

https://www.markdownguide.org/getting-started/#flavors-of-markdown

1. 마크다운 변환 사이트

https://dillinger.io/

git config –global core.autocrlf input

bundle exec jekyll serve --trace