Hugo - 非同期エンジニアブログ

Hugo について，わかったことをメモしたいと思う
正確かどうかは，わからない

$ hugo new post/my-first-post.md

$ hugo server
http://127.0.0.1:1313/

$ hugo -D ($ hugo となにが違うのだろう? -> ドラフトを含むか含まないか

Front Matter? => どうやら，各 md ファイルの先頭に自動的に作成される
3つのハイフンで区切られたブロックのことみたい
title, date, draft, …

たぶん，content ディレクトリ直下にファイルは置けなさそう
section となるディレクトリを置いていく感じみたい
_index.md は置けるみたい (Page Bundles -> Branch Bundles

index.md があるディレクトリは Leaf Bundle になり
_index.md があるディレクトリは Branch Bundle になるみたい

section? => content ディレクトリ直下のディレクトリや content 内で _index.md を包含しているディレクトリのことをいうみたいたぶん

LiveReload が働かない? それがないからです (Getting Started -> Basic Usage

新規作成したページがページリストに出てこない
config.toml に buildFuture = true を追加する

とりあえず hugo help してみると発見がある

hugo-server () {
	hugo server --bind $1 --baseURL=http://$1/
}

H6 Test (シャープ 6つ だとバグる?

H5 Test

About Hugo

Getting Started

Basic Usage (hugo コマンドの基本 読んだほうがいい

Hugo Modules (モジュールシステムについて とりあえず読まなくてよさそう

Content Management (一番重要っぽい

Content Management Overview (目次

Organization (content ディレクトリの基本 必読 index.md と _index.md の違いは Page Bundles で出てくる

Page Bundles (index.md と _index.md の違い 正直，よくわからない いろいろ試す必要がありそう

Supported Content Formats (HTML も使えるよって話と HTML でも Front Matter はつけてねって話

Front Matter (Front Matter は 各 md の先頭に自動的に付加される 3つ のハイフンで囲まれたブロックのこと TOML, YAML, JSON, ORG 好きな形式で書ける どんな値をセットできるかも書いてある

Page Resources (画像とかについて 画像とかはメタデータが必要っぽいがよくわからない どこに書くんだこれ

Image Processing (なんと画像を引き伸ばしたりもできるらしい

Shortcodes (マークダウンの独自拡張 ここはさらっと読んどいたほうがいい 互換性は損なわれるが ぱっと見 相当便利そう 特に gist と シンタックスハイライトと他ページ埋め込みと YouTube

Related Content (記事末尾によくある See Also こちらの記事もどうぞ のカスタマイズ とりあえずスルー

Sections (_index.md とは? 再び いまだによくわからない Page Bundles と合わせて読むべし

Types (まったくわからないが type の値は常に単数形であることはわかった でっていう Archetype とかいうなぞ概念も出てきた

Archetypes (hugo new したときの雛形 各セクションごとに準備できるみたい 読んどいたほうがいい

Taxonomies (記事をグループ分けしたりする機能 スルー

Summaries (要約を設定できるらしい スルー

Links and Cross References (リンク用のショートコード マークダウンの独自拡張 ref が絶対参照 relref が相対参照

URL Management (ひきつづきリンクの話 結構複雑そうなので 後回しに

Menus (メニューについて あとあとつけたくなったら読む

Static Files (スタイルシートとか JavaScript とか画像とかを置いておくところについて 知っておく必要があるだろう

Table of Contents (Hugo はマークダウンを読み取って勝手に目次をつくってくれる スルー

Comments (Disqus みたいなコメント機能について この点は静的サイトジェネレータの弱点だよね 自分で実装した Comento を使うつもり

Multilingual Mode (多言語対応について 日本語しか使えないのでスルー;;

Syntax Highlighting (シンタックスハイライトの詳細が記されている 必要になったら読みたい

Templates (ここは読まないとダメでしょうね

Templates Overview (目次

Introduction (必読です Golang感 がすごい ところでこれらはどこに書いて実行するのだ? => Template Lookup Order に書いてある

Template Lookup Order (Introduction にある {{ }} ってやつは layouts/_default/single.html とか layouts/_default/list.html とかに書けばいいとわかる

Functions

Variables

Hugo Pipes

CLI

Troubleshooting

Tools

Hosting & Deployment

Contribute

Maintenance

H6 Test (シャープ 6つだとバグる?

Basic Usage (hugo コマンドの基本読んだほうがいい

Hugo Modules (モジュールシステムについてとりあえず読まなくてよさそう

Organization (content ディレクトリの基本必読 index.md と _index.md の違いは Page Bundles で出てくる

Page Bundles (index.md と _index.md の違い正直，よくわからないいろいろ試す必要がありそう

Front Matter (Front Matter は各 md の先頭に自動的に付加される 3つのハイフンで囲まれたブロックのこと TOML, YAML, JSON, ORG 好きな形式で書けるどんな値をセットできるかも書いてある

Page Resources (画像とかについて画像とかはメタデータが必要っぽいがよくわからないどこに書くんだこれ

Shortcodes (マークダウンの独自拡張ここはさらっと読んどいたほうがいい互換性は損なわれるがぱっと見相当便利そう特に gist とシンタックスハイライトと他ページ埋め込みと YouTube

Related Content (記事末尾によくある See Also こちらの記事もどうぞのカスタマイズとりあえずスルー

Sections (_index.md とは? 再びいまだによくわからない Page Bundles と合わせて読むべし

Types (まったくわからないが type の値は常に単数形であることはわかったでっていう Archetype とかいうなぞ概念も出てきた

Archetypes (hugo new したときの雛形各セクションごとに準備できるみたい読んどいたほうがいい

Taxonomies (記事をグループ分けしたりする機能スルー

Summaries (要約を設定できるらしいスルー

Links and Cross References (リンク用のショートコードマークダウンの独自拡張 ref が絶対参照 relref が相対参照

URL Management (ひきつづきリンクの話結構複雑そうなので後回しに

Menus (メニューについてあとあとつけたくなったら読む

Static Files (スタイルシートとか JavaScript とか画像とかを置いておくところについて知っておく必要があるだろう

Table of Contents (Hugo はマークダウンを読み取って勝手に目次をつくってくれるスルー

Comments (Disqus みたいなコメント機能についてこの点は静的サイトジェネレータの弱点だよね自分で実装した Comento を使うつもり

Multilingual Mode (多言語対応について日本語しか使えないのでスルー;;

Syntax Highlighting (シンタックスハイライトの詳細が記されている必要になったら読みたい

Introduction (必読です Golang感がすごいところでこれらはどこに書いて実行するのだ? => Template Lookup Order に書いてある