目次
概要
とりあえずサイトを作ってみましょう。
C:\temp\hugo
というフォルダで作業している想定です。
サイトを作る
まずはquickstart
というサイトを作成しましょう。
以下のように、hugo new site
コマンドに作成したいサイト名を渡して実行します。
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フォルダに移動してから、
PS C:\temp\hugo> cd .\quickstart\
gitリポジトリを初期化します。
PS C:\temp\hugo\quickstart> git init Initialized empty Git repository in C:/temp/hugo/quickstart/.git/
テーマを追加
次にテーマをgitのサブモジュールとしてaddします。
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.
- ここでは、
ananke
というテーマを追加しています。
サイトの設定をいじる
config.toml を編集
サイトフォルダの直下にあるconfig.toml
ファイルを編集します。
最終行に以下のようにテーマとして何を使うかの設定行を追加します。
config.toml
baseURL = 'http://example.org/' languageCode = 'en-us' title = 'My New Hugo Site' theme = 'ananke'
- 赤字部分を追記
また、たぶんこのメモを見てくれている人は日本語を使う人が大半かと思うので、languageCode
もja-jp
にしておくと良い気がします。
config.toml
baseURL = 'http://example.org/' languageCode = 'ja-jp' title = 'My New Hugo Site' theme = 'ananke'
- 赤字部分を編集
サイトを公開する
hugo server
コマンドでサイトを公開します。
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
- 公開が完了すると
http://localhost:1313/
にて確認できるようになります。 - 停止させるには
Ctrl + C
を押下します。