Hugo
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
検索
|
最終更新
|
ヘルプ
|
ログイン
]
開始行:
&tag(Hugo);
*目次 [#pa2e5701]
#contents
*関連ページ [#b5123a9d]
-[[./テーマ作成]]
-[[./hugo-icarus-theme]]
-[[./hugo_theme_robust]]
-[[./ananke]]
-[[./WordPressからの移行]]
-[[./NetlifyとGitHub]]
-[[./サイトマップ作成]]
*参考情報 [#f1658a3f]
-Goで作られた静的サイトジェネレーター。
*インストール [#se70d986]
-MacPortsの場合以下の方法でインストール。テーマによってsa...
sudo port install hugo +extended
*基本的な使用方法 [#f816055a]
-[[HUGOで静的サイトを作成してみた - Qiita:https://qiita.c...
-サイトの作成(demoというサイトが作られる)
hugo new site demo
-テーマの追加。
cd demo
git init
# anankeの場合
git submodule add https://github.com/budparr/gohugo-them...
# robustの場合
git submodule add https://github.com/dim0627/hugo_theme_...
echo 'theme = "ananke"' >> config.toml
-記事の追加。content/post下に記事が作成される。
hugo new post/my-first-post.md
-hugo server
hugo server -D
-記事の公開。[[静的サイトジェネレータ「Hugo」〜公開方法〜...
-hugoコマンドを実行するとpublicディレクトリの下にhtmlが書...
*Tips [#vab57140]
**Hugoの記法 [#a418093a]
-基本Markdownで書く。
-Hugo v0.60以上だとhtml直書きは認識しないが、config.toml...
#pre{{
[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
}}
**サブディレクトリで公開 [#yf5d9a07]
-とりあえず以下のようにすれば良い？
#pre{{
baseurl="http://localhost/hugo"
RelativeURLs=true
CanonifyURLs=true
}}
**カテゴリ [#pf3eb137]
-Hugoの場合カテゴリはタグと同じような感じ。セクションを使...
-[[Hugoのテーマを自作してみる 階層化したカテゴリーの実装 ...
-[[Hugo の カテゴリー(categories) を 階層化 する | のい太...
」を使って階層化する方法。
-フォルダ階層をメニューとして表示する。
--[[Content Sections | Hugo:https://gohugo.io/content-man...
--[[パンくずリストを表示するには - bnote:https://www.bnot...
**コンテンツ管理 [#h0e08af0]
-ディレクトリを「001-about」(/about)「002-home」(/home)の...
-対して記事に「url」を指定してパーマリンクを設定すると、...
-結局about、homeのようなディレクトリを設定し、weightを設...
**ツリー構造 [#d7068a91]
-[[サイト内の全ページの一覧をセクションの階層構造に従って...
**サイト変数 [#mec1c014]
-[[Hugo Custom Page And Site Variable | Lua Software Code...
-config.tomlで独自トップレベル変数は定義できない(googleAn...
-自分のパラメーターはparamsに。
-params内部の変数は小文字で定義。アクセスも.Site.Params.f...
-大文字小文字のあたりはややこしい。[[Avoid string variabl...
-typeってなに？
-デフォルトで最初のフォルダ？contents/posts/aa.mdの場合po...
**シンタックスハイライト [#t07af8f5]
-[[Syntax Highlighting | Hugo:https://gohugo.io/content-m...
-hugo 0.60以降ではデフォルトでシンタックスハイライトが使...
-例えばgo言語のシンタックスハイライトを有効にする場合。
#pre{{
```go
// ... code
```
}}
-単なるpreも以下のように呼び出した方がスタイルが揃う。
#pre{{
```
pre
```
}}
-config.tomlの設定。必要ならば値を書き換えることもできる。
#pre{{
[markup]
[markup.highlight]
codeFences = true
guessSyntax = false
hl_Lines = ""
lineNoStart = 1
lineNos = false
lineNumbersInTable = true
noClasses = true
style = "monokai"
tabWidth = 4
}}
*テーマ [#u4bc98b0]
**おすすめテーマ [#ue72d018]
-Clean White: [[ブログ移行日記(その1) - Hugoとテーマ-@joh...
-Bilberry Hugo Theme: [[ブログをHugoに移行しました | 研究...
-Icarus / Tranquilpeak / Robust: [[Hugoのオススメ３テーマ...
-Mainroad: [[静的サイトジェネレーターのHugoでブログはじめ...
-Hugo Future Imperfect
--[[Hugoの公式にある興味のあるテーマを紹介 - EisKern Tech...
--[[List - SIerがいろいろ試してみるブログ:https://itsys-t...
-[[Liva Hugo | Hugo Themes:https://themes.gohugo.io/theme...
-[[Bootstrap Blog Theme | Hugo Themes:https://themes.gohu...
-Docsy
--Googleが作成したテーマ。
**テーマのカスタマイズ [#r6802bd9]
-[[Hugoでテーマをカスタマイズする方法:https://ja.takp.me/...
-layouts以下にテーマと同じファイルを階層構造で作成する。
***ページリソースをサムネイルとして使用したい。 [#s43f16e6]
-たとえばフロントマターでthumbnailをページリソースとして...
{{ if .Params.thumbnail }}
{{ $image := .Resources.GetMatch .Params.thumbnail }}
<div class="thumb" style="background-image: url('{{ $im...
{{ else }}
<div class="thumb"></div>
{{ end }}
** hugo_theme_robustの使用 [#iacd67df]
***参考情報 [#m6ecae83]
-[[Hugoのテーマ、Robustを採用・カスタマイズ - なるほどわ...
-[[HUGO のテーマ Robust のカスタマイズ - zzzmisa's blog:h...
-[[Alice in the Machine - wiki:https://wiki.browniealice....
-[[blog/using-hugo.md at master · kaitoy/blog:https://git...
*エディタ [#v8fff324]
**Visual Studio Code [#bc4f5f64]
***hugofy [#h215f4f7]
-サーバーの開始と終了だけ使う。
-Command+Shift+Pでコマンドを選ぶ
''トラブルシューティング
-「Default theme not set. Please set one」が発生。「Hugof...
*トラブルシューティング [#q36b255f]
**scssが変換できないとかどうとかのエラー [#mec03aa4]
-scssを扱うためにはextended版が必要？
sudo port install hugo +extended
**Error: add site dependencies: load resources: loading t...
-hugo server -Dでエラー。
-layoutフォルダ内にEmacsのロックファイルが残っていたのが...
-ドットから始まるファイルがないか確認する。
** found no layout file for "HTML" for kind "page" [#g20b...
-hugo server -Dを実行すると以下の警告メッセージが表示され...
-「 found no layout file for "HTML" for kind "page": You ...
-原因はテーマを指定していないこと。
-config.tomlで指定。
theme = "mytheme"
**public以下にファイルが書き出されない [#v8f4c250]
-コンテンツがdraftになっていないか確認。
-「hugo server -D」で確認していて「hugo」でコンパイルする...
**情報が反映されない？ [#xe99e1b5]
-[[Hugo サーバーで記事の変更内容が反映されない場合 | まく...
-キャッシュが原因？
$ hugo server --ignoreCache
-階層構造がおかしかったのもこれが原因か。
**新規追加したエントリーが表示されない [#laf93edf]
-Hugoは標準で未来の日付のエントリーが表示されないようにな...
-これを変更するには「buildFuture = true」をconfig.tomlに...
-Front Matterのdateで「2021-11-26T14:24:32+00:00」のよう...
終了行:
&tag(Hugo);
*目次 [#pa2e5701]
#contents
*関連ページ [#b5123a9d]
-[[./テーマ作成]]
-[[./hugo-icarus-theme]]
-[[./hugo_theme_robust]]
-[[./ananke]]
-[[./WordPressからの移行]]
-[[./NetlifyとGitHub]]
-[[./サイトマップ作成]]
*参考情報 [#f1658a3f]
-Goで作られた静的サイトジェネレーター。
*インストール [#se70d986]
-MacPortsの場合以下の方法でインストール。テーマによってsa...
sudo port install hugo +extended
*基本的な使用方法 [#f816055a]
-[[HUGOで静的サイトを作成してみた - Qiita:https://qiita.c...
-サイトの作成(demoというサイトが作られる)
hugo new site demo
-テーマの追加。
cd demo
git init
# anankeの場合
git submodule add https://github.com/budparr/gohugo-them...
# robustの場合
git submodule add https://github.com/dim0627/hugo_theme_...
echo 'theme = "ananke"' >> config.toml
-記事の追加。content/post下に記事が作成される。
hugo new post/my-first-post.md
-hugo server
hugo server -D
-記事の公開。[[静的サイトジェネレータ「Hugo」〜公開方法〜...
-hugoコマンドを実行するとpublicディレクトリの下にhtmlが書...
*Tips [#vab57140]
**Hugoの記法 [#a418093a]
-基本Markdownで書く。
-Hugo v0.60以上だとhtml直書きは認識しないが、config.toml...
#pre{{
[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
}}
**サブディレクトリで公開 [#yf5d9a07]
-とりあえず以下のようにすれば良い？
#pre{{
baseurl="http://localhost/hugo"
RelativeURLs=true
CanonifyURLs=true
}}
**カテゴリ [#pf3eb137]
-Hugoの場合カテゴリはタグと同じような感じ。セクションを使...
-[[Hugoのテーマを自作してみる 階層化したカテゴリーの実装 ...
-[[Hugo の カテゴリー(categories) を 階層化 する | のい太...
」を使って階層化する方法。
-フォルダ階層をメニューとして表示する。
--[[Content Sections | Hugo:https://gohugo.io/content-man...
--[[パンくずリストを表示するには - bnote:https://www.bnot...
**コンテンツ管理 [#h0e08af0]
-ディレクトリを「001-about」(/about)「002-home」(/home)の...
-対して記事に「url」を指定してパーマリンクを設定すると、...
-結局about、homeのようなディレクトリを設定し、weightを設...
**ツリー構造 [#d7068a91]
-[[サイト内の全ページの一覧をセクションの階層構造に従って...
**サイト変数 [#mec1c014]
-[[Hugo Custom Page And Site Variable | Lua Software Code...
-config.tomlで独自トップレベル変数は定義できない(googleAn...
-自分のパラメーターはparamsに。
-params内部の変数は小文字で定義。アクセスも.Site.Params.f...
-大文字小文字のあたりはややこしい。[[Avoid string variabl...
-typeってなに？
-デフォルトで最初のフォルダ？contents/posts/aa.mdの場合po...
**シンタックスハイライト [#t07af8f5]
-[[Syntax Highlighting | Hugo:https://gohugo.io/content-m...
-hugo 0.60以降ではデフォルトでシンタックスハイライトが使...
-例えばgo言語のシンタックスハイライトを有効にする場合。
#pre{{
```go
// ... code
```
}}
-単なるpreも以下のように呼び出した方がスタイルが揃う。
#pre{{
```
pre
```
}}
-config.tomlの設定。必要ならば値を書き換えることもできる。
#pre{{
[markup]
[markup.highlight]
codeFences = true
guessSyntax = false
hl_Lines = ""
lineNoStart = 1
lineNos = false
lineNumbersInTable = true
noClasses = true
style = "monokai"
tabWidth = 4
}}
*テーマ [#u4bc98b0]
**おすすめテーマ [#ue72d018]
-Clean White: [[ブログ移行日記(その1) - Hugoとテーマ-@joh...
-Bilberry Hugo Theme: [[ブログをHugoに移行しました | 研究...
-Icarus / Tranquilpeak / Robust: [[Hugoのオススメ３テーマ...
-Mainroad: [[静的サイトジェネレーターのHugoでブログはじめ...
-Hugo Future Imperfect
--[[Hugoの公式にある興味のあるテーマを紹介 - EisKern Tech...
--[[List - SIerがいろいろ試してみるブログ:https://itsys-t...
-[[Liva Hugo | Hugo Themes:https://themes.gohugo.io/theme...
-[[Bootstrap Blog Theme | Hugo Themes:https://themes.gohu...
-Docsy
--Googleが作成したテーマ。
**テーマのカスタマイズ [#r6802bd9]
-[[Hugoでテーマをカスタマイズする方法:https://ja.takp.me/...
-layouts以下にテーマと同じファイルを階層構造で作成する。
***ページリソースをサムネイルとして使用したい。 [#s43f16e6]
-たとえばフロントマターでthumbnailをページリソースとして...
{{ if .Params.thumbnail }}
{{ $image := .Resources.GetMatch .Params.thumbnail }}
<div class="thumb" style="background-image: url('{{ $im...
{{ else }}
<div class="thumb"></div>
{{ end }}
** hugo_theme_robustの使用 [#iacd67df]
***参考情報 [#m6ecae83]
-[[Hugoのテーマ、Robustを採用・カスタマイズ - なるほどわ...
-[[HUGO のテーマ Robust のカスタマイズ - zzzmisa's blog:h...
-[[Alice in the Machine - wiki:https://wiki.browniealice....
-[[blog/using-hugo.md at master · kaitoy/blog:https://git...
*エディタ [#v8fff324]
**Visual Studio Code [#bc4f5f64]
***hugofy [#h215f4f7]
-サーバーの開始と終了だけ使う。
-Command+Shift+Pでコマンドを選ぶ
''トラブルシューティング
-「Default theme not set. Please set one」が発生。「Hugof...
*トラブルシューティング [#q36b255f]
**scssが変換できないとかどうとかのエラー [#mec03aa4]
-scssを扱うためにはextended版が必要？
sudo port install hugo +extended
**Error: add site dependencies: load resources: loading t...
-hugo server -Dでエラー。
-layoutフォルダ内にEmacsのロックファイルが残っていたのが...
-ドットから始まるファイルがないか確認する。
** found no layout file for "HTML" for kind "page" [#g20b...
-hugo server -Dを実行すると以下の警告メッセージが表示され...
-「 found no layout file for "HTML" for kind "page": You ...
-原因はテーマを指定していないこと。
-config.tomlで指定。
theme = "mytheme"
**public以下にファイルが書き出されない [#v8f4c250]
-コンテンツがdraftになっていないか確認。
-「hugo server -D」で確認していて「hugo」でコンパイルする...
**情報が反映されない？ [#xe99e1b5]
-[[Hugo サーバーで記事の変更内容が反映されない場合 | まく...
-キャッシュが原因？
$ hugo server --ignoreCache
-階層構造がおかしかったのもこれが原因か。
**新規追加したエントリーが表示されない [#laf93edf]
-Hugoは標準で未来の日付のエントリーが表示されないようにな...
-これを変更するには「buildFuture = true」をconfig.tomlに...
-Front Matterのdateで「2021-11-26T14:24:32+00:00」のよう...
ページ名:
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
