codestates / codestates/ds-blog

[이재우] Jekyll Theme을 적용한 엄청난 깃허브 블로그 시작하기

Open
#240 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
No language data
Stars
2
Forks
4
PR merge metrics
No merged PRs in 30d

Description

# 깃허브 블로그 만들기
깃허브 블로그는 개발 블로그로 가장 많이 알려져 있다. 그래서 내가 공부를 하면서 그 과정을 기록하기 위해서 깃허브 블로그를 만들기 시작했다. 하지만, 그 과정은 정말 쉽지 않았다. 터미널에서 작업을 하는것 자체가 쉽지 않았고 깃에 대해서 1도 몰랐기 때문에 엄청난 고난과 역경을 겪어야 했다. 지금도 물론 깃을 안다고는 할 수 없다, 하지만 스스로 깃허브 블로그를 만들고 글을 포스트 하는것은 가능하다. `시작이 반이다.`라는 말이 있다. 깃허브 블로그를 일단 만들어 놓고, 그 후는 미래의 나에게 맡겨두자. 그럼 시작하자.

## 새로운 저장소 만들기
깃허브에 계정이 있다고 가정을 하겠다, 없다면 즉시 만들도록 한다. 그럼 이제 깃허브 블로그와 연동할 저장소를 만들어보자.

