이번에 블로그 내용은 마크다운(markdown) 문서를 작성하기 위하여 사용하는 에디터, 깃허브 블로그에 포스팅 적용방법 및 페이지 만드는 법을 정리하기 위하여 작성하였다.

1. 마크다운 에디터

마크다운(Markdown) 형식의 문서를 작성하기 위해서는 마크다운 에디터를 사용하는 것이 편하다. 나는 아톰(Atom) 에디터로 마크다운 문서를 작성한다. 아톰 에디터는 마크다운 미리보기(Markdown preview) 를 제공하여 포스팅이 어떻게 작성되는지 확인하면서 작성 할 수 있다. 마크다운 편집기는 Atom이 아니더라도 미리보기가 제공되는 편집기를 사용하는 것을 추천한다.

[ Atom편집기 미리보기 예시 ]

2. 마크다운 파일 생성

깃허브 블로그 페이지는 마크다운(Markdown) 문서(.md)로 작성 한다.
블로그 디렉터리를 확인하면 _posts 라는 폴더가 있는데 이곳이 블로그 포스팅으로 작성한 파일을 넣어두는 부분이다. 제목은 왠만하면 영어 또는 숫자로 적는 것이 좋다. 한글로 작성하게 되면 가끔 인코딩 오류가 발생하여 페이지 로드 오류가 발생했다.

블로그 테마별로 날짜를 적는 형식이 조금씩 다른 것 같다. 어떤 테마에는 위의 yml 형식 부분에 적어 두는 곳도 있고 나처럼 문서 제목에 날짜를 달면 자동으로 포스팅한 날짜가 블로그에 적용이 되는 테마도 있는 것 같다. 파일 제목은 포스팅 콘텐츠의 url에 사용이 된다.

먼저 블로그 포스팅 내용을 작성하기 전에 상단의 위의 그림처럼 형식을 먼저 작성한다. layout: post 는 포스팅 내용을 작성한다는 뜻이다. layout: page 이면 새로운 페이지를 생성할 수 있다. title 은 포스팅 하는 컨텐츠의 이름, comments 는 댓글을 달수 있도록 허용할 것인가 여부, tag 는 포스팅에 달 태그를 작성하는 곳이다. 테마의 기능마다 작성할 수 있는 것이 제한되어 있으므로 테마 기능에 따라서 작성하면 된다.

위의 사진은 about.md라는 마크다운 형식의 파일을 작성하여 page를 생성 한 모습이다. 페이지를 생성하고 싶으면 루트 디렉토리에 넣어주면 생성이 된다.(devYurim.github.io/about.md)

3. 깃허브(Github) 블로그에 업로드

항상 깃허브에 변경사항을 적용할 때는 저장소에 커밋 및 푸쉬를 해주면 된다.

/*로컬 저장소로 경로 이동 후 아래의 명령어 실행*/
$ git add .
$ git commit -m "커밋내용"
$ git push origin master