dbrun/blowfish
1
0
Fork 0
mirror of https://github.com/nunocoracao/blowfish.git synced 2026-01-30 15:31:52 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
cee01113cd9e867dff7b92cf255182261d930658
blowfish/exampleSite/content/docs/configuration/index.ja.md
T
Served Smart dc36597427 🔒 Add config parameter fingerprintAlgorithm 
This parameter allows users to choose their algorithm for html integrity checks. This mainly affects Hugo's fingerprint
2025-06-03 11:53:03 +02:00

379 lines
47 KiB
Markdown
Raw Blame History

---
title: "蚭定"
weight: 4
draft: false
description: "Blowfish で䜿えるすべおの蚭定倉数"
slug: "configuration"
tags: ["config", "docs"]
series: ["Documentation"]
series_order: 4
---
Blowfish は高床にカスタマむズ可胜なテヌマであり、最新の Hugo 機胜を䜿甚しお蚭定方法をシンプルにしおいたす。
このテヌマには、基本的なブログたたは静的サむトをすぐに立ち䞊げお実行できるデフォルト蚭定が付属しおいたす。
{{< alert "fire" >}}
Blowfish を簡単に䜿い始められるように、新しい CLI ツヌルをリリヌスしたした。むンストヌルず蚭定に圹立ちたす。 グロヌバルに CLI ツヌルをむンストヌルするには、以䞋を䜿甚したす。
```bash
npx blowfish-tools
```
{{< /alert >}}
> テヌマにバンドルされおいる蚭定ファむルは、デフォルトの Hugo 構文である TOML 圢匏で提䟛されおいたす。必芁に応じお、蚭定を YAML たたは JSON に倉換できたす。
デフォルトのテヌマ蚭定は各ファむルに蚘茉されおいるため、必芁に応じお蚭定を自由に調敎できたす。
{{< alert >}}
[むンストヌル手順]({{< ref "/docs/installation#set-up-theme-configuration-files" >}})で抂説されおいるように、Hugo プロゞェクトの `config/_default/` フォルダ内のファむルを修正し、プロゞェクトルヌトの `config.toml` ファむルを削陀するこずで、テヌマ蚭定を調敎する必芁がありたす。
{{< /alert >}}
## サむト蚭定
テヌマ党䜓で暙準の Hugo 蚭定倉数が適甚されたすが、最適な゚クスペリ゚ンスを埗るために蚭定する必芁がある特定の事項がありたす。
サむト蚭定は `config/_default/config.toml` ファむルで管理されたす。 䞋の衚は、Blowfish が掻甚するすべおの蚭定の抂芁を瀺しおいたす。
この衚で提䟛されおいる倉数名は、TOML デヌタ構造を簡玠化するためにドット衚蚘を䜿甚しおいるこずに泚意しおください぀たり、 `outputs.home` は `[outputs] home` を指したす。
<!-- prettier-ignore-start -->
| 名前 | デフォルト | 説明 |
|---|---|---|
| `theme` | `"blowfish"` | Hugo Modules を䜿甚しおいる堎合は、この蚭定倀を削陀する必芁がありたす。 他のすべおのむンストヌルタむプでは、テヌマが機胜するためにこれを `blowfish` に蚭定する必芁がありたす。 |
| `baseURL` | _未蚭定_ | りェブサむトのルヌトぞの URL です。 |
| `defaultContentLanguage` | `"en"` | この倀は、テヌマコンポヌネントずコンテンツのデフォルト蚀語を決定したす。 サポヌトされおいる蚀語コヌドに぀いおは、以䞋の[蚀語ず i18n](#蚀語ず-i18n) セクションを参照しおください。 |
| `enableRobotsTXT` | `true` | 有効にするず、怜玢゚ンゞンがサむト党䜓をクロヌルできるようにする `robots.txt` ファむルがサむトルヌトに䜜成されたす。 あらかじめ䜜成した独自の `robots.txt` を提䟛する堎合は、`false` に蚭定し、ファむルを `static` ディレクトリに配眮したす。 完党に制埡するには、このファむルを生成するための[カスタムレむアりト]({{< ref "content-examples#カスタムレむアりト" >}})を提䟛できたす。 |
| `pagination.pagerSize` | `10` | 蚘事リストの各ペヌゞにリストされる蚘事の数です。 |
| `summaryLength` | `0` | [フロントマタヌ]({{< ref "front-matter" >}})で提䟛されおいない堎合に、蚘事の抂芁を生成するために䜿甚される単語の数です。 倀 `0` は最初の文を䜿甚したす。 抂芁が非衚瀺になっおいる堎合、この倀は効果がありたせん。 |
| `outputs.home` | `["HTML", "RSS", "JSON"]` | サむト甚に生成される出力圢匏です。 Blowfish では、すべおのテヌマコンポヌネントが正しく機胜するために HTML、RSS、JSON が必芁です。 |
| `permalinks` | _未蚭定_ | パヌマリンクの蚭定に぀いおは、[Hugo ドキュメント](https://gohugo.io/content-management/urls/#permalinks)を参照しおください。 |
| `taxonomies` | _未蚭定_ | 分類の蚭定に぀いおは、[コンテンツの敎理]({{< ref "getting-started#コンテンツの敎理" >}})セクションを参照しおください。 |
<!-- prettier-ignore-end -->
## サムネむル
Blowfish は、蚘事に芖芚的なサポヌトを簡単に远加できるように構築されおいたす。Hugo の蚘事構造に慣れおいる堎合は、蚘事フォルダ内に `feature*` で始たる画像ファむルほずんどすべおの圢匏がサポヌトされおいたすが、`.png` たたは `.jpg` をお勧めしたすを配眮するだけです。これで、Blowfish はサむト内でサムネむルずしお画像を䜿甚したり、゜ヌシャルプラットフォヌム党䜓で <a target="_blank" href="https://oembed.com/">oEmbed</a> カヌドに䜿甚したりできたす。
[こちら]({{< ref "thumbnails" >}})には、より詳现な情報ず、どのように蚭定できるかを確認したい堎合の[サンプル]({{< ref "thumbnail_sample" >}})を含むガむドもありたす。
## 蚀語ず i18n
Blowfish は倚蚀語りェブサむト向けに最適化されおおり、テヌマアセットはすぐに䜿えるように耇数の蚀語に翻蚳されおいたす。 蚀語蚭定を䜿甚するず、コンテンツの耇数のバヌゞョンを生成しお、蚪問者に母囜語でカスタマむズされた゚クスペリ゚ンスを提䟛できたす。
このテヌマは珟圚、デフォルトで次の蚀語をサポヌトしおいたす:
| 蚀語 | コヌド |
|---|---|
| アラビア語 | `ar` |
| ブルガリア語 | `bg` |
| ベンガル語 | `bn` |
| カタロニア語 | `ca` |
| チェコ語 | `cs` |
| ドむツ語 | `de` |
| 英語 | `en` |
| ゚スペラント語 | `eo` |
| スペむン語スペむン | `es` |
| フィンランド語 | `fi` |
| フランス語 | `fr` |
| ヘブラむ語 | `he` |
| クロアチア語 | `hr` |
| ハンガリヌ語 | `hu` |
| むンドネシア語 | `id` |
| むタリア語 | `it` |
| 日本語 | `ja` |
| 韓囜語 | `ko` |
| オランダ語 | `nl` |
| ポヌランド語 | `pl` |
| ポルトガル語ブラゞル | `pt-br` |
| ポルトガル語ポルトガル | `pt-pt` |
| ルヌマニア語 | `ro` |
| ロシア語 | `ru` |
| トルコ語 | `tr` |
| ベトナム語 | `vi` |
| 䞭囜語簡䜓字 | `zh-cn` |
| 䞭囜語繁䜓字 | `zh-tw` |
デフォルトの翻蚳は、翻蚳文字列を含むカスタムファむル `i18n/[蚀語コヌド].yaml` を䜜成するこずでオヌバヌラむドできたす。 この方法を䜿甚しお新しい蚀語を远加するこずもできたす。 新しい翻蚳をコミュニティず共有したい堎合は、[プルリク゚ストを開いお](https://github.com/nunocoracao/blowfish/pulls)ください。
### 蚭定
可胜な限り柔軟に察応するために、りェブサむトの各蚀語の蚀語蚭定ファむルを䜜成する必芁がありたす。デフォルトでは、Blowfish には `config/_default/languages.en.toml` に英語の蚀語蚭定が含たれおいたす。
デフォルトのファむルは、远加の蚀語を䜜成するためのテンプレヌトずしお䜿甚するこずも、英語以倖の蚀語でりェブサむトを䜜成する堎合は名前を倉曎するこずもできたす。`languages.[蚀語コヌド].toml` 圢匏を䜿甚しおファむルに名前を付けるだけです。
{{< alert >}}
**泚:** [サむト蚭定](#サむト蚭定)の `defaultContentLanguage` パラメヌタが、蚀語蚭定ファむル名の蚀語コヌドず䞀臎しおいるこずを確認しおください。
{{< /alert >}}
#### グロヌバル
<!-- prettier-ignore-start -->
| 名前 | デフォルト | 説明 |
|---|---|---|
| `languageCode` | `"en"` | このファむルの Hugo 蚀語コヌドです。トップレベル蚀語䟋 `en`たたはサブバリアント䟋 `en-au`にするこずができ、ファむル名の蚀語コヌドず䞀臎する必芁がありたす。Hugo はこの倀が垞に小文字であるこずを想定しおいたす。適切な HTML 準拠のために、倧文字ず小文字を区別する `isoCode` パラメヌタを蚭定したす。 |
| `languageName` | `"English"` | 蚀語の名前です。 |
| `weight` | `1` | 重みは、倚蚀語サむトを構築するずきの蚀語の順序を決定したす。 |
| `title` | `"Blowfish"` | りェブサむトのタむトルです。これは、サむトのヘッダヌずフッタヌに衚瀺されたす。 |
<!-- prettier-ignore-end -->
#### パラメヌタヌ
<!-- prettier-ignore-start -->
| 名前 | デフォルト | 説明 |
|---|---|---|
| `params.displayName` | `"EN"` | りェブサむトに蚀語が衚瀺されるずきに䜿甚される名前です。 |
| `params.isoCode` | `"en"` | HTML メタデヌタ甚の ISO 蚀語コヌドです。トップレベル蚀語䟋 `en`たたはサブバリアント䟋 `en-AU`にするこずができたす。 |
| `params.rtl` | `false` | これが RTL 蚀語かどうかです。`true` に蚭定するず、コンテンツが右から巊に䞊べ替えられたす。 Blowfish は RTL 蚀語ず LTR 蚀語の同時䜿甚を完党にサポヌトしおおり、䞡方に動的に調敎されたす。 |
| `params.dateFormat` | `"2 January 2006"` | この蚀語での日付のフォヌマット方法です。䜿甚できる圢匏に぀いおは、[Hugo ドキュメント](https://gohugo.io/functions/format/#gos-layout-string)を参照しおください。 |
| `params.logo` | _未蚭定_ | `assets/` フォルダ内のサむトロゎファむルぞの盞察パスです。ロゎファむルは2倍の解像床で提䟛する必芁があり、あらゆる画像サむズをサポヌトしおいたす。 |
| `params.secondaryLogo` | _未蚭定_ | `assets/` フォルダ内のセカンダリサむトロゎファむルぞの盞察パスです。 ロゎファむルは2倍の解像床で提䟛する必芁があり、あらゆる画像サむズをサポヌトしおいたす。 これは、`logo` ずは反転/察照的なカラヌスキヌムである必芁がありたす。蚭定されおいる堎合、このロゎは、ナヌザヌが `defaultAppearance` モヌドから切り替えたずきに衚瀺されたす。 |
| `params.description` | _未蚭定_ | りェブサむトの説明です。これはサむトのメタデヌタで䜿甚されたす。 |
| `params.copyright` | _未蚭定_ | サむトフッタヌの著䜜暩メッセヌゞの Markdown 文字列には、プレヌスホルダ { year } を含めお珟圚の幎を動的に挿入できたす。指定されおいない堎合、Blowfish はサむト `title` を䜿甚しお著䜜暩文字列を自動的に生成したす。 |
<!-- prettier-ignore-end -->
#### 著者(Author)
<!-- prettier-ignore-start -->
| 名前 | デフォルト　　　 | 説明 |
|---|---|---|
| `author.name` | _未蚭定_ | 著者の名前です。これは、蚘事のフッタヌず、プロフィヌルレむアりトが䜿甚されおいる堎合はホヌムペヌゞに衚瀺されたす。 |
| `author.image` | _未蚭定_ | 著者の画像ファむルぞのパスです。画像は瞊暪比 1:1 である必芁がありたす。画像は、サむトの `assets/` フォルダに配眮するこずも、倖郚 URL にするこずもできたす。 |
| `author.headline` | _未蚭定_ | 著者の芋出しを含む Markdown 文字列です。プロフィヌルホヌムペヌゞの著者の名前に䞋に衚瀺されたす。 |
| `author.bio` | _未蚭定_ | 著者の略歎を含む Markdown 文字列です。蚘事のフッタヌに衚瀺されたす。 |
| `author.links` | _未蚭定_ | 著者の詳现ず䞀緒に衚瀺するリンクです。蚭定ファむルには、コメントを倖すだけで有効になるリンクの䟋が含たれおいたす。リンクが衚瀺される順序は、配列に衚瀺される順序によっお決たりたす。`assets/icons/` に察応する SVG アむコンアセットを提䟛するこずで、カスタムリンクを远加できたす。 |
<!-- prettier-ignore-end -->
### メニュヌ(Menus)
Blowfish は、蚀語固有のメニュヌ蚭定もサポヌトしおいたす。メニュヌ蚭定ファむルは、蚀語ファむルず同じ呜名圢匏に埓いたす。ファむル名に蚀語コヌドを指定するだけで、Hugo はファむルがどの蚀語に関連しおいるかを認識したす。
メニュヌ蚭定ファむルの名前は、 `menus.[language-code].toml` 圢匏です。メニュヌ蚭定で䜿甚される蚀語コヌドが蚀語蚭定ず䞀臎しおいるこずを垞に確認しおください。
[はじめに]({{< ref "getting-started#menus" >}})セクションでは、このファむルの構造に぀いお詳しく説明しおいたす。詳现な蚭定䟋に぀いおは、[Hugo メニュヌ ドキュメント](https://gohugo.io/content-management/menus/)も参照できたす。
## テヌマパラメヌタヌ(Theme parameters)
Blowfish は、テヌマの機胜を制埡する倚数の蚭定パラメヌタを提䟛したす。䞋の衚は、`config/_default/params.toml` ファむルで䜿甚可胜なすべおのパラメヌタの抂芁を瀺しおいたす。
ここにある蚘事のデフォルトの倚くは、フロントマタヌで指定するこずで、蚘事ごずにオヌバヌラむドできたす。詳现に぀いおは、[フロントマタヌ]({{< ref "front-matter" >}})セクションを参照しおください。
<!-- prettier-ignore-start -->
### グロヌバル
| 名前 | デフォルト | 説明 |
|---|---|---|
| `colorScheme` | `"blowfish"` | 䜿甚するテヌマのカラヌスキヌムです。有効な倀は、`blowfish`デフォルト、`avocado`、`fire`、`ocean`、`forest`、`princess`、`neon`、`bloody`、`terminal`、`marvel`、`noir`、`autumn`、`congo`、`slate` です。詳现に぀いおは、[カラヌスキヌム]({{< ref "getting-started#カラヌスキヌム" >}})セクションを参照しおください。 |
| `defaultAppearance` | `"light"` | デフォルトのテヌマの倖芳です。`light` たたは `dark` のいずれかです。 |
| `autoSwitchAppearance` | `true` | 蚪問者のオペレヌティングシステムの蚭定に基づいおテヌマの倖芳を自動的に切り替えるかどうかです。`false` に蚭定するず、サむトは垞に `defaultAppearance` を䜿甚したす。 |
| `enableSearch` | `false` | サむト内怜玢が有効かどうかです。`true` に蚭定するず、怜玢機胜が有効になりたす。怜玢機胜は、[サむト蚭定](#サむト蚭定)の `outputs.home` 蚭定が正しく蚭定されおいるかどうかに䟝存するこずに泚意しおください。 |
| `enableCodeCopy` | `false` | `<code>` ブロックのクリップボヌドぞのコピヌボタンを有効にするかどうかです。コヌドコピヌが正しく機胜するには、`highlight.noClasses` パラメヌタを `false` に蚭定する必芁がありたす。以䞋の[その他の蚭定ファむル](#その他の蚭定ファむル)に぀いお読んでください。 |
| `mainSections` | _未蚭定_ | 最近の蚘事リストに衚瀺するセクションです。指定しない堎合は、蚘事数が最も倚いセクションが䜿甚されたす。 |
| `showViews` | _未蚭定_ | 蚘事ずリストの衚瀺回数を衚瀺するかどうかです。これには Firebase 統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `showLikes` | _未蚭定_ | 蚘事ずリストのいいねを衚瀺するかどうかです。これには Firebase 統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `robots` | _未蚭定_ | ロボットがサむトをどのように凊理するかを瀺す文字列です。蚭定されおいる堎合、ペヌゞヘッダヌに出力されたす。有効な倀に぀いおは、[Google のドキュメント](https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives)を参照しおください。 |
| `disableImageZoom` | `false` | サむト内のすべおの画像の画像ズヌム機胜を無効にしたす。 |
| `disableImageOptimization` | `false` | サむト内のすべおの画像の画像サむズ倉曎ず最適化機胜を無効にしたす。Markdown 蚘法䟋`![](image.jpg)`の画像は察象倖です。 |
| `disableImageOptimizationMD` | `false` | Markdown 蚘法䟋`![](image.jpg)`の画像の画像サむズ倉曎ず最適化機胜のみを無効にしたす。他の画像には適甚されたす。 |
| `disableTextInHeader` | `false` | ヘッダヌのテキストを無効にしたす。ロゎベヌスのヘッダヌに圹立ちたす。 |
| `defaultBackgroundImage` | _未蚭定_ | `background` ホヌムペヌゞレむアりトず `background` ヒヌロヌスタむルの䞡方のデフォルトの背景画像です。 |
| `defaultFeaturedImage` | _未蚭定_ | 蚘事党䜓のすべおの `featured` 画像のデフォルトの背景画像です。ロヌカルの `featured` 画像によっおオヌバヌラむドされたす。 |
| `defaultSocialImage` | _未蚭定_ | ゜ヌシャルメディア共有Open Graph ず Twitter甚のデフォルト画像。ロヌカルの `featured` 画像によっおオヌバヌラむドされたす。 |
| `highlightCurrentMenuArea` | _未蚭定_ | メむンメニュヌのメニュヌ項目が遞択されおいるずきにマヌクを付けたす。 |
| `smartTOC` | _未蚭定_ | スマヌト目次をアクティブにしたす。衚瀺されおいる項目が匷調衚瀺されたす。 |
| `smartTOCHideUnfocusedChildren` | _未蚭定_ | スマヌト目次がオンになっおいる堎合、フォヌカスされおいないずきに、テヌブルのより深いレベルが非衚瀺になりたす。 |
| `fingerprintAlgorithm` | `"sha512"` | This configures the fingerprint or resources.Fingerprint used in .Data.Integrity for files provided by the theme. Valid values are `sha512` (default), `sha384`, `sha256` |
### ヘッダヌ(Header)
| 名前 | デフォルト | 説明 |
|---|---|---|
| `header.layout` | `"basic"` | サむト党䜓のヘッダヌを定矩したす。サポヌトされおいる倀は、`basic`、`fixed`、`fixed-fill`、`fixed-fill-blur` です。 |
### フッタヌ(Footer)
| 名前 | デフォルト　　　 | 説明 |
|---|---|---|
| `footer.showMenu` | `true` | フッタヌメニュヌを衚瀺/非衚瀺にしたす。これは、`config/_default/menus.en.toml` ファむルの `[[footer]]` セクションで蚭定できたす。 |
| `footer.showCopyright` | `true` | サむトのフッタヌに著䜜暩文字列を衚瀺するかどうかです。文字列自䜓は、[蚀語蚭定](#蚀語ず-i18n) の `copyright` パラメヌタを䜿甚しおカスタマむズできるこずに泚意しおください。 |
| `footer.showThemeAttribution` | `true` | サむトのフッタヌに「powered by」ずいうテヌマの垰属を衚瀺するかどうかです。このメッセヌゞを無効にする堎合は、サむトの他の堎所たずえば、about ペヌゞでテヌマの垰属を怜蚎しおください。 |
| `footer.showAppearanceSwitcher` | `false` | サむトのフッタヌに倖芳スむッチャヌを衚瀺するかどうかです。 ブラりザのロヌカルストレヌゞを䜿甚しお、蚪問者の蚭定が保持されたす。 |
| `footer.showScrollToTop` | `true` | `true` に蚭定するず、トップぞスクロヌルの矢印が衚瀺されたす。 |
### ホヌムペヌゞ(Homepage)
| 名前 | デフォルト | 説明 |
|---|---|---|
| `homepage.layout` | `"profile"` | ホヌムペヌゞのレむアりトです。有効な倀は、`page`、`profile`、`hero`、`card`、`background`、`custom` です。`custom` に蚭定した堎合、`/layouts/partials/home/custom.html` ファむルを䜜成しお独自のレむアりトを提䟛する必芁がありたす。詳现に぀いおは、[ホヌムペヌゞレむアりト]({{< ref "homepage-layout" >}}) セクションを参照しおください。 |
| `homepage.homepageImage` | _未蚭定_ | `hero` レむアりトず `card` レむアりトで䜿甚される画像です。アセットディレクトリからのロヌカル画像たたは倖郚画像 URL ずしお蚭定できたす。詳现に぀いおは、[ホヌムペヌゞレむアりト]({{< ref "homepage-layout" >}}) セクションを参照しおください。 |
| `homepage.showRecent` | `false` | ホヌムペヌゞに最近の蚘事リストを衚瀺するかどうかです。 |
| `homepage.showRecentItems` | 5 | showRecent が true の堎合に衚瀺する蚘事の数です。倉数が0に蚭定されおいる堎合、たたは定矩されおいない堎合は、システムはデフォルトで5぀の蚘事に蚭定されたす。 |
| `homepage.showMoreLink` | `false` | ナヌザヌを事前に定矩された堎所に移動する「もっず芋る」リンクを投皿の最埌に衚瀺するかどうかです。 |
| `homepage.showMoreLinkDest` | `/posts` | 「もっず芋る」ボタンの移動先です。 |
| `homepage.cardView` | `false` | 最近の蚘事をカヌドのギャラリヌずしお衚瀺したす。 |
| `homepage.cardViewScreenWidth` | `false` | 最近の蚘事カヌドギャラリヌの幅を拡匵しお、利甚可胜な幅党䜓を䜿甚したす。 |
| `homepage.layoutBackgroundBlur` | `false` | ホヌムペヌゞレむアりトの背景画像をスクロヌルに合わせおがかしたす。 |
| `homepage.disableHeroImageFilter` | `false` | ホヌムペヌゞの背景画像にフィルタヌを適甚するかどうか。 |
### 蚘事(Article)
| 名前 | デフォルト　　　　 | 説明 |
|---|---|---|
| `article.showDate` | `true` | 蚘事の日付を衚瀺するかどうかです。 |
| `article.showViews` | `false` | 蚘事の衚瀺回数を衚瀺するかどうかです。これには Firebase 統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `article.showLikes` | `false` | 蚘事のいいねを衚瀺するかどうかです。これには Firebase 統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `article.showDateOnlyInArticle` | `false` | 蚘事リスト/カヌドに衚瀺されおいない堎合でも、蚘事内に日付を衚瀺したす。 |
| `article.showDateUpdated` | `false` | 蚘事が曎新された日付を衚瀺するかどうかです。 |
| `article.showAuthor` | `true` | 蚘事のフッタヌに著者ボックスを衚瀺するかどうかです。 |
| `article.showAuthorBottom` | `false` | 著者ボックスは、各ペヌゞの䞊郚ではなく䞋郚に衚瀺されたす。 |
| `article.showHero` | `false` | サムネむル画像を各蚘事ペヌゞ内でヒヌロヌ画像ずしお衚瀺するかどうかです。 |
| `article.heroStyle` | _未蚭定_ | ヒヌロヌ画像を衚瀺するスタむルです。有効なオプションは、`basic`、`big`、`background`、`thumbAndBackground` です。 |
| `article.layoutBackgroundBlur` | `true` | 背景蚘事 heroStyle の背景画像をスクロヌルに合わせおがかしたす。 |
| `article.layoutBackgroundHeaderSpace` | `true` | ヘッダヌず本文の間にスペヌスを远加したす。 |
| `article.showBreadcrumbs` | `false` | 蚘事のヘッダヌにパンくずリストを衚瀺するかどうかです。 |
| `article.showDraftLabel` | `true` | サむトが `--buildDrafts` でビルドされたずきに、蚘事の暪にドラフトむンゞケヌタを衚瀺するかどうかです。 |
| `article.showEdit` | `false` | 蚘事コンテンツを線集するためのリンクを衚瀺するかどうかです。 |
| `article.editURL` | _未蚭定_ | `article.showEdit` がアクティブな堎合、線集リンクの URL です。 |
| `article.editAppendPath` | `true` | `article.showEdit` がアクティブな堎合、珟圚の蚘事ぞのパスを `article.editURL` で蚭定された URL に远加するかどうかです。 |
| `article.seriesOpened` | `false` | シリヌズモゞュヌルがデフォルトで開いた状態で衚瀺されるかどうかです。 |
| `article.showHeadingAnchors` | `true` | 蚘事内の芋出しの暪にアンカヌリンク芋出しを衚瀺するかどうかです。 |
| `article.showPagination` | `true` | 蚘事のフッタヌに次/前の蚘事リンクを衚瀺するかどうかです。 |
| `article.invertPagination` | `false` | 次/前の蚘事リンクの方向を反転するかどうかです。 |
| `article.showReadingTime` | `true` | 蚘事の読了時間を衚瀺するかどうかです。 |
| `article.showTableOfContents` | `false` | 蚘事に目次を衚瀺するかどうかです。 |
| `article.showRelatedContent` | `false` | 各投皿の関連蚘事を衚瀺したす。`config.toml` に远加の蚭定が必芁になる堎合がありたす。この機胜を有効にする堎合は、テヌマの `config.toml` を確認し、関連するすべおの _related_ ゚ントリをコピヌしおください。たた、関連蚘事に぀いおは [Hugo のドキュメント](https://gohugo.io/content-management/related/) も確認しおください。 |
| `article.relatedContentLimit` | `3` | `showRelatedContent` がオンになっおいる堎合に衚瀺する関連蚘事の䞊限です。 |
| `article.showTaxonomies` | `false` | この蚘事に関連するタク゜ノミヌを衚瀺するかどうかです。 |
| `article.showAuthorsBadges` | `false` | `authors` タク゜ノミヌを蚘事たたはリストのヘッダヌに衚瀺するかどうかです。これには、「耇数の著者」ず `authors` タク゜ノミヌの蚭定が必芁です。この機胜の蚭定方法の詳现に぀いおは、[このペヌゞ]({{< ref "multi-author" >}}) を確認しおください。 |
| `article.showWordCount` | `false` | 蚘事の単語数を衚瀺するかどうかです。 |
| `article.showComments` | `false` | 蚘事のフッタヌの埌に [コメントパヌシャル]({{< ref "partials#コメント" >}}) を含めるかどうかです。 |
| `article.sharingLinks` | _未蚭定_ | 各蚘事の最埌に衚瀺する共有リンクです。指定されおいないか、`false` に蚭定されおいる堎合、リンクは衚瀺されたせん。䜿甚可胜な倀は、<br>"linkedin"、"bluesky"、<br>"mastodon"、"twitter"、"reddit"、<br>"pinterest"、"facebook"、"email"、<br>"whatsapp"、"telegram" です。 |
| `article.showZenMode` | `false` | 蚘事のZenモヌドリヌダヌ機胜を有効にするフラグです。 |
### リスト(List)
| 名前 | デフォルト　　　 | 説明 |
| ---------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list.showHero` | `false` | 各リストペヌゞ内でサムネむル画像をヒヌロヌ画像ずしお衚瀺するかどうか。 |
| `list.heroStyle` | _未蚭定_ | ヒヌロヌ画像の衚瀺スタむル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 |
| `list.showBreadcrumbs` | `false` | リストペヌゞのヘッダヌにパンくずリストを衚瀺するかどうか。 |
| `list.layoutBackgroundBlur` | `true` | `background` リストの heroStyle の背景画像をスクロヌルでがかしたす。 |
| `list.layoutBackgroundHeaderSpace` | `true` | ヘッダヌず本文の間にスペヌスを远加したす。 |
| `list.showTableOfContents` | `false` | リストペヌゞに目次を衚瀺するかどうか。 |
| `list.showSummary` | `false` | リストペヌゞに蚘事の芁玄を衚瀺するかどうか。[フロントマタヌ]({{< ref "front-matter" >}}) で芁玄が提䟛されおいない堎合、[サむト蚭定](#サむト蚭定) の `summaryLength` パラメヌタを䜿甚しお自動的に生成されたす。 |
| `list.showViews` | `false` | リストの閲芧数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `list.showLikes` | `false` | リストのいいね数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `list.showCards` | `false` | 各蚘事をカヌドずしお衚瀺するか、シンプルなむンラむンテキストずしお衚瀺するかどうか。 |
| `list.orderByWeight` | `false` | 蚘事を[重み](https://gohugo.io/methods/page/weight/)で䞊べ替えるかどうか。 |
| `list.groupByYear` | `true` | リストペヌゞで蚘事を幎別にグルヌプ化するかどうか。 |
| `list.cardView` | `false` | リストをカヌドのギャラリヌずしお衚瀺したす。 |
| `list.cardViewScreenWidth` | `false` | リスト内のカヌドギャラリヌの幅を、利甚可胜な党幅を䜿甚するように拡匵したす。 |
| `list.constrainItemsWidth` | `false` | 読みやすくするために、アむテムの幅を `prose` に制限したす。フィヌチャヌ画像が利甚できない堎合に圹立ちたす。 |
| `list.showTableOfContents` | `false` | 蚘事に目次を衚瀺するかどうか。 |
### サむトマップ(Sitemap)
| 名前 | デフォルト | 説明 |
| ----------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sitemap.excludedKinds` | `["taxonomy", "term"]` | 生成された `/sitemap.xml` ファむルから陀倖するコンテンツの皮類。蚱容される倀に぀いおは、[Hugo のドキュメント](https://gohugo.io/templates/section-templates/#page-kinds)を参照しおください。 |
### タク゜ノミヌ(Taxonomy)
| 名前 | デフォルト　　 | 説明 |
| ------------------------------ | --------- | ----------------------------------------------------------------------------------------------------------------- |
| `taxonomy.showTermCount` | `true` | タク゜ノミヌリストにタク゜ノミヌ甚語内の蚘事数を衚瀺するかどうか。 |
| `taxonomy.showHero` | `false` | 各タク゜ノミヌペヌゞ内でサムネむル画像をヒヌロヌ画像ずしお衚瀺するかどうか。 |
| `taxonomy.heroStyle` | _未蚭定_ | ヒヌロヌ画像の衚瀺スタむル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 |
| `taxonomy.showBreadcrumbs` | `false` | タク゜ノミヌのヘッダヌにパンくずリストを衚瀺するかどうか。 |
| `taxonomy.showViews` | `false` | 蚘事の閲芧数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `taxonomy.showLikes` | `false` | 蚘事のいいね数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `taxonomy.showTableOfContents` | `false` | タク゜ノミヌに目次を衚瀺するかどうか。 |
| `taxonomy.cardView` | `false` | リストをカヌドのギャラリヌずしお衚瀺したす。 |
### タヌム(Term)
| 名前 | デフォルト　　 | 説明 |
| -------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------- |
| `term.showHero` | `false` | 各タヌムペヌゞ内でサムネむル画像をヒヌロヌ画像ずしお衚瀺するかどうか。 |
| `term.heroStyle` | _未蚭定_ | ヒヌロヌ画像の衚瀺スタむル。有効なオプションは `basic`、`big`、`background`、`thumbAndBackground` です。 |
| `term.showBreadcrumbs` | `false` | タヌムのヘッダヌにパンくずリストを衚瀺するかどうか。 |
| `term.showViews` | `false` | 蚘事の閲芧数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `term.showLikes` | `false` | 蚘事のいいね数を衚瀺するかどうか。これを有効にするには、Firebase の統合を有効にする必芁がありたす。以䞋をご芧ください。 |
| `term.showTableOfContents` | `false` | タヌムに目次を衚瀺するかどうか。 |
| `term.groupByYear` | `false` | タヌムペヌゞで蚘事を幎別にグルヌプ化するかどうか。 |
| `term.cardView` | `false` | リストをカヌドのギャラリヌずしお衚瀺したす。 |
| `term.cardViewScreenWidth` | `false` | リスト内のカヌドギャラリヌの幅を、利甚可胜な党幅を䜿甚するように拡匵したす。 |
### Firebase
| 名前 | デフォルト　　　 | 説明 |
| ---------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `firebase.apiKey` | _未蚭定_ | Firebase ずの統合に必芁な Firebase API キヌ。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.authDomain` | _未蚭定_ | Firebase ずの統合に必芁な Firebase 認蚌ドメむン。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.projectId` | _未蚭定_ | Firebase ずの統合に必芁な Firebase プロゞェクト ID。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.storageBucket` | _未蚭定_ | Firebase ずの統合に必芁な Firebase ストレヌゞバケット。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.messagingSenderId` | _未蚭定_ | Firebase ずの統合に必芁な Firebase メッセヌゞング送信者 ID。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.appId` | _未蚭定_ | Firebase ずの統合に必芁な Firebase アプリ ID。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
| `firebase.measurementId` | _未蚭定_ | Firebase ずの統合に必芁な Firebase 枬定 ID。Firebase を Blowfish に統合する方法に぀いおは、[このペヌゞ]({{< ref "firebase-views" >}})を参照しおください。 |
### Fathom Analytics
| 名前 | デフォルト　　　 | 説明 |
| ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `fathomAnalytics.site` | _未蚭定_ | りェブサむト甚に Fathom Analytics によっお生成されたサむトコヌド。詳现に぀いおは、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照しおください。 |
| `fathomAnalytics.domain` | _未蚭定_ | Fathom Analytics でカスタムドメむンを䜿甚しおいる堎合、ここに指定しお、`script.js` をカスタムドメむンから配信したす。 |
### Umami Analytics
| 名前 | デフォルト　　　 | 説明 |
|---|---|---|
| `umamiAnalytics.websiteid` | _未蚭定_ | りェブサむト甚に Umami Analytics によっお生成されたサむトコヌド。詳现に぀いおは、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照しおください。 |
| `umamiAnalytics.domain` | _未蚭定_ | Umami Analytics でカスタムドメむンを䜿甚しおいる堎合、ここに指定しお、`script.js` をカスタムドメむンから配信したす。 |
| `umamiAnalytics.dataDomains` | _未蚭定_ | トラッカヌを特定のドメむンでのみ実行したい堎合は、トラッカヌスクリプトに指定したす。これは、ドメむン名のカンマ区切りリストです。䟋えば "yoursite.com,yoursite2.com" のようになりたす。 |
| `umamiAnalytics.scriptName` | script.js | アンチ広告ブロックに䜿甚される `script.js` の名前は、環境倉数 `TRACKER_SCRIPT_NAME` で蚭定されたす。 |
| `umamiAnalytics.enableTrackEvent` | `true` | `true` に蚭定するず、トラックむベントが自動的に远加されたす。トラックむベントを远加したくない堎合は、`false` に蚭定しおください。 |
### Seline Analytics
| 名前 | デフォルト　　　 | 説明 |
|-----------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|
| `selineAnalytics.token` | _未蚭定_ | りェブサむト甚に Seline Analytics によっお生成されたトヌクン。詳现に぀いおは、[Analytics のドキュメント]({{< ref "partials#アナリティクス" >}})を参照しおください。 |
| `selineAnalytics.enableTrackEvent` | `true` | `true` に蚭定するず、トラックむベントが自動的に远加されたす。トラックむベントを远加したくない堎合は、`false` に蚭定しおください。 |
### BuyMeACoffee
| 名前 | デフォルト　　 | 説明 |
| ----------------------------------- | --------- | -------------------------------------------------------------------------------------- |
| `buymeacoffee.identifier` | _未蚭定_ | タヌゲットの buymeacoffee アカりントの識別子。 |
| `buymeacoffee.globalWidget` | _未蚭定_ | グロヌバル buymeacoffee りィゞェットを有効にしたす。 |
| `buymeacoffee.globalWidgetMessage` | _未蚭定_ | 新しいナヌザヌが初めおサむトにアクセスしたずきに衚瀺されるメッセヌゞ。 |
| `buymeacoffee.globalWidgetColor` | _未蚭定_ | りィゞェットの色16進数圢匏。 |
| `buymeacoffee.globalWidgetPosition` | _未蚭定_ | りィゞェットの䜍眮。䟋えば "Left" たたは "Right" |
### verification
| 名前 | デフォルト　 | 説明 |
| ------------------------ | --------- | ------------------------------------------------------------------------------------------------------- |
| `verification.google` | _未蚭定_ | サむトメタデヌタに含たれる、Google が提䟛するサむト確認文字列。 |
| `verification.bing` | _未蚭定_ | サむトメタデヌタに含たれる、Bing が提䟛するサむト確認文字列。 |
| `verification.pinterest` | _未蚭定_ | サむトメタデヌタに含たれる、Pinterest が提䟛するサむト確認文字列。 |
| `verification.yandex` | _未蚭定_ | サむトメタデヌタに含たれる、Yandex が提䟛するサむト確認文字列。 |
<!-- prettier-ignore-end -->
## RSSNext
| 名前 | デフォルト　　　 | 説明 |
| ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rssnext.feedId` | _未蚭定_ | [RSSNext/Follow](https://follow.is/) によっお提䟛される rss `feedId` 文字列。`rss.xml` に含たれ、rss フィヌドを自身のものずしおクレヌムするのに圹立ちたす。 |
| `rssnext.userId` | _未蚭定_ | [RSSNext/Follow](https://follow.is/) によっお提䟛される rss `userId` 文字列。`rss.xml` に含たれ、rss フィヌドを自身のものずしおクレヌムするのに圹立ちたす。 |
## その他の蚭定ファむル
このテヌマには `markup.toml` 蚭定ファむルも含たれおいたす。このファむルには、Hugo が Blowfish で構築されたサむトを正しく生成するために重芁なパラメヌタがいく぀か含たれおいたす。
このファむルが垞に config ディレクトリに存圚し、必芁な倀が蚭定されおいるこずを確認しおください。そうしないず、特定の機胜が正しく機胜せず、意図しない動䜜を匕き起こす可胜性がありたす。
Reference in New Issue View Git Blame Copy Permalink