K.MIURA@OUC

[基本環境]

• Debian 10.3.0 (amd64)

[注意]

• HugoとGitHubで作るWEBサイトの大まかな流れを掴むためのまとめです
• 記事を書くときのMarkdownについては、別のサイトを参照すること

[Hugoのインストール]

1. sudo apt update
2. sudo apt install git
3. sudo apt install golang
4. sudo apt install snapd
5. sudo snap install hugo --channel=extended
6. cd /usr/bin
7. sudo ln -s /snap/bin/hugo hugo

[作業用ディレクトリの作成]

1. cd /home/ユーザ名
2. mkdir workspace
   • ディレクトリ名は何でも良い
3. hugo new site blog
   • blogという名前でWEBサイトを新規作成する
   • WEBサイト名は何でも良い

[HugoテーマのDL]

1. cd ~/workspace/blog/theme
2. HugoテーマのDL方法
   • Hugo Bootstrap v4 BlogをDLするなら (本サイトと同じ)
     1. git clone https://github.com/alanorth/hugo-theme-bootstrap4-blog.git
   • MinimalをDLするなら (別のシンプルなテーマ)
     1. git init
     2. git submodule add https://github.com/calintat/minimal.git minimal
     3. git submodule init
     4. git submodule update

[config.tomlの編集]

1. cd ~/workspace/blog
2. mv config.toml config.toml.org
3. cp themes/テーマ名/exampleSite/config.toml .
4. vi config.toml
   • テーマ毎に内容が異なるため、テーマのWEBサイトを参照すること
   • DLしたテーマを基にオリジナルテーマを作っても良い
   • 本サイトは、Hugo Bootstrap v4 Blogに少し手を入れている

[記事の新規作成]

1. cd ~/workspace/blog
2. hugo new posts/sample.md
   • postsは記事が保存されるディレクトリであり、ディレクトリ名は何でも良い (存在しないときは自動的に作られる)
   • sample.mdは記事ファイルであり、ファイル名は何でも良い
3. cd content/posts
4. vi sample.md
   • 記事はMarkdownで書く
   • 「draft: true」は非公開記事で、「draft:false」は公開記事である
   • title:は記事タイトルなので、ファイル名から書き換える

[GitHubへアップロードするファイルの作成]

1. cd ~/workspace/blog
2. hugo
   • publicというディレクトリが生成される
   • ここにアップロードするファイルが作られる

[GitHubへのアップロード]

• GitHub上に「GitHubアカウント名.github.io」というレポジトリを作成する

1. cd ~/workspace/blog/public
2. git remote add origin https://github.com/GitHubアカウント名/GitHubアカウント名.github.io.git
3. git add -A
4. git commit -m “コメント”
5. git push origin master

[2件目以降の記事作成からアップロード]

1. 記事を作り
   1. cd ~/workspace/blog
   2. hugo new posts/sample.md
   3. cd content/posts
   4. vi sample.md
2. アップロードするファイルを作り
   1. cd ~/workspace/blog
   2. hugo
3. GitHubへアップロード
   1. cd public
   2. git add -A
   3. git commit -m “コメント”
   4. git push origin master