Think Twice
IT技術メモ | HUGOのメモ
Created: 2023-02-24 / Updated: 2023-03-01

HUGOをクイックスタートする


目次


概要

とりあえずサイトを作ってみましょう。
C:\temp\hugoというフォルダで作業している想定です。

サイトを作る

まずはquickstartというサイトを作成しましょう。
以下のように、hugo new siteコマンドに作成したいサイト名を渡して実行します。

Copy
PS C:\temp\hugo> hugo new site quickstart
Congratulations! Your new Hugo site is created in C:\temp\hugo\quickstart.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder.
   Choose a theme from https://themes.gohugo.io/ or
   create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>\<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

テーマを追加する

gitリポジトリを作成

quickstartフォルダに移動してから、

Copy
PS C:\temp\hugo> cd .\quickstart\

gitリポジトリを初期化します。

Copy
PS C:\temp\hugo\quickstart> git init
Initialized empty Git repository in C:/temp/hugo/quickstart/.git/

テーマを追加

次にテーマをgitのサブモジュールとしてaddします。

Copy
PS C:\temp\hugo\quickstart> git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke
Cloning into 'C:/temp/hugo/quickstart/themes/ananke'...
remote: Enumerating objects: 2654, done.
remote: Counting objects: 100% (83/83), done.
remote: Compressing objects: 100% (48/48), done.
remote: Total 2654 (delta 35), reused 66 (delta 28), pack-reused 2571
Receiving objects: 100% (2654/2654), 4.51 MiB | 2.50 MiB/s, done.
Resolving deltas: 100% (1468/1468), done.

サイトの設定をいじる

config.toml を編集

サイトフォルダの直下にあるconfig.tomlファイルを編集します。
最終行に以下のようにテーマとして何を使うかの設定行を追加します。

config.toml
Copy
baseURL = 'http://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'ananke'

また、たぶんこのメモを見てくれている人は日本語を使う人が大半かと思うので、languageCodeja-jpにしておくと良い気がします。

config.toml
Copy
baseURL = 'http://example.org/'
languageCode = 'ja-jp'
title = 'My New Hugo Site'
theme = 'ananke'

サイトを公開する

hugo serverコマンドでサイトを公開します。

Copy
PS C:\temp\hugo\quickstart> hugo server
Start building sites …
hugo v0.110.0-e32a493b7826d02763c3b79623952e625402b168+extended windows/amd64 BuildDate=2023-01-17T12:16:09Z VendorInfo=gohugoio

                   | EN
-------------------+-----
  Pages            |  7
  Paginator pages  |  0
  Non-page files   |  0
  Static files     |  1
  Processed images |  0
  Aliases          |  0
  Sitemaps         |  1
  Cleaned          |  0

Built in 296 ms
Watching for changes in C:\temp\hugo\quickstart\{archetypes,assets,content,data,layouts,static,themes}
Watching for config changes in C:\temp\hugo\quickstart\config.toml, C:\temp\hugo\quickstart\themes\ananke\config.yaml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

立ち上がったサイトのイメージ


参考

参考サイト