Nagoya (名古屋なごや) は、静的せいてきサイトジェネレーター Hugo 用ようの日本語にほんごブログテーマです。 日本語にほんごのユーザーに最適さいてきになるよう設計せっけいされています。

デモサイト: https://curegit.github.io/nagoya-example/

デモサイトのソース: https://github.com/curegit/nagoya-example

• レスポンシブデザイン
• サムネイル画像がぞうの表示ひょうじ
• ディレクトリツリーによる整理せいり
• テキストマッチングによる記事きじの簡易かんい全文ぜんぶん検索けんさく
• 数式すうしきレンダリング (KaTeX)
• ダイアグラム表示ひょうじ (Mermaid)
• パンくずリスト
• Open Graph Protocol
• 構造こうぞう化かデータマークアップ (microdata)

• i18n（国際こくさい化か対応たいおう）

  このテーマは Monolingual project のみ対応たいおうします。

• ソーシャルメディアのリンク表示ひょうじ

Git submodule による導入どうにゅうを推奨すいしょうします。

git submodule add --name nagoya https://github.com/curegit/nagoya.git themes/nagoya

SCSS 拡張かくちょう (Hugo extended edition) は不要ふようです。

Hugo のページバンドルによるコンテンツ整理せいりに従したがっており、任意にんいの深ふかさのセクションツリーを作成さくせいできます。 このテーマでは、リーフバンドルを通常つうじょうの記事きじとして扱あつかいます。

Hugo 自体じたいの挙動きょどうに似にせており、フロントマターの images の値ねがあればそれをサムネイルとして使用しようします。 それがない場合ばあいは、バンドル内ないでファイル名めいに feature, cover, thumbnail が含ふくまれる画像がぞうがサムネイルとして使つかわれます。

このテーマでは tag と archive と search が特別とくべつ扱あつかいされます。

これらを有効ゆうこう化かする場合ばあい、tag, search, archive の複数ふくすう形がたは、それぞれ tags, search, archives と設定せっていされる必要ひつようがあります。

• tag はサイドバーなどに独自どくじのアイコン付つきで表示ひょうじされます
• 各かく記事きじのメタタグのキーワードは設定せっていされた tag を基もとに自動的じどうてきに設定せっていされます
• archive を有効ゆうこう化かすると、年別ねんべつにグループ化かされた全ぜん記事きじ一覧いちらんページが生成せいせいされます
• archive の年としの値ねは date 属性ぞくせいから自動じどうで計算けいさんされるため、各かく記事きじで archives パラメータを設定せっていする必要ひつようはありません
• search を有効ゆうこう化かすると、テキストマッチングによる記事きじの簡易かんい全文ぜんぶん検索けんさく機能きのう (Web Worker を使用しよう) が利用りようできます
• search と archive は、独自どくじに動的どうてきなタームページを提供ていきょうするので、各かく記事きじでのタームパラメータの設定せっていは無効むこうです
• search と archive は、リーフバンドルのみを対象たいしょうとし、さらに固定こていページは除外じょがいされます

なお、Taxonomy 表示ひょうじを日本語にほんご化かするためには、該当がいとうするセクション（archives や categories）に _index.md ファイルを作成さくせいし、その中なかで title パラメータを設定せっていしてください。

[taxonomies]
  category = "categories"
  tag = "tags"
  archive = "archives"
  search = "search"

---
title: カテゴリ
---

Hugo の Menu Templates 機能きのうには対応たいおうしていません。 /layouts/partials/widgets/ 内うちにある、配置はいちしたい該当がいとう場所ばしょ部分ぶぶんのパーシャルレイアウトをオーバーライドしてメニューを作成さくせいします。

/layouts/partials/widgets/ 内うちのオーバーライドは、カスタムウィジェットの作成さくせいにも利用りようできます。

以下いかは、hugo.toml に設定せっていできるサイト全体ぜんたいに効果こうかがある params です。

フロントマターの params に設定せっていできるものとして以下いかがあります。

コンテンツ内ないで使用しようできるスタイリング用ようユーティリティがいくつかあります。

• CDN 経由けいゆで読よみ込こまれるリソース (KaTeX, Mermaid) を事前じぜんバンドルする場合ばあいは、リソースをダウンロードして配置はいちし、読よみ込こみ部分ぶぶんのパーシャルレイアウトを上書うわがきしてください。
• トップページ内容ないようの始はじまり部分ぶぶんは、コンテンツルートの _index.md で制御せいぎょできます。 タイトルを空そらにすることもできます。
• Hugo サイト設定せっていの disableKinds において、テーマ設計せっけいと整合せいごう的てきに無効むこう化かできるものは 404, robotstxt, rss に限かぎります。

MIT