Skip to content

블로그 관련 설정

wannte edited this page Jun 30, 2021 · 4 revisions

3기를 위한 블로그 관련 설정 정리글입니다 😄

블로그 빌드

Javable 블로그는 gatsby.js를 사용하여 빌드됩니다. 빌드는 github action의 스크립트를 통해 빌드됩니다.

author 추가

src/content/author.yaml 파일을 수정하여 author를 추가할 수 있습니다. 커스터마이징 할 수 있는 설정은 아래와 같습니다.

  • id : 'n기_XXX'의 형식으로 본인의 기수와 닉네임을 사용하면 될 것 같습니다. (ex. 4기_브라운)

  • avatar : 본인의 프로필 사진의 링크를 작성하면 됩니다.

  • bio : 본인에 대한 설명을 작성하면 됩니다.

  • github : 깃헙 아이디를 적습니다. https://github.com/{본인의 아이디} 여기서 본인의 아이디 부분이 깃헙 아이디 일 겁니다.

  • website : 개인 블로그가 있다면 여기 링크를 추가하시면 될 것 같습니다.

  • location : 본인의 거주 지역입니다(굳이 작성해야하나 싶은데 그냥 귀찮으면 기본값으로 Seoul 적으면 될 것 같습니다)

  • profile_image : 본인 페이지의 배경 사진의 링크를 작성하면 됩니다.

author image

여기서 나무 배경이 profile_image, 개인 사진이 avatar 입니다!

tag 추가

tag는 따로 설정을 안해도 자동적으로 추가가 됩니다. 그러나 tag도 author 페이지처럼 배경 사진과 설명을 작성하고 싶다면 src/content/tag.yaml 파일을 수정하면 됩니다.

  • id : tag 이름을 작성하면 됩니다.

  • description : tag에 대한 간단한 설명을 작성하면 됩니다.

  • image : 배경으로 사용할 사진의 링크를 작성하면 됩니다.

폴더 구조

블로그 글 작성에는 src/content 하위의 폴더만 관리하면 됩니다. img 폴더는 블로그 디자인과 관련된 이미지들이 저장된 폴더이므로 따로 건드리실 필요는 없습니다.

post 폴더 내부에 markdown 형식으로 작성한 글을, images 폴더 내부에 글과 관련된 사진 파일을 저장하면 됩니다.

post 형식

먼저 파일의 형식은 {YYYY-MM-DD 형식의 날짜}-{주제를 드러내는 파일 이름}.md 입니다.

파일의 frontmatter로는

  • layout : 파일의 타입입니다. post로 작성하면 됩니다.

  • title : 글의 제목을 쓰시면 됩니다. ('제목' 형식으로 따옴표 안에 작성 합니다 - 따옴표 없이 작성시 간혹 특수문자에서 build가 터지는 문제가 발생합니다)

  • author : 'n기_XXX'의 형식으로 작성자 본인의 기수와 닉네임을 사용하면 될 것 같습니다. (ex. 4기_브라운)

  • tags : tag를 작성하면 됩니다. 형식은 대괄호 안에 리스트 형식으로 tag들을 쓰면 됩니다. ex. ['java', 'singleton']

  • date : 작성한 날짜입니다. "2020-12-23T12:00:00.000Z" 와 같이 작성하면 되고 시간은 그냥 편하신대로 쓰면 됩니다. 저는 그냥 12시로 통일해뒀습니다. 이 시간 순서대로 글이 리스트 될 것입니다.

  • draft : 아마 맨 앞에 매인으로 보여지는 글 인것 같은데 false를 옵션으로 주면 가장 최신 글이 메인에 보여지는 것 같습니다. 그냥 false로 작성하시면 됩니다.

  • image : 글의 티저 이미지의 링크를 작성하면 됩니다. 티저 이미지가 없으면 보기가 안좋아서 본인의 글과 관련된 이미지를 등록하면 될 것 같습니다. 티저 이미지는 src/content/teaser 폴더 내부에 저장해두면 됩니다.