HOWTO.md

サイトのメンテナンス手順など

リモートリポジトリ

• 公開用
  • Public: GitHub rust-jp-blogs/tatsuya6502
• 下書き用
  • Draft: 非公開リポジトリ

ソフトウェアのセットアップ

Hugoをインストールしておく。

ドラフト記事の作成

1. ローカルにトピックブランチを作成する
2. git submodule update
3. hugo new posts/20YY-MM-my-post.md
4. hugo server -D -F
5. http://localhost:1313/tatsuya6502/ を開く
6. 以下の例を参考にfront matterを修正する

Front Matterの例

title: "記事のタイトル"
# summary: ""
date: 2019-04-29T11:15:00+08:00
draft: no
isCJKLanguage: true
categories:
- Rust Tips
tags:
- 実践Rust入門

ドラフトの保存

トピックブランチ上でコミットし、draftレポジトリへpushする。

記事の公開準備（masterブランチのマージ）

1. Front matterを更新する
   • dateを更新
   • draft: をnoに変更
2. 必要ならファイル名（20YY-MM）などを変更する
3. hugo serverで内容を確認する
4. トピックブランチへコミットする
5. 必要ならトピックブランチをrebaseしたり、過去のコミットをsquashしたりする
6. （トピックブランチをdraftリポジトリへpushする）
7. トピックブランチをpublicリポジトリへpushする
8. GitHubサイトでリポジトリを開き、プルリクエストを作成する。
   • マージ元：トピックブランチ
   • マージ先：masterブランチ
9. 問題がなければプルリクエストをマージする

記事の公開

1. publicリポジトリからmasterブランチをpullする
2. rm -rf docs
3. hugo -Fコマンドを実行してHTMLを生成する（docsフォルダへ出力される）
4. docsフォルダ配下のファイルをmasterブランチへコミットする
5. masterブランチをdraftリポジトリへpushする
6. masterブランチをpublicリポジトリへpushする
7. サイトに記事が公開されたことを確認する

記事公開後の作業

1. トピックブランチをpublicリポジトリから削除する
2. トピックブランチをdraftリポジトリから削除する

Themeのカスタマイズ

リポジトリ： GitHub rust-jp-blogs/hugo_theme_pickles