3분 뒤에 GitHub에 블로그 쓰기(Hugo+GitHub Pages)

전제 조건

Git가 설치되어 있습니다.

Windows의 경우 Git Bash(셸 실행 가능한 CLI)를 설치합니다.

GitHub에 계정이 있습니다.

Public의 blog 저장소와 Private의 blog-src 저장소를 만드세요.

저장소의 이름은 모든 이름일 수 있지만 본고는 블로그와 블로그-src 저장소를 사용합니다.

에 Hugo가 설치되어 있습니다.

Install Hugo | Hugo

인터넷 블로그

컵라면이 길어질 테니 빨리 하세요.거의 명령을 복사해서 때리기만 하면 된다.1. 블로그 사이트를 구축한다.

# Create a New Site
hugo new site blog-src

# Add a Theme
cd blog-src

git init

mkdir themes
cd themes
git clone https://github.com/budparr/gohugo-theme-ananke.git
cd ..

# Add Some Content
hugo new posts/my-first-post.md

2. config.설정을 변경하기 위해 toml을 엽니다.

baseURL = "https://<USERNAME>.github.io/blog/"
languageCode = "ja-jp"
title = "My New Hugo Site"
theme = "ananke"

3. 로컬 환경에서 블로그 사이트를 실행합니다.localhost: 1313/blog가 열립니다.확인 후 Ctrl+C 사이트를 중지하십시오.

# Navigate to your new site at http://localhost:1313/blog/
hugo server -D

4. posts/my-first-post.md를 열고draft를false로 설정합니다.

---
title: "my-first-post"
date: 2019-04-25T01:49:06+09:00
draft: false
---

5. Blog-src를 GitHub로 밀어냅니다.

# public が存在すると submodule を追加できないため消してから追加
rm -rf public
git submodule add https://github.com/<USERNAME>/blog.git public

git add .
git commit -m "first commit"
git remote add origin https://github.com/<USERNAME>/blog-src.git
git push -u origin master

6. 블로그를 GitHub에 배포합니다.이 명령은 deploy입니다.sh라는 이름으로 루트에 저장하면 다음 deploy에서 사용할 수 있기 때문에 편리합니다.
deploy.sh

#!/bin/bash

echo -e "\033[0;32mDeploying updates to GitHub...\033[0m"

# Build the project.
hugo # if using a theme, replace with `hugo -t <YOURTHEME>`

# Go To Public folder
cd public
# Add changes to git.
git add .

# Commit changes.
msg="rebuilding site `date`"
if [ $# -eq 1 ]
  then msg="$1"
fi
git commit -m "$msg"

# Push source and build repos.
git push origin master

# Come Back up to the Project Root
cd ..

7. 블로그 저장소의 GitHub Pages를 활성화합니다.
설정 > GitHub Pages > Source에서 master branch를 선택합니다.

8. 잠시 후 GitHub Pages(https://<USERNAME>.github.io/blog/)에 액세스할 수 있습니다.블로그가 완성되었습니다.

비고

이 템플릿은 빠른 시작과 같은 ananke를 사용합니다.좋아하는 걸로 바꾸거나 해도 돼요.

하위 모듈은 번거롭습니다. 보도와 템플릿을 공개할 수 있다면 저장소 하나면 됩니다.

GitHub Pages의 공통 디렉토리를 master/docs로 변경합니다.

Hugo의 publishDir 설정을 docs로 변경합니다.

글이나 템플릿의 원본 코드를 관리하지 않아도 저장소 하나만 관리할 수 있다.

blog-src를 만들지 않아도 되고 & Git init를 만들지 않아도 된다.

Hugo는 초고와 라벨 기능 등 다양한 기능이 있습니다. 자세한 내용은 Hugo Documentation | Hugo 를 참조하십시오.