### 1. New Repository
![스크린샷 2020-11-13 오후 1 41 24](https://user-images.githubusercontent.com/70493869/99029618-42cdef00-25b6-11eb-8d42-0a2fe066c5f7.png)
>위의 사진과 같이 새로운 저장소를 만들기를 클릭한다.

### 2. Repository Name
![스크린샷 2020-11-13 오후 1 46 01](https://user-images.githubusercontent.com/70493869/99029751-a0623b80-25b6-11eb-9553-e8f8797c6957.png)
>저장소 이름을 `계정.github.io`로 만들어주고, **README.md**파일을 추가 해주어서 새로운 저장소를 생성하자.

![스크린샷 2020-11-13 오후 1 49 58](https://user-images.githubusercontent.com/70493869/99029942-2e3e2680-25b7-11eb-8c8e-773445703dd0.png)

짜잔, 위의 사진과 같이 **README.md**파일이 있는 빈 저장소를 만드는데 성공하였다.

## Jekyll
**Jekyll**에 대해서 간단히 알아보고, 우리 깃허브 블로그에 적용시켜보자!
### Theme
`깃허브 블로그` 만들기를 구글에 검색하게 되면, 제일 먼저 마주하는 용어는 **Jekyll** 이다. 나도 무슨 역할을 하는지 잘 모른다, 하지만 내가 사용할 깃허브 블로그가 **Jekyll**을 사용하면 엄청나게 예쁜, 멋진 블로그가 완성이 된다. 쉽게 설명하면, 내가 만들 깃허브의 테마를 정할 수 있다.
[Jekyll Themes](http://jekyllthemes.org/)와 같이 정말 다양한 테마들이 존재하기 때문에, 취향에 맞는 가장 좋은 테마를 하나 선택하자. 내가 선택한 테마는 `Centrarium`이다.

![스크린샷 2020-11-13 오후 2 08 28](https://user-images.githubusercontent.com/70493869/99031181-c3dab580-25b9-11eb-8359-4976214115f3.png)

홈페이지를 클릭하면, `Centrarium`테마가 담긴 저장소로 이동 할 수 있다.

![스크린샷 2020-11-13 오후 2 12 23](https://user-images.githubusercontent.com/70493869/99031375-42cfee00-25ba-11eb-8c6c-c00e3d2a04b9.png)

## Jekyll 테마를 나의 블로그에 적용하기
### 1. 깃 설치 (Mac)
터미널을 실행한 후, 다음 두개의 코드를 실행시켜 보자.

* `brew -v` : [Homebrew](https://brew.sh/)의 설치 여부를 확인
* `git --version` : [Git](https://git-scm.com/download/mac)의 설치 여부 확인

![스크린샷 2020-11-13 오후 2 19 55](https://user-images.githubusercontent.com/70493869/99031801-4f087b00-25bb-11eb-842f-b4855bd9a703.png)
> 만약 설치가 되어있다면, 위의 사진과 같이 각 Homebrew와 GIt에 대한 버전이 있을 것이다.

#### 1.1 Homebrew가 없는 경우
다음과 같은 코드를 터미널에서 실행하자.
* `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"` : Homebrew 설치
* `brew -v`를 실행하여 설치 여부 확인
* `brew install git`을 실행하여 깃을 설치
* `git --version` 을 실행하여 Git 설치 여부 확인

#### 1.2 Git 만 없는 경우
Git이 없는 경우에는 다음의 두 코드를 실행하자!
* `brew install git`을 실행하여 깃을 설치
* `git --version` 을 실행하여 Git 설치 여부 확인

### 2. 본인 저장소 Local에 복사하기
여기서 *Local* 현재 자신의 컴퓨터 또는 노트북을 의미한다. 따라서, 깃허브의 있는 아까 새로 만든 저장소를 나의 노트북으로 복사하는 것을 의미한다.

#### 2.1 바탕화면에 Blog 폴더 만들기
다시 터미널로 이동합니다.
* `~` 실행하여, home 위치로 이동합니다.
* `cd desktop/` 바탕화면으로 경로를 이동해줍니다.
* `mkdir blog` **blog**라는 폴더를 생성합니다.
* `cd blog/` **blog** 폴더에 들어갑니다.
> 위의 명령을 실행하였다면, 바탕화면에 blog 폴더를 확인해보세요!

#### 2.2 본인 저장소에서 저장서 주소 복사
![스크린샷 2020-11-13 오후 2 27 50](https://user-images.githubusercontent.com/70493869/99032285-8b88a680-25bc-11eb-8ff3-2afc99915e32.png)
> 본인 저장소에서 `Code`부분을 클릭하여 저장소 주소를 복사하자.

#### 2.3 Git clone을 통하여 복사하기
다시 터미널로 이동합니다.
* `git clone https://github.com/jingwoo4710/jingwoo4710.github.io.git`를 실행합니다.
* `cd 본인아이디.github.io/ ` 를 실행하면 해당폴더로 이동이 가능합니다.
* `ls`를 통해서 파일 리스트 확인
![스크린샷 2020-11-13 오후 3 49 18](https://user-images.githubusercontent.com/70493869/99037802-cc39ed00-25c7-11eb-8f8c-47fcf1bc7278.png)
> 위의 사진과 같이 **README.md** 파일만 있고 비어있음을 알 수 있습니다.

### 3. Jekyll theme 저장소 Local에 복사하기
마찬가지로, 원하는 Jekyll 테마의 저장소를 Local에 복사하겠습니다.
#### 3.1 Jekyll theme 저장소에서 저장서 주소 복사
![스크린샷 2020-11-13 오후 3 54 42](https://user-images.githubusercontent.com/70493869/99038394-c395e680-25c8-11eb-9338-8700abfa2b09.png)
* `cd ..` 하나의 상위 폴더로 이동
* `git clone https://github.com/bencentra/centrarium.git` 복제 합니다.

![스크린샷 2020-11-13 오후 4 07 46](https://user-images.githubusercontent.com/70493869/99039266-626f1280-25ca-11eb-9c30-a69f81c77e69.png)

> 다음과 같이 터미널에서 실행을 하면 됩니다.
![스크린샷 2020-11-13 오후 3 57 26](https://user-images.githubusercontent.com/70493869/99038488-ede7a400-25c8-11eb-94b6-71b775f1ee00.png)
> 다음과 같이 blog 폴더에 내 저장소 하나와, jekyll theme 저장소 하나가 있음을 알 수 있습니다.

### 4. 두 개의 저장소 합치기
현재 빈 나의 저장소에 Jekyll 테마가 담겨있는, 저장소를 합쳐봅시다! 다시 터미널로 이동합니다.
#### 4.1 Jekyll theme 저장소에 연결
* `cd jingwoo4710.github.io/` 본인 저장소 폴더로 이동
* `rm -rf README.md` 두 저장소를 합칠 때, 충돌을 막기 위해서 삭제
* ` git remote add theme https://github.com/bencentra/centrarium.git` Jekyll 테마 저장소를 연결
* `git remote -v`를 통해서 결과 확인

![스크린샷 2020-11-13 오후 4 14 02](https://user-images.githubusercontent.com/70493869/99039751-4029c480-25cb-11eb-8a61-e1c70772b9fd.png)

#### 4.2 Fetch & Merge
Jeykyll 저장소의 모든 정보들을 fetch 해서 나의 저장소에 merge를 해봅시다.
* `git fetch theme` : Jekyll theme 저장소의 모든 정보를 가져오기
* `git merge --allow-unrelated-histories theme/master` : Jekyll theme과 나의 저장소 합치기
![스크린샷 2020-11-13 오후 4 20 17](https://user-images.githubusercontent.com/70493869/99040241-1fae3a00-25cc-11eb-8a33-3442e3440b1f.png)
> 충돌이 발생했음을 알 수 있습니다.

* `git status` : 현재 상황을 확인

![스크린샷 2020-11-13 오후 4 21 24](https://user-images.githubusercontent.com/70493869/99040321-466c7080-25cc-11eb-9af4-4ad1e318ebfe.png)
> Unmerged path 라고 해서 README.md 라는 파일을 서로 추가했다는 내용을 알 수 있습니다. 우리는 이미 README.md 라는 파일을 삭제 했기 때문에, Jekyll theme의 README 파일을 가져오도록 합시다.

* `git add .` : 모든 변경사항을 추가합니다.
* `git commit -m "Jekyll theme"` : "Jekyll theme"의 메세지와 함께 변동사항을 업데이트 하는것을 승인 합니다.
* `git push origin` : 모든 변동사항을 내 저장소에 업데이트 하겠습니다.

![스크린샷 2020-11-13 오후 4 24 28](https://user-images.githubusercontent.com/70493869/99040574-b4b13300-25cc-11eb-8d86-4be5cbb1b7fe.png)
> 변동사항 업데이트 완료!

#### 4.3 결과 확인
다시 깃허브의 내 저장소를 확인 해보면, 다음과 같게 많은 내용이 추가 되었음을 알 수 있습니다.

![스크린샷 2020-11-13 오후 4 25 13](https://user-images.githubusercontent.com/70493869/99040714-f3df8400-25cc-11eb-8f5f-fe28e9c6cc70.png)

### 5. 테마 적용하기
지금까지 나의 저장소에 Jekyll 테마를 복사해왔다. 이제 적용을 시켜보자.
* `bundle install` : 필요한 플러그인을 설치
* `bundle exec jekyll serve` : 모든 설치 과정이 완료되면 아래 명령어를 이용해 서버를 시작

![스크린샷 2020-11-13 오후 5 21 40](https://user-images.githubusercontent.com/70493869/99045500-c991c480-25d4-11eb-848a-9220ed98113c.png)
> 터미널 창에서 Server address: `http://127.0.0.1:4000/` 주소를 치면!

![스크린샷 2020-11-13 오후 5 21 26](https://user-images.githubusercontent.com/70493869/99045574-e7f7c000-25d4-11eb-8603-0615df17d9b5.png)
짜잔! Jekyll 테마가 적용된 모습을 확인 할 수 있습니다!

### 6. _config.yml
최종적으로 jingwoo4710.github.io에 jekyll 테마가 설치 되기 위해서는 `_config.yml` 파일을 수정해야 한다.
#### VScode
* `code .` : VScode 에서 파일들 보기
⚠️ zsh: command not found: code 일 경우 : VScode를 켜서 -> cmd+shift+p -> shell -> install code command in PATH

![스크린샷 2020-11-13 오후 10 36 25](https://user-images.githubusercontent.com/70493869/99077854-beed2480-2600-11eb-8dd3-5aaee5c9d1c3.png)
> 클릭을 한 후에 `code .` 실행

#### _config.yml 수정

![스크린샷 2020-11-13 오후 10 38 26](https://user-images.githubusercontent.com/70493869/99078071-18555380-2601-11eb-9535-208aea966f01.png)
> url 부분만 우리 블로그 저장소 주소(https://jingwoo4710.github.io)를 입력하게 되면 된다.

* `git add .` : 모든 변경사항을 추가합니다.
* `git commit -m "change _config.yml"` : "Jekyll theme"의 메세지와 함께 변동사항을 업데이트 하는것을 승인 합니다.
* `git push origin` : 모든 변동사항을 내 저장소에 업데이트 하겠습니다.

![스크린샷 2020-11-13 오후 11 05 31](https://user-images.githubusercontent.com/70493869/99080533-c4e50480-2604-11eb-8aac-cb3fca44a6a8.png)

> 그러면 최종적으로, jingwoo4710.github.io가 jekyll 테마가 적용 된 엄청난 깃허브 블로그를 만들 수 있다.

지금까지 터미널에서 **git** 명령어를 통해 jekyll 테마를 적용 시켜보았다. 글을 올리고, 다음 단계는 다음 글을 확인해보자!

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.