20 KiB
| title | date | draft | description | summary | slug | tags | ||
|---|---|---|---|---|---|---|---|---|
| 基本設定 | 2020-08-14 | false | Congoで利用可能なすべての設定 | Congoで利用可能なすべてのサイト、言語、テーマ設定と、それらを使用してプロジェクトをカスタマイズする方法をご覧ください。 | configuration |
|
Congoは高度にカスタマイズ可能なテーマで、最新のHugoの機能のいくつかを使用して、設定方法を簡素化しています。
このテーマには、基本的なブログまたは静的ウェブサイトを立ち上げて実行できるようにするデフォルト設定が同梱されています。
同梱されている設定ファイルはTOMLフォーマットで提供されています。設定ファイルをYAMLやJSONに変換したい場合はご自由にどうぞ。
デフォルトのテーマ設定は各ファイルに文書化されているので、ニーズに合わせて自由に設定を調整することができます。
{{< alert >}}
[インストール手順]({{< ref "/docs/installation#set-up-theme-configuration-files" >}})で説明されているように、Hugoプロジェクトの config/_default/ にあるファイルを修正し、プロジェクトルートにある config.toml ファイルを削除することで、テーマの設定を調整します。
{{< /alert >}}
サイト設定
Hugoの標準的な設定変数はテーマ全体を通して尊重されますが、最良のエクスペリエンスのために設定すべき特別なものもあります。
サイトの設定は config/_default/config.toml ファイルで管理されます。下の表はCongoが利用するすべての設定の概要です。
この表で提供される変数名は、TOML構造を簡略化するためにドット記法を使用していることに注意してください（つまり、 outputs.home は [outputs] home を指します）。
| Name | Default | Description |
|---|---|---|
theme |
"congo" |
Hugo Modulesを使用する場合、この設定値は削除してください。他のすべてのインストールタイプでは、テーマを機能させるために congo に設定する必要があります。 |
baseURL |
Not set | ウェブサイトのルートへのURL。 |
defaultContentLanguage |
"en" |
この値はテーマコンポーネントとコンテンツのデフォルト言語を決定します。サポートされる言語コードについては、下記の言語と国際化セクションを参照してください。 |
enableRobotsTXT |
true |
有効にすると、サイトルートに robots.txt ファイルが作成され、検索エンジンがサイト全体をクロールできるようになります。あらかじめ用意されている robots.txt を利用したい場合は、false に設定して static ディレクトリにファイルを置いてください。完全にコントロールしたい場合は、[カスタムレイアウト]({{< ref "content-examples" >}})を指定してこのファイルを生成することができます。 |
paginate |
10 |
記事一覧の各ページに掲載される記事の数。 |
summaryLength |
0 |
記事の要約が[フロントマター]({{< ref "front-matter" >}})で提供されていない場合に、記事の要約を生成するために使われる単語の数。デフォルト値 0 は最初の文章を使用します。この値は要約が非表示の場合には影響しません。 |
outputs.home |
["HTML", "RSS", "JSON"] |
生成される出力フォーマット。Congoでは、すべてのテーマコンポーネントが正しく動作するために、HTML、RSS、JSONが必要です。 |
permalinks |
Not set | パーマリンクの設定はHugo docsを参照してください。 |
taxonomies |
Not set | Taxonomiesについては、[コンテンツの整理]({{< ref "getting-started" >}})セクションを参照してください。 |
言語と国際化
Congoは完全な多言語ウェブサイト用に最適化されており、テーマのアセットはすぐに複数の言語に翻訳されます。言語設定により、複数バージョンのコンテンツを生成し、訪問者の母国語でカスタマイズされたエクスペリエンスを提供することができます。
Congoは現在、以下の言語に対応しています:
| Language | Code |
|---|---|
| 🇬🇧 English (default) | en |
| 🇪🇬 Arabic | ar |
| 🇧🇩 Bengali | bn |
| 🇨🇳 Chinese - Simplified (China) | zh-cn |
| 🇹🇼 Chinese - Traditional (Taiwan) | zh-tw |
| :flag-cz: Czech | cs |
| 🇳🇱 Dutch | nl |
| 🇫🇮 Finnish | fi |
| 🇫🇷 French | fr |
| 🇩🇪 German | de |
| 🇮🇱 Hebrew | he |
| 🇭🇺 Hungarian | hu |
| 🇮🇩 Indonesian | id |
| 🇮🇹 Italian | it |
| 🇯🇵 Japanese | ja |
| 🇵🇱 Polish | pl |
| 🇧🇷 Portuguese (Brazil) | pt-br |
| 🇵🇹 Portuguese (Portugal) | pt-pt |
| 🇷🇴 Romanian | ro |
| 🇷🇺 Russian | ru |
| 🇸🇰 Slovak | sk |
| 🇪🇸 Spanish (Spain) | es |
| 🇹🇷 Turkish | tr |
翻訳文字列を含むカスタムファイルを i18n/[code].yaml に作成することでデフォルトの翻訳をオーバーライドできます。このメソッドを使って新しい言語を追加することもできます。新しい翻訳をコミュニティと共有したい場合、Pull Requestを作ってください。
設定
可能な限り柔軟に対応するために、ウェブサイトの言語ごとに言語設定ファイルを作成する必要があります。デフォルトでは、Congoは config/_default/languages.en.toml に英語の言語設定を含んでいます。
英語以外の言語でウェブサイトを作成したい場合は、デフォルトのファイルをテンプレートとして使用したり、ファイル名を変更したりすることができます。ファイル名は languages.[language-code].toml という形式にしてください。
{{< alert >}}
注記: サイト設定の defaultContentLanguage パラメーターが、言語設定ファイル名の [language-code] と一致していることを確認してください。
{{< /alert >}}
| Name | Default | Description |
|---|---|---|
languageCode |
"en" |
このファイルの言語コード。トップレベル言語 (例 en)またはサブ変数 (例 en-au)で、ファイル名の [language-code] と一致する必要があります。Hugoはこの値が常に小文字であることを期待しています。HTMLに正しく準拠するためには、大文字と小文字を区別する params.isoCode パラメーターを設定してください。 |
languageName |
"English" |
言語名。 |
weight |
1 |
多言語サイトを構築する際の優先順序。 |
title |
"Congo" |
ウェブサイトのタイトル。サイトのヘッダーとフッターに表示されます。 |
copyright |
Not set | サイトのフッターに表示する著作権メッセージを含むMarkdown文字列。何も指定されない場合、Congoは title を使って自動的にコピーライト文字列を生成します。 |
params.isoCode |
"en" |
HTMLメタデータ用のISO言語コード。トップレベル言語 (例 en)またはサブバリアント (例 en-AU)です。 |
params.displayName |
"EN" |
ウェブサイトに表示される際に使用される言語名。 |
params.rtl |
false |
RTL言語かどうか。 true に設定すると、コンテンツを右から左にリフローする。CongoはRTL言語とLTR言語の同時使用を完全にサポートしており、動的に両方の言語に調整します。 |
params.dateFormat |
"2 January 2006" |
日付の書式。許容される書式については、Hugo docsを参照してください。 |
params.mainSections |
Not set | 最近の記事リストに表示するセクション。指定されていない場合は、記事の数が最も多いセクションが使われます。 |
params.description |
Not set | ウェブサイトの説明。これはサイトのメタデータに使用されます。 |
author.name |
Not set | 著者の名前。これは記事のフッターと、プロフィールレイアウトが使用されている場合にホームページに表示されます。 |
author.image |
Not set | 著者の画像ファイルへのパス。画像は縦横比1:1で、 assets/ に置くこと。 |
author.headline |
Not set | 著者の見出しを含むMarkdown文字列。プロフィールのトップページで著者の名前の下に表示されます。 |
author.bio |
Not set | 著者の経歴を含むMarkdown文字列。記事のフッターに表示されます。 |
author.links |
Not set | 著者の詳細とともに表示するリンク。設定ファイルにはリンクの例が含まれており、コメントを外すだけで有効にすることができます。リンクが表示される順番は、配列に表示される順番によって決まります。 assets/icons/ に対応するSVGアイコンを用意することで、カスタムリンクを追加することもできます。 |
メニュー
Congoは言語別メニュー設定もサポートしている。メニュー設定ファイルは、言語ファイルと同じ命名形式に従っています。ファイル名に言語コードを指定するだけで、そのファイルがどの言語に関連するかをHugoに伝えることができます。
メニュー設定ファイルは menus.[language-code].toml という形式で命名されます。 [language-code] が設定と一致していることを常に確認してください。
[はじめに]({{< ref "getting-started#メニュー" >}})セクションで、このファイルの構造について詳しく説明しています。また、Hugo menu docsにも設定例があります。
テーマパラメーター
Congoはテーマの機能を制御する多数の設定パラメーターを提供します。下の表は config/_default/params.toml ファイルで利用可能なパラメーターの概要です。
パラメーターの多くは、フロントマターで指定することで、記事ごとに上書きすることができます。詳しくは、[フロントマター]({{< ref "front-matter" >}})セクションを参照してください。
| Name | Default | Description |
|---|---|---|
colorScheme |
"congo" |
使用する配色。有効な値は congo (デフォルト), avocado, cherry, fire, ocean, sapphire, slate です。詳しくは [カラースキーム]({{< ref "getting-started#カラースキーム" >}})セクションを参照してください。 |
defaultAppearance |
"light" |
デフォルトのテーマ外観、 light または dark のいずれか。 |
autoSwitchAppearance |
true |
テーマの外観を訪問者のオペレーティングシステムの設定に基づいて自動的に切り替えるかどうか。常に defaultAppearance を使うようにするには false を設定します。 |
enableSearch |
false |
サイト内検索を有効にするかどうか。検索機能を有効にするには true を設定します。検索機能は、サイト設定の outputs.home が正しく設定されているかどうかに依存することに注意してください。 |
enableCodeCopy |
false |
<code> ブロックに対してクリップボードへのコピーボタンを有効にするかどうか。 highlight.noClasses が false に設定されていなければ、コードコピーは正しく機能しません。その他の設定ファイルについては以下を参照してください。 |
enableImageLazyLoading |
true |
ブラウザが遅延ロードするように画像をマークするかどうか。 |
robots |
Not set | ロボットがあなたのサイトをどのように扱うべきかを示す文字列。設定された場合、 <head> に出力されます。有効な値についてはGoogleのドキュメントを参照してください。 |
fingerprintAlgorithm |
"sha256" |
assets にフィンガープリントを行う際のハッシュアルゴリズム。有効なオプションは md5、sha256、sha384 および sha512 です。 |
header.layout |
"basic" |
ヘッダーとメニューのレイアウト。有効な値は basic、hamburger、hybridまたはcustomです。 custom に設定した場合は、 /layouts/partials/header/custom.html ファイルを作成して独自のレイアウトを指定する必要があります。 |
header.logo |
Not set | assets/ 内のロゴファイルへの相対パス。ロゴファイルは2倍の解像度で提供され、任意の画像サイズに対応している必要があります。 |
header.logoDark |
Not set | dark モード時に使用されるロゴファイルへの相対パス。 |
header.showTitle |
true |
サイトのタイトルをヘッダーに表示するかどうか。 |
footer.showCopyright |
true |
サイトフッターにコピーライト文字列を表示するかどうか。言語と国際化の copyright パラメーターを使って文字列自体をカスタマイズできます。 |
footer.showThemeAttribution |
true |
"Powered by Hugo & Congo" といった帰属表示をフッターに表示するかどうか。この表示を無効にする場合は、サイト上の他の場所（例えば、アバウトページなど）でテーマの帰属を表示することを検討してください。 |
footer.showAppearanceSwitcher |
false |
フッターに外観スイッチャーを表示するかどうか。訪問者の設定を保持するためにブラウザのローカルストレージが使用されます。 |
footer.showScrollToTop |
true |
true に設定すると、最上部にスクロールする矢印が表示されます。 |
homepage.layout |
"page" |
ホームページのレイアウト。有効な値は page, profile または custom です。 custom に設定した場合は、 /layouts/partials/home/custom.html ファイルを作成して、独自のレイアウトを指定する必要があります。詳しくは[ホームページレイアウト]({{< ref "homepage-layout" >}})セクションを参照してください。 |
homepage.showRecent |
false |
ホームページに最近の記事リストを表示するかどうか。 |
homepage.recentLimit |
5 |
homepage.showRecent が true の場合に表示する最近の記事の最大数。 |
article.showDate |
true |
記事が作成された日付を表示するかどうか。 |
article.showDateUpdated |
false |
記事が更新された日付を表示するかどうか。 |
article.showAuthor |
true |
記事フッターに著者欄を表示するかどうか。 |
article.showBreadcrumbs |
false |
記事のヘッダーにパンくずリストを表示するかどうか。 |
article.showDraftLabel |
true |
--buildDrafts でビルドしたときに、記事の横に下書きインジケータを表示するかどうか。 |
article.showEdit |
false |
記事の内容を編集するためのリンクを表示するかどうか。 |
article.editURL |
Not set | article.showEdit がアクティブな場合の編集リンクのURL。 |
article.editAppendPath |
true |
article.editURLで設定されたURLに現在の記事へのパスを追加するかどうか。 |
article.showHeadingAnchors |
true |
見出しアンカーリンクを記事内の見出しと一緒に表示するかどうか。 |
article.showPagination |
true |
記事のフッターに次/前の記事リンクを表示するかどうか。 |
article.invertPagination |
false |
次の記事/前の記事リンクの向きを反転させるかどうか。 |
article.showReadingTime |
true |
記事の予想読了時間を表示するかどうか。 |
article.showTableOfContents |
false |
記事に目次を表示するかどうか。 |
article.showTaxonomies |
false |
この記事に関連するTaxonomiesを表示するかどうか。 |
article.showWordCount |
false |
記事の単語数を表示するかどうか。 |
article.showComments |
false |
[コメント]({{< ref "partials#コメント" >}})を記事フッターの後に含めるかどうか。 |
article.sharingLinks |
Not set | 各記事の最後に共有リンクを表示するかどうか。 false にすると共有リンクは表示されません。 |
list.showBreadcrumbs |
false |
リストページのヘッダーにパンくずリストを表示するかどうか。 |
list.showTableOfContents |
false |
リストページに目次を表示するかどうか。 |
list.showTaxonomies |
false |
リストページに関連するTaxonomiesを表示するかどうか。 |
list.showSummary |
false |
リストページに記事の要約を表示するかどうか。もし[フロントマター]({{< ref "front-matter" >}})で要約が提供されていない場合、サイト設定の summaryLength パラメーターを使って要約が自動生成されます。 |
list.groupByYear |
true |
リストページで記事を年ごとにグループ化するかどうか。 |
list.paginationWidth |
1 |
リストページを切り詰める際に、現在のページの両側にいくつのページネーションリンクを出力するか。 1 の場合、現在のページの両側に1つのリンクを出力します。 最初のページ と 最後のページ へのリンクは常に表示され、この値に追加されます。 |
sitemap.excludedKinds |
["taxonomy", "term"] |
生成される /sitemap.xml から除外されるべきコンテンツの種類。許容される値についてはHugo docsを参照してください。 |
taxonomy.showTermCount |
true |
TaxonomiesのリストにTermごとの記事数を表示するかどうか。 |
fathomAnalytics.site |
Not set | Fathom Analyticsによって生成されたウェブサイトのサイトコード。詳細は[アナリティクス]({{< ref "partials#アナリティクス" >}})を参照してください。 |
fathomAnalytics.domain |
Not set | Fathom Analyticsでカスタムドメインを使用している場合、カスタムドメインからscript.jsを提供するためにここに指定します。 |
verification.google |
Not set | サイトのメタデータに含めるGoogleが提供するサイト検証文字列。 |
verification.bing |
Not set | サイトのメタデータに含めるBingが提供するサイト検証文字列。 |
verification.pinterest |
Not set | サイトのメタデータに含めるPinterestが提供するサイト検証文字列。 |
verification.yandex |
Not set | サイトのメタデータに含めるYandexが提供するサイト検証文字列。 |
その他の設定ファイル
このテーマには markup.toml 設定ファイルも含まれています。このファイルにはいくつかの重要なパラメータが含まれており、Congoで構築されたサイトを生成するためにHugoが正しく設定されるようにします。
このファイルがconfigディレクトリに存在し、必要な値が設定されていることを常に確認してください。これを行わないと、特定の機能が正しく動作しなかったり、意図しない動作になったりする可能性があります。