HCN DEV

Welcome to Jekyll miNi Press!

Welcome to Jekyll miNi Press! feature image
Github 블로그에 오신 것을 환영합니다!

Site Demo: https://hcn1519.github.io/articles/2017-03/welcome-to-jekyll-MiniPress

Github 블로그 는 github에서 호스팅을 지원해주는 블로그 플랫폼으로 누구나 Github 계정이 있다면 시작할 수 있는 jekyll이라는 static framework 에 기반한 블로그입니다. Github 블로그의 가장 큰 장점은 html, css, git 을 조금만 알고 있다면 모든 기능 및 디자인을 내 마음대로 설정할 수 있다는 점입니다. 무엇보다도 무료 입니다! 지금 바로 시작해보세요!

Getting Started

Using github-pages

https://pages.github.com

위의 링크를 타고 가시면, Github Pages를 시작하는 방법에 대해 나와있습니다. 다만 템플릿을 사용하기 위해서는 순서가 다소 다를 수 있으니 다음 과정을 따라주세요.

1. Fork Repository

사용하기를 원하는 템플릿을 내 Repositoryfork 해옵니다. 여기서 fork란 포크로 다른 사람의 Repository를 내 Repository로 찍어오는 것을 의미합니다. 아래 링크로 가서 miNiPress 템플릿을 fork해주면, 해당 Repository가 자신의 Repository로 복사되는 것을 확인할 수 있습니다.

https://github.com/hcn1519/miNiPress

2. Rename Repository

해당 Repository가 블로그를 위해 사용된다는 것을 github이 알 수 있도록 Repository의 이름을 변경해줍니다. Settings탭에 들어가면, 이름을 변경할 수 있는데, 이 때 이름은 항상 "username".github.io의 형태이어야 합니다.(ex - hcn1519.github.io)

3. All done!

여러분의 URL("username".github.io)로 이동하면, 블로그가 만들어진 것을 확인할 수 있습니다.

첫 포스트 작성하기

방법 1. github 사이트에서 바로 작성하기

여러분의 Repository에서 바로 첫 포스트를 작성할 수 있습니다. /_posts로 이동 후 test.md 혹은 test.html을 생성합니다. 그리고 해당 파일에 헤더로(파일의 최상단에) 다음과 같은 필요한 포스트 정보를 작성합니다.

---
layout: post
title:  "Welcome to Jekyll miNi Press!"
date:   2017-03-29 13:56:55 +0900
categories: jekyll
tags: [jekyll, blogTheme]
excerpt: "Welcome to MiniPress"
---

그리고 바로 아래에 포스트 내용을 작성하면 됩니다.

방법 2. 로컬에서 포스트 작성하기

이 방법은 컴퓨터에 git이 설치되어 있어야 합니다. 먼저 git을 설치하고, 다음 과정을 진행해 주세요.

프로젝트를 다운 받고, 해당 프로젝트의 /_posts로 이동 후 test.md 혹은 test.html을 생성합니다. 그리고 해당 파일에 헤더로(파일의 최상단에) 다음과 같은 필요한 포스트 정보를 작성합니다.

---
layout: post
title:  "Welcome to Jekyll miNi Press!"
date:   2017-03-29 13:56:55 +0900
categories: jekyll
tags: [jekyll, blogTheme]
excerpt: "Welcome to MiniPress"
---

그리고 포스트 내용을 작성합니다. 이후, 다운 받은 프로젝트를 github으로 푸쉬하는 작업이 필요합니다. 터미널에서 다운 받은 프로젝트로 이동 후, 다음 명령어를 순서대로 입력하면, 내 글이 서버에 올라가게 됩니다.

$ git init
$ git add -A
$ git commit -m "Adding Test Post"
// username과 repo이름 설정이 필요합니다.
$ git remote add origin remote "https://github.com/'github username'/'repo 이름'.git"
$ git push -u origin master

Local Posting with Jekyll

Jekyll을 설치하게 되면, 작성한 포스팅을 실제 블로그에 올리기 전에 내 컴퓨터에서 확인할 수 있습니다.

$ gem install jekyll

Jekyll이 설치되면, 터미널에서 설치된 블로그의 루트 경로로 이동합니다. 그리고 해당 경로에서 다음 명령어를 치게되면, 블로그가 local에서 실행됩니다.

$ bundle exec jekyll serve

그리고 웹브라우저에서 localhost:4000으로 접속하면, 내 블로그의 내용들을 확인할 수 있습니다.