2023-10-30 22:52:12 +00:00
|
|
|
<!doctype html><html lang=ja dir=ltr class=scroll-smooth data-default-appearance=light data-auto-appearance=true><head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=theme-color content="rgb(255,255,255)"><title>基本設定 · Congo</title>
|
2024-01-21 22:23:05 +00:00
|
|
|
<meta name=title content="基本設定 · Congo"><script type=text/javascript src=/congo/js/appearance.min.022d0ebc3b46a335eb1c7ef79b7f2de143d7cd5156d433638592ef1ce5f8554e.js integrity="sha256-Ai0OvDtGozXrHH73m38t4UPXzVFW1DNjhZLvHOX4VU4="></script><link type=text/css rel=stylesheet href=/congo/css/main.bundle.min.33a669351b9f936b30a0fc74240c4bd296cb15c8b2b1e40ea9ee7b6658af735b.css integrity="sha256-M6ZpNRufk2swoPx0JAxL0pbLFciyseQOqe57Zlivc1s="><script defer type=text/javascript id=script-bundle src=/congo/js/main.bundle.min.fba363b244ec92c2d7b9de42d4cebd0b8994fd07279923c5929eb4dc3d055606.js integrity="sha256-+6NjskTsksLXud5C1M69C4mU/QcnmSPFkp603D0FVgY=" data-copy=コピー data-copied=コピーしました></script><meta name=description content="
|
2023-10-22 23:23:53 +00:00
|
|
|
Congoで利用可能なすべての設定
|
2024-01-21 22:23:05 +00:00
|
|
|
"><link rel=canonical href=https://jpanther.github.io/congo/ja/docs/configuration/><link rel=apple-touch-icon sizes=180x180 href=/congo/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=/congo/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=/congo/favicon-16x16.png><link rel=manifest href=/congo/site.webmanifest><meta property="og:title" content="基本設定"><meta property="og:description" content="Congoで利用可能なすべての設定"><meta property="og:type" content="article"><meta property="og:url" content="https://jpanther.github.io/congo/ja/docs/configuration/"><meta property="article:section" content="docs"><meta property="article:published_time" content="2020-08-14T00:00:00+00:00"><meta property="article:modified_time" content="2020-08-14T00:00:00+00:00"><meta name=twitter:card content="summary"><meta name=twitter:title content="基本設定"><meta name=twitter:description content="Congoで利用可能なすべての設定"><script type=application/ld+json>{"@context":"https://schema.org","@type":"Article","articleSection":"ドキュメント","name":"基本設定","headline":"基本設定","description":"Congoで利用可能なすべての設定","abstract":"Congoで利用可能なすべてのサイト、言語、テーマ設定と、それらを使用してプロジェクトをカスタマイズする方法をご覧ください。","inLanguage":"ja","url":"https:\/\/jpanther.github.io\/congo\/ja\/docs\/configuration\/","author":{"@type":"Person","name":"Congo"},"copyrightYear":"2020","dateCreated":"2020-08-14T00:00:00\u002b00:00","datePublished":"2020-08-14T00:00:00\u002b00:00","dateModified":"2020-08-14T00:00:00\u002b00:00","keywords":["config","docs"],"mainEntityOfPage":"true","wordCount":"521"}</script><meta name=author content="Congo"><link href=https://twitter.com/ rel=me><link href=https://facebook.com/ rel=me><link href=https://linkedin.com/ rel=me><link href=https://youtube.com/ rel=me></head><body class="m-auto flex h-screen max-w-7xl flex-col bg-neutral px-6 text-lg leading-7 text-neutral-900 sm:px-14 md:px-24 lg:px-32 dark:bg-neutral-800 dark:text-neutral"><div id=the-top class="absolute flex self-center"><a class="-translate-y-8 rounded-b-lg bg-primary-200 px-3 py-1 text-sm focus:translate-y-0 dark:bg-neutral-600" href=#main-content><span class="pe-2 font-bold text-primary-600 dark:text-primary-400">↓</span>メインコンテンツへスキップ</a></div><header class="py-6 font-semibold text-neutral-900 print:hidden sm:py-10 dark:text-neutral"><nav class="flex items-start justify-between sm:items-center"><div class="flex flex-row items-center"><a class="decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2" rel=me href=/congo/ja/>Congo</a></div><ul class="flex list-none flex-col text-end sm:flex-row"><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/ja/docs/ title=ドキュメント><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">ドキュメント</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/ja/samples/ title=サンプル><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">サンプル</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=/congo/ja/users/ title=利用例><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2">利用例</span></a></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><a href=https://github.com/jpanther/congo title target=_blank><span class="group-dark:hover:text-primary-400 transition-colors group-hover:text-primary-600"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><path fill="currentcolor" d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6.0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6.0 6.2-2
|
|
|
|
<span class="group-dark:hover:text-primary-400 transition-colors group-hover:text-primary-600"><span class="icon relative inline-block px-1 align-text-bottom"><svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M505 442.7 405.3 343c-4.5-4.5-10.6-7-17-7H372c27.6-35.3 44-79.7 44-128C416 93.1 322.9.0 208 0S0 93.1.0 208s93.1 208 208 208c48.3.0 92.7-16.4 128-44v16.3c0 6.4 2.5 12.5 7 17l99.7 99.7c9.4 9.4 24.6 9.4 33.9.0l28.3-28.3c9.4-9.4 9.4-24.6.1-34zM208 336c-70.7.0-128-57.2-128-128 0-70.7 57.2-128 128-128 70.7.0 128 57.2 128 128 0 70.7-57.2 128-128 128z"/></svg></span></span><span class="decoration-primary-500 group-hover:underline group-hover:decoration-2 group-hover:underline-offset-2"></span></button></li><li class="group mb-1 sm:mb-0 sm:me-7 sm:last:me-0.5"><div class="group relative"><button class="group-dark:hover:text-primary-400 flex w-full items-center justify-end transition-colors group-hover:text-primary-600">
|
|
|
|
<span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill="currentcolor" d="M4.545 6.714 4.11 8H3l1.862-5h1.284L8 8H6.833l-.435-1.286H4.545zm1.634-.736L5.5 3.956h-.049l-.679 2.022H6.18z"/><path fill="currentcolor" d="M0 2a2 2 0 012-2h7a2 2 0 012 2v3h3a2 2 0 012 2v7a2 2 0 01-2 2H7a2 2 0 01-2-2v-3H2A2 2 0 010 9V2zm2-1A1 1 0 001 2v7a1 1 0 001 1h7a1 1 0 001-1V2A1 1 0 009 1H2zm7.138 9.995c.193.301.402.583.63.846-.748.575-1.673 1.001-2.768 1.292.178.217.451.635.555.867 1.125-.359 2.08-.844 2.886-1.494.777.665 1.739 1.165 2.93 1.472.133-.254.414-.673.629-.89-1.125-.253-2.057-.694-2.82-1.284.681-.747 1.222-1.651 1.621-2.757H14V8h-3v1.047h.765c-.318.844-.74 1.546-1.272 2.13a6.066 6.066.0 01-.415-.492 1.988 1.988.0 01-.94.31z"/></svg></span><span class=text-sm>JA</span><span class=text-[0.6rem]><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M233.4 406.6c12.5 12.5 32.8 12.5 45.3.0l192-192c12.5-12.5 12.5-32.8.0-45.3s-32.8-12.5-45.3.0L256 338.7 86.6 169.4c-12.5-12.5-32.8-12.5-45.3.0s-12.5 32.8.0 45.3l192 192z"/></svg></span></span></button><div class="invisible w-full bg-transparent group-hover:visible"></div><div class="invisible absolute z-50 flex flex-col whitespace-nowrap rounded border border-neutral-300 bg-neutral text-start text-base shadow group-hover:visible ltr:right-0 rtl:left-0 dark:border-neutral-600 dark:bg-neutral-800"><div class="flex flex-grow"><a href=/congo/docs/configuration/ class="w-full py-1 pe-10 ps-2 decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2">English (Australia)</a></div><div class="flex flex-grow"><a href=/congo/ja/docs/configuration/ class="flex w-full items-center justify-between bg-primary-100 px-2 py-1 dark:bg-primary-900">日本語<span class="ms-2 w-6 text-primary-600 dark:text-primary-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><path fill="currentcolor" d="M438.6 105.4c12.5 12.5 12.5 32.7.0 45.2l-256 256c-12.5 12.5-32.7 12.5-45.2.0L9.372 278.6c-12.496-12.5-12.496-32.7.0-45.2 12.498-12.5 32.758-12.5 45.258.0L159.1 338.7 393.4 105.4c12.5-12.52 32.7-12.52 45.2.0h0z"/></svg></span></span></a></div><div class="flex flex-grow"><a href=/congo/zh-cn/docs/configuration/ class="w-full py-1 pe-10 ps-2 decoration-primary-500 hover:underline hover:decoration-2 hover:underline-offset-2">简体中文</a></div></div></div></li></ul></nav></header><div class="relative flex grow flex-col"><main id=main-content class=grow><article><header class=max-w-prose><ol class="text-sm text-neutral-500 print:hidden dark:text-neutral-400"><li class="hidden inline"><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/ja/>Congoへようこそ! :tada:</a><span class="px-1 text-primary-500">/</span></li><li class=inline><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/ja/docs/>ドキュメント</a><span class="px-1 text-primary-500">/</span></li><li class="hidden inline"><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/ja/docs/configuration/>基本設定</a><span class="px-1 text-primary-500">/</span></li></ol><h1 class="mt-0 text-4xl font-extrabold text-neutral-900 dark:text-neutral">基本設定</h1><div class="mb-12 mt-8 text-base text-neutral-500 print:hidden dark:text-neutral-400"><div class="flex flex-row flex-wrap items-center"><span title=読むのに必要な時間>3 分</span><span class="px-2 text-primary-500">·</span>
|
|
|
|
<span class=mb-[2px]><a href=https://github.com/jpanther/congo/tree/dev/exampleSite/content/docs/configuration/index.ja.md class="text-lg hover:text-primary-500" rel="noopener noreferrer" target=_blank title=編集><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M490.3 40.4c21.9 21.87 21.9 57.33.0 79.2l-30 30.1-98-97.98 30.1-30.06C414.3-.2135 449.7-.2135 471.6 21.66L490.3 40.4zM172.4 241.7 339.7 74.34l98 97.96L270.3 339.6C264.2 345.8 256.7 350.4 248.4 353.2l-88.8 29.6C150.1 385.6 141.5 383.4 135 376.1 128.6 370.5 126.4 361 129.2 352.4l29.6-88.8C161.6 255.3 166.2 247.8 172.4 241.7v0zM192 63.1c17.7.0 32 15.23 32 32 0 18.6-14.3 32-32 32H96c-17.67.0-32 15.2-32 32V416c0 17.7 14.33 32 32 32H352c17.7.0 32-14.3 32-32V319.1c0-16.8 14.3-32 32-32s32 15.2 32 32V416c0 53-43 96-96 96H96c-53.02.0-96-43-96-96V159.1c0-53 42.98-96 96-96h96z"/></svg></span></a></span></div></div></header><section class="prose mt-0 flex max-w-full flex-col dark:prose-invert lg:flex-row"><div class="order-first px-0 lg:order-last lg:max-w-xs lg:ps-8"><div class="toc pe-5 print:hidden lg:sticky lg:top-10"><details open class="-ms-5 mt-0 overflow-hidden rounded-lg ps-5"><summary class="-ms-5 block cursor-pointer bg-neutral-100 py-1 ps-5 text-lg font-semibold text-neutral-800 lg:hidden dark:bg-neutral-700 dark:text-neutral-100">目次</summary><div class="-ms-5 border-s border-dotted border-neutral-300 py-2 ps-5 dark:border-neutral-600"><nav id=TableOfContents><ul><li><a href=#サイト設定>サイト設定</a></li><li><a href=#言語と国際化>言語と国際化</a><ul><li><a href=#設定>設定</a></li><li><a href=#メニュー>メニュー</a></li></ul></li><li><a href=#テーマパラメーター>テーマパラメーター</a></li><li><a href=#その他の設定ファイル>その他の設定ファイル</a></li></ul></nav></div></details></div></div><div class="min-h-0 min-w-0 max-w-prose grow"><p>Congoは高度にカスタマイズ可能なテーマで、最新のHugoの機能のいくつかを使用して、設定方法を簡素化しています。</p><p>このテーマには、基本的なブログまたは静的ウェブサイトを立ち上げて実行できるようにするデフォルト設定が同梱されています。</p><blockquote><p>同梱されている設定ファイルはTOMLフォーマットで提供されています。設定ファイルをYAMLやJSONに変換したい場合はご自由にどうぞ。</p></blockquote><p>デフォルトのテーマ設定は各ファイルに文書化されているので、ニーズに合わせて自由に設定を調整することができます。</p><div class="flex rounded-md bg-primary-100 px-4 py-3 dark:bg-primary-900"><span class="pe-3 text-primary-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M506.3 417 293 53c-16.33-28-57.54-28-73.98.0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6c32.76.0 53.26-35 36.96-63zM232 168c0-13.25 10.75-24 24-24s24 10.8 24 24v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zm24 248c-17.36.0-31.44-14.08-31.44-31.44s14.07-31.44 31.44-31.44 31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg></span></span><span class=dark:text-neutral-300><a href=https://jpanther.github.io/congo/ja/docs/installation/#set-up-theme-configuration-files target=_blank rel=noreferrer>インストール手順</a>で説明されているように、Hugoプロジェクトの <code>config/_default/</code> にあるファイルを修正し、プロジェクトルートにある <code>config.toml</code> ファイルを削除することで、テーマの設定を調整します。</span></div><h2 id=サイト設定 class="relative group">サイト設定 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:non
|
2023-10-26 02:58:10 +00:00
|
|
|
<a href=#%e8%a8%80%e8%aa%9e%e3%81%a8%e5%9b%bd%e9%9a%9b%e5%8c%96>言語と国際化</a>セクションを参照してください。</td></tr><tr><td><code>enableRobotsTXT</code></td><td><code>true</code></td><td>有効にすると、サイトルートに <code>robots.txt</code> ファイルが作成され、検索エンジンがサイト全体をクロールできるようになります。あらかじめ用意されている <code>robots.txt</code> を利用したい場合は、<code>false</code> に設定して <code>static</code> ディレクトリにファイルを置いてください。完全にコントロールしたい場合は、
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/content-examples/>カスタムレイアウト</a>を指定してこのファイルを生成することができます。</td></tr><tr><td><code>paginate</code></td><td><code>10</code></td><td>記事一覧の各ページに掲載される記事の数。</td></tr><tr><td><code>summaryLength</code></td><td><code>0</code></td><td>記事の要約が
|
2024-01-21 22:23:05 +00:00
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/front-matter/>フロントマター</a>で提供されていない場合に、記事の要約を生成するために使われる単語の数。デフォルト値 <code>0</code> は最初の文章を使用します。この値は要約が非表示の場合には影響しません。</td></tr><tr><td><code>outputs.home</code></td><td><code>["HTML", "RSS", "JSON"]</code></td><td>生成される出力フォーマット。Congoでは、すべてのテーマコンポーネントが正しく動作するために、HTML、RSS、JSONが必要です。</td></tr><tr><td><code>permalinks</code></td><td><em>Not set</em></td><td>パーマリンクの設定は
|
|
|
|
<a href=https://gohugo.io/content-management/urls/#permalinks target=_blank rel=noreferrer>Hugo docs</a>を参照してください。</td></tr><tr><td><code>taxonomies</code></td><td><em>Not set</em></td><td>Taxonomiesについては、
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/getting-started/>コンテンツの整理</a>セクションを参照してください。</td></tr></tbody></table><h2 id=言語と国際化 class="relative group">言語と国際化 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e8%a8%80%e8%aa%9e%e3%81%a8%e5%9b%bd%e9%9a%9b%e5%8c%96 aria-label=アンカー>#</a></span></h2><p>Congoは完全な多言語ウェブサイト用に最適化されており、テーマのアセットはすぐに複数の言語に翻訳されます。言語設定により、複数バージョンのコンテンツを生成し、訪問者の母国語でカスタマイズされたエクスペリエンスを提供することができます。</p><p>Congoは現在、以下の言語に対応しています:</p><table><thead><tr><th>Language</th><th>Code</th></tr></thead><tbody><tr><td>🇬🇧 <strong>English (default)</strong></td><td><code>en</code></td></tr><tr><td>🇪🇬 Arabic</td><td><code>ar</code></td></tr><tr><td>🇧🇩 Bengali</td><td><code>bn</code></td></tr><tr><td>🇧🇬 Bulgarian</td><td><code>bg</code></td></tr><tr><td>🇨🇳 Chinese - Simplified (China)</td><td><code>zh-cn</code></td></tr><tr><td>🇹🇼 Chinese - Traditional (Taiwan)</td><td><code>zh-tw</code></td></tr><tr><td>🇨🇿 Czech</td><td><code>cs</code></td></tr><tr><td>🇳🇱 Dutch</td><td><code>nl</code></td></tr><tr><td>🇫🇮 Finnish</td><td><code>fi</code></td></tr><tr><td>🇫🇷 French</td><td><code>fr</code></td></tr><tr><td>🇩🇪 German</td><td><code>de</code></td></tr><tr><td>🇮🇱 Hebrew</td><td><code>he</code></td></tr><tr><td>🇭🇺 Hungarian</td><td><code>hu</code></td></tr><tr><td>🇮🇩 Indonesian</td><td><code>id</code></td></tr><tr><td>🇮🇹 Italian</td><td><code>it</code></td></tr><tr><td>🇯🇵 Japanese</td><td><code>ja</code></td></tr><tr><td>🇵🇱 Polish</td><td><code>pl</code></td></tr><tr><td>🇧🇷 Portuguese (Brazil)</td><td><code>pt-br</code></td></tr><tr><td>🇵🇹 Portuguese (Portugal)</td><td><code>pt-pt</code></td></tr><tr><td>🇷🇴 Romanian</td><td><code>ro</code></td></tr><tr><td>🇷🇺 Russian</td><td><code>ru</code></td></tr><tr><td>🇸🇰 Slovak</td><td><code>sk</code></td></tr><tr><td>🇪🇸 Spanish (Spain)</td><td><code>es</code></td></tr><tr><td>🇹🇷 Turkish</td><td><code>tr</code></td></tr><tr><td>🇺🇦 Ukrainian</td><td><code>uk</code></td></tr></tbody></table><p>翻訳文字列を含むカスタムファイルを <code>i18n/[code].yaml</code> に作成することでデフォルトの翻訳をオーバーライドできます。このメソッドを使って新しい言語を追加することもできます。新しい翻訳をコミュニティと共有したい場合、
|
|
|
|
<a href=https://github.com/jpanther/congo/pulls target=_blank rel=noreferrer>Pull Request</a>を作ってください。</p><h3 id=設定 class="relative group">設定 <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e8%a8%ad%e5%ae%9a aria-label=アンカー>#</a></span></h3><p>可能な限り柔軟に対応するために、ウェブサイトの言語ごとに言語設定ファイルを作成する必要があります。デフォルトでは、Congoは <code>config/_default/languages.en.toml</code> に英語の言語設定を含んでいます。</p><p>英語以外の言語でウェブサイトを作成したい場合は、デフォルトのファイルをテンプレートとして使用したり、ファイル名を変更したりすることができます。ファイル名は <code>languages.[language-code].toml</code> という形式にしてください。</p><div class="flex rounded-md bg-primary-100 px-4 py-3 dark:bg-primary-900"><span class="pe-3 text-primary-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M506.3 417 293 53c-16.33-28-57.54-28-73.98.0l-213.2 364C-10.59 444.9 9.849 480 42.74 480h426.6c32.76.0 53.26-35 36.96-63zM232 168c0-13.25 10.75-24 24-24s24 10.8 24 24v128c0 13.25-10.75 24-23.1 24S232 309.3 232 296V168zm24 248c-17.36.0-31.44-14.08-31.44-31.44s14.07-31.44 31.44-31.44 31.44 14.08 31.44 31.44C287.4 401.9 273.4 416 256 416z"/></svg></span></span><span class=dark:text-neutral-300><strong>注記:</strong>
|
|
|
|
<a href=#%e3%82%b5%e3%82%a4%e3%83%88%e8%a8%ad%e5%ae%9a>サイト設定</a>の <code>defaultContentLanguage</code> パラメーターが、言語設定ファイル名の <code>[language-code]</code> と一致していることを確認してください。</span></div><table><thead><tr><th>Name</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>languageCode</code></td><td><code>"en"</code></td><td>このファイルの言語コード。トップレベル言語 (例 <code>en</code>)またはサブ変数 (例 <code>en-AU</code>)で、ファイル名の <code>[language-code]</code> と一致する必要があります。</td></tr><tr><td><code>languageName</code></td><td><code>"English"</code></td><td>言語名。</td></tr><tr><td><code>languageDirection</code></td><td><code>"ltr"</code></td><td>RTL言語かどうか。 <code>"rtl"</code> に設定すると、コンテンツを右から左にリフローする。CongoはRTL言語とLTR言語の同時使用を完全にサポートしており、動的に両方の言語に調整します。</td></tr><tr><td><code>weight</code></td><td><code>1</code></td><td>多言語サイトを構築する際の優先順序。</td></tr><tr><td><code>title</code></td><td><code>"Congo"</code></td><td>ウェブサイトのタイトル。サイトのヘッダーとフッターに表示されます。</td></tr><tr><td><code>copyright</code></td><td><em>Not set</em></td><td>サイトのフッターに表示する著作権メッセージを含むMarkdown文字列。何も指定されない場合、Congoは <code>title</code> を使って自動的にコピーライト文字列を生成します。</td></tr><tr><td><code>params.dateFormat</code></td><td><code>"2 January 2006"</code></td><td>日付の書式。許容される書式については、
|
|
|
|
<a href=https://gohugo.io/functions/format/#gos-layout-string target=_blank rel=noreferrer>Hugo docs</a>を参照してください。</td></tr><tr><td><code>params.mainSections</code></td><td><em>Not set</em></td><td>最近の記事リストに表示するセクション。指定されていない場合は、記事の数が最も多いセクションが使われます。</td></tr><tr><td><code>params.description</code></td><td><em>Not set</em></td><td>ウェブサイトの説明。これはサイトのメタデータに使用されます。</td></tr><tr><td><code>params.author.name</code></td><td><em>Not set</em></td><td>著者の名前。これは記事のフッターと、プロフィールレイアウトが使用されている場合にホームページに表示されます。</td></tr><tr><td><code>params.author.image</code></td><td><em>Not set</em></td><td>著者の画像ファイルへのパス。画像は縦横比1:1で、 <code>assets/</code> に置くこと。</td></tr><tr><td><code>params.author.headline</code></td><td><em>Not set</em></td><td>著者の見出しを含むMarkdown文字列。プロフィールのトップページで著者の名前の下に表示されます。</td></tr><tr><td><code>params.author.bio</code></td><td><em>Not set</em></td><td>著者の経歴を含むMarkdown文字列。記事のフッターに表示されます。</td></tr><tr><td><code>params.author.links</code></td><td><em>Not set</em></td><td>著者の詳細とともに表示するリンク。設定ファイルにはリンクの例が含まれており、コメントを外すだけで有効にすることができます。リンクが表示される順番は、配列に表示される順番によって決まります。 <code>assets/icons/</code> に対応するSVGアイコンを用意することで、カスタムリンクを追加することもできます。</td></tr></tbody></table><h3 id=メニュー class="relative group">メニュー <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e3%83%a1%e3%83%8b%e3%83%a5%e3%83%bc aria-label=アンカー>#</a></span></h3><p>Congoは言語別メニュー設定もサポートしている。メニュー設定ファイルは、言語ファイルと同じ命名形式に従っています。ファイル名に言語コードを指定するだけで、そのファイルがどの言語に関連するかをHugoに伝えることができます。</p><p>メニュー設定ファイルは <code>menus.[language-code].toml</code> という形式で命名されます。 <code>[language-code]</code> が設定と一致していることを常に確認してください。</p><p><a href=https://jpanther.github.io/congo/ja/docs/getting-started/#メニュー>はじめに</a>セクションで、このファイルの構造について詳しく説明しています。また、
|
|
|
|
<a href=https://gohugo.io/content-management/menus/ target=_blank rel=noreferrer>Hugo menu docs</a>にも設定例があります。</p><h2 id=テーマパラメーター class="relative group">テーマパラメーター <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e3%83%86%e3%83%bc%e3%83%9e%e3%83%91%e3%83%a9%e3%83%a1%e3%83%bc%e3%82%bf%e3%83%bc aria-label=アンカー>#</a></span></h2><p>Congoはテーマの機能を制御する多数の設定パラメーターを提供します。下の表は <code>config/_default/params.toml</code> ファイルで利用可能なパラメーターの概要です。</p><p>パラメーターの多くは、フロントマターで指定することで、記事ごとに上書きすることができます。詳しくは、
|
2023-10-26 02:58:10 +00:00
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/front-matter/>フロントマター</a>セクションを参照してください。</p><table><thead><tr><th>Name</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>colorScheme</code></td><td><code>"congo"</code></td><td>使用する配色。有効な値は <code>congo</code> (デフォルト), <code>avocado</code>, <code>cherry</code>, <code>fire</code>, <code>ocean</code>, <code>sapphire</code>, <code>slate</code> です。詳しくは
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/getting-started/#カラースキーム>カラースキーム</a>セクションを参照してください。</td></tr><tr><td><code>defaultAppearance</code></td><td><code>"light"</code></td><td>デフォルトのテーマ外観、 <code>light</code> または <code>dark</code> のいずれか。</td></tr><tr><td><code>autoSwitchAppearance</code></td><td><code>true</code></td><td>テーマの外観を訪問者のオペレーティングシステムの設定に基づいて自動的に切り替えるかどうか。常に <code>defaultAppearance</code> を使うようにするには <code>false</code> を設定します。</td></tr><tr><td><code>enableSearch</code></td><td><code>false</code></td><td>サイト内検索を有効にするかどうか。検索機能を有効にするには <code>true</code> を設定します。検索機能は、
|
|
|
|
<a href=#%e3%82%b5%e3%82%a4%e3%83%88%e8%a8%ad%e5%ae%9a>サイト設定</a>の <code>outputs.home</code> が正しく設定されているかどうかに依存することに注意してください。</td></tr><tr><td><code>enableCodeCopy</code></td><td><code>false</code></td><td><code><code></code> ブロックに対してクリップボードへのコピーボタンを有効にするかどうか。 <code>highlight.noClasses</code> が <code>false</code> に設定されていなければ、コードコピーは正しく機能しません。
|
2024-01-21 22:23:05 +00:00
|
|
|
<a href=#%e3%81%9d%e3%81%ae%e4%bb%96%e3%81%ae%e8%a8%ad%e5%ae%9a%e3%83%95%e3%82%a1%e3%82%a4%e3%83%ab>その他の設定ファイル</a>については以下を参照してください。</td></tr><tr><td><code>enableImageLazyLoading</code></td><td><code>true</code></td><td>ブラウザが遅延ロードするように画像をマークするかどうか。</td></tr><tr><td><code>robots</code></td><td><em>Not set</em></td><td>ロボットがあなたのサイトをどのように扱うべきかを示す文字列。設定された場合、 <code><head></code> に出力されます。有効な値については
|
|
|
|
<a href=https://developers.google.com/search/docs/advanced/robots/robots_meta_tag#directives target=_blank rel=noreferrer>Googleのドキュメント</a>を参照してください。</td></tr><tr><td><code>fingerprintAlgorithm</code></td><td><code>"sha256"</code></td><td><code>assets</code> にフィンガープリントを行う際のハッシュアルゴリズム。有効なオプションは <code>md5</code>、<code>sha256</code>、<code>sha384</code> および <code>sha512</code> です。</td></tr><tr><td><code>header.layout</code></td><td><code>"basic"</code></td><td>ヘッダーとメニューのレイアウト。有効な値は <code>basic</code>、<code>hamburger</code>、<code>hybrid</code>または<code>custom</code>です。 <code>custom</code> に設定した場合は、 <code>/layouts/partials/header/custom.html</code> ファイルを作成して独自のレイアウトを指定する必要があります。</td></tr><tr><td><code>header.logo</code></td><td><em>Not set</em></td><td><code>assets/</code> 内のロゴファイルへの相対パス。ロゴファイルは2倍の解像度で提供され、任意の画像サイズに対応している必要があります。</td></tr><tr><td><code>header.logoDark</code></td><td><em>Not set</em></td><td><code>dark</code> モード時に使用されるロゴファイルへの相対パス。</td></tr><tr><td><code>header.showTitle</code></td><td><code>true</code></td><td>サイトのタイトルをヘッダーに表示するかどうか。</td></tr><tr><td><code>footer.showCopyright</code></td><td><code>true</code></td><td>サイトフッターにコピーライト文字列を表示するかどうか。
|
2023-10-26 02:58:10 +00:00
|
|
|
<a href=#%e8%a8%80%e8%aa%9e%e3%81%a8%e5%9b%bd%e9%9a%9b%e5%8c%96>言語と国際化</a>の <code>copyright</code> パラメーターを使って文字列自体をカスタマイズできます。</td></tr><tr><td><code>footer.showThemeAttribution</code></td><td><code>true</code></td><td>“Powered by Hugo & Congo” といった帰属表示をフッターに表示するかどうか。この表示を無効にする場合は、サイト上の他の場所(例えば、アバウトページなど)でテーマの帰属を表示することを検討してください。</td></tr><tr><td><code>footer.showAppearanceSwitcher</code></td><td><code>false</code></td><td>フッターに外観スイッチャーを表示するかどうか。訪問者の設定を保持するためにブラウザのローカルストレージが使用されます。</td></tr><tr><td><code>footer.showScrollToTop</code></td><td><code>true</code></td><td><code>true</code> に設定すると、最上部にスクロールする矢印が表示されます。</td></tr><tr><td><code>homepage.layout</code></td><td><code>"page"</code></td><td>ホームページのレイアウト。有効な値は <code>page</code>, <code>profile</code> または <code>custom</code> です。 <code>custom</code> に設定した場合は、 <code>/layouts/partials/home/custom.html</code> ファイルを作成して、独自のレイアウトを指定する必要があります。詳しくは
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/homepage-layout/>ホームページレイアウト</a>セクションを参照してください。</td></tr><tr><td><code>homepage.showRecent</code></td><td><code>false</code></td><td>ホームページに最近の記事リストを表示するかどうか。</td></tr><tr><td><code>homepage.recentLimit</code></td><td><code>5</code></td><td><code>homepage.showRecent</code> が <code>true</code> の場合に表示する最近の記事の最大数。</td></tr><tr><td><code>article.showDate</code></td><td><code>true</code></td><td>記事が作成された日付を表示するかどうか。</td></tr><tr><td><code>article.showDateUpdated</code></td><td><code>false</code></td><td>記事が更新された日付を表示するかどうか。</td></tr><tr><td><code>article.showAuthor</code></td><td><code>true</code></td><td>記事フッターに著者欄を表示するかどうか。</td></tr><tr><td><code>article.showBreadcrumbs</code></td><td><code>false</code></td><td>記事のヘッダーにパンくずリストを表示するかどうか。</td></tr><tr><td><code>article.showDraftLabel</code></td><td><code>true</code></td><td><code>--buildDrafts</code> でビルドしたときに、記事の横に下書きインジケータを表示するかどうか。</td></tr><tr><td><code>article.showEdit</code></td><td><code>false</code></td><td>記事の内容を編集するためのリンクを表示するかどうか。</td></tr><tr><td><code>article.editURL</code></td><td><em>Not set</em></td><td><code>article.showEdit</code> がアクティブな場合の編集リンクのURL。</td></tr><tr><td><code>article.editAppendPath</code></td><td><code>true</code></td><td><code>article.editURL</code>で設定されたURLに現在の記事へのパスを追加するかどうか。</td></tr><tr><td><code>article.showHeadingAnchors</code></td><td><code>true</code></td><td>見出しアンカーリンクを記事内の見出しと一緒に表示するかどうか。</td></tr><tr><td><code>article.showPagination</code></td><td><code>true</code></td><td>記事のフッターに次/前の記事リンクを表示するかどうか。</td></tr><tr><td><code>article.invertPagination</code></td><td><code>false</code></td><td>次の記事/前の記事リンクの向きを反転させるかどうか。</td></tr><tr><td><code>article.showReadingTime</code></td><td><code>true</code></td><td>記事の予想読了時間を表示するかどうか。</td></tr><tr><td><code>article.showTableOfContents</code></td><td><code>false</code></td><td>記事に目次を表示するかどうか。</td></tr><tr><td><code>article.showTaxonomies</code></td><td><code>false</code></td><td>この記事に関連するTaxonomiesを表示するかどうか。</td></tr><tr><td><code>article.showWordCount</code></td><td><code>false</code></td><td>記事の単語数を表示するかどうか。</td></tr><tr><td><code>article.showComments</code></td><td><code>false</code></td><td><a href=https://jpanther.github.io/congo/ja/docs/partials/#コメント>コメント</a>を記事フッターの後に含めるかどうか。</td></tr><tr><td><code>article.sharingLinks</code></td><td><em>Not set</em></td><td>各記事の最後に共有リンクを表示するかどうか。 <code>false</code> にすると共有リンクは表示されません。</td></tr><tr><td><code>list.showBreadcrumbs</code></td><td><code>false</code></td><td>リストページのヘッダーにパンくずリストを表示するかどうか。</td></tr><tr><td><code>list.showTableOfContents</code></td><td><code>false</code></td><td>リストページに目次を表示するかどうか。</td></tr><tr><td><code>list.showTaxonomies</code></td><td><code>false</code></td><td>リストページに関連するTaxonomiesを表示するかどうか。</td></tr><tr><td><code>list.showSummary</code></td><td><code>false</code></td><td>リストページに記事の要約を表示するかどうか。もし
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/front-matter/>フロントマター</a>で要約が提供されていない場合、
|
2024-01-21 22:23:05 +00:00
|
|
|
<a href=#%e3%82%b5%e3%82%a4%e3%83%88%e8%a8%ad%e5%ae%9a>サイト設定</a>の <code>summaryLength</code> パラメーターを使って要約が自動生成されます。</td></tr><tr><td><code>list.groupByYear</code></td><td><code>true</code></td><td>リストページで記事を年ごとにグループ化するかどうか。</td></tr><tr><td><code>list.paginationWidth</code></td><td><code>1</code></td><td>リストページを切り詰める際に、現在のページの両側にいくつのページネーションリンクを出力するか。 <code>1</code> の場合、現在のページの両側に1つのリンクを出力します。 <em>最初のページ</em> と <em>最後のページ</em> へのリンクは常に表示され、この値に追加されます。</td></tr><tr><td><code>sitemap.excludedKinds</code></td><td><code>["taxonomy", "term"]</code></td><td>生成される <code>/sitemap.xml</code> から除外されるべきコンテンツの種類。許容される値については
|
|
|
|
<a href=https://gohugo.io/templates/section-templates/#page-kinds target=_blank rel=noreferrer>Hugo docs</a>を参照してください。</td></tr><tr><td><code>taxonomy.showTermCount</code></td><td><code>true</code></td><td>TaxonomiesのリストにTermごとの記事数を表示するかどうか。</td></tr><tr><td><code>fathomAnalytics.site</code></td><td><em>Not set</em></td><td>Fathom Analyticsによって生成されたウェブサイトのサイトコード。詳細は
|
|
|
|
<a href=https://jpanther.github.io/congo/ja/docs/partials/#アナリティクス>アナリティクス</a>を参照してください。</td></tr><tr><td><code>verification.google</code></td><td><em>Not set</em></td><td>サイトのメタデータに含めるGoogleが提供するサイト検証文字列。</td></tr><tr><td><code>verification.bing</code></td><td><em>Not set</em></td><td>サイトのメタデータに含めるBingが提供するサイト検証文字列。</td></tr><tr><td><code>verification.pinterest</code></td><td><em>Not set</em></td><td>サイトのメタデータに含めるPinterestが提供するサイト検証文字列。</td></tr><tr><td><code>verification.yandex</code></td><td><em>Not set</em></td><td>サイトのメタデータに含めるYandexが提供するサイト検証文字列。</td></tr></tbody></table><h2 id=その他の設定ファイル class="relative group">その他の設定ファイル <span class="absolute top-0 w-6 transition-opacity opacity-0 -start-6 not-prose group-hover:opacity-100"><a class="group-hover:text-primary-300 dark:group-hover:text-neutral-700" style=text-decoration-line:none!important href=#%e3%81%9d%e3%81%ae%e4%bb%96%e3%81%ae%e8%a8%ad%e5%ae%9a%e3%83%95%e3%82%a1%e3%82%a4%e3%83%ab aria-label=アンカー>#</a></span></h2><p>このテーマには <code>markup.toml</code> 設定ファイルも含まれています。このファイルにはいくつかの重要なパラメータが含まれており、Congoで構築されたサイトを生成するためにHugoが正しく設定されるようにします。</p><p>このファイルがconfigディレクトリに存在し、必要な値が設定されていることを常に確認してください。これを行わないと、特定の機能が正しく動作しなかったり、意図しない動作になったりする可能性があります。</p></div></section><footer class="max-w-prose pt-8 print:hidden"><div class=pt-8><hr class="border-dotted border-neutral-300 dark:border-neutral-600"><div class="flex justify-between pt-3"><span><a class="group flex" href=/congo/ja/docs/getting-started/><span class="me-2 text-neutral-700 transition-transform group-hover:-translate-x-[2px] group-hover:text-primary-600 dark:text-neutral dark:group-hover:text-primary-400"><span class="ltr:inline rtl:hidden">←</span><span class="ltr:hidden rtl:inline">→</span></span>
|
2023-10-22 23:23:53 +00:00
|
|
|
<span class="flex flex-col"><span class="mt-[0.1rem] leading-6 group-hover:underline group-hover:decoration-primary-500">はじめに</span>
|
|
|
|
<span class="mt-[0.1rem] text-xs text-neutral-500 dark:text-neutral-400"></span></span></a></span><span><a class="group flex text-right" href=/congo/ja/docs/homepage-layout/><span class="flex flex-col"><span class="mt-[0.1rem] leading-6 group-hover:underline group-hover:decoration-primary-500">ホームページレイアウト</span>
|
2024-01-21 22:23:05 +00:00
|
|
|
<span class="mt-[0.1rem] text-xs text-neutral-500 dark:text-neutral-400"></span></span><span class="ms-2 text-neutral-700 transition-transform group-hover:-translate-x-[2px] group-hover:text-primary-600 dark:text-neutral dark:group-hover:text-primary-400"><span class="ltr:inline rtl:hidden">→</span><span class="ltr:hidden rtl:inline">←</span></span></a></span></div></div></footer></article><div class="pointer-events-none absolute bottom-0 end-0 top-[100vh] w-12"><a href=#the-top class="pointer-events-auto sticky top-[calc(100vh-5.5rem)] flex h-12 w-12 items-center justify-center rounded-full bg-neutral/50 text-xl text-neutral-700 backdrop-blur hover:text-primary-600 dark:bg-neutral-800/50 dark:text-neutral dark:hover:text-primary-400" aria-label=TOPへスクロール title=TOPへスクロール>↑</a></div></main><footer class="py-10 print:hidden"><div class="flex items-center justify-between"><div><p class="text-sm text-neutral-500 dark:text-neutral-400">© 2023 Congo contributors</p><p class="text-xs text-neutral-500 dark:text-neutral-400">Powered by <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500" href=https://gohugo.io/ target=_blank rel="noopener noreferrer">Hugo</a> & <a class="hover:underline hover:decoration-primary-400 hover:text-primary-500" href=https://github.com/jpanther/congo target=_blank rel="noopener noreferrer">Congo</a></p></div><div class="flex flex-row items-center"><div class="me-14 cursor-pointer text-sm text-neutral-700 hover:text-primary-600 dark:text-neutral dark:hover:text-primary-400"><button id=appearance-switcher-0 type=button aria-label="appearance switcher"><div class="flex h-12 w-12 items-center justify-center dark:hidden" title=ダークモードへ切り替え><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M32 256C32 132.2 132.3 32 255.8 32c11.36.0 29.7 1.668 40.9 3.746 9.616 1.777 11.75 14.63 3.279 19.44C245 86.5 211.2 144.6 211.2 207.8c0 109.7 99.71 193 208.3 172.3 9.561-1.805 16.28 9.324 10.11 16.95C387.9 448.6 324.8 480 255.8 480 132.1 480 32 379.6 32 256z"/></svg></span></div><div class="hidden h-12 w-12 items-center justify-center dark:flex" title=ライトモードへ切り替え><span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentcolor" d="M256 159.1c-53.02.0-95.1 42.98-95.1 95.1s41.2 96.9 95.1 96.9 95.1-42.98 95.1-95.1S309 159.1 256 159.1zM509.3 347l-63.2-91.9 63.15-91.01c6.332-9.125 1.104-21.74-9.826-23.72l-109-19.7-19.7-109c-1.975-10.93-14.59-16.16-23.72-9.824L256 65.89 164.1 2.736c-9.125-6.332-21.74-1.107-23.72 9.824L121.6 121.6 12.56 141.3C1.633 143.2-3.596 155.9 2.736 164.1L65.89 256 2.74 347.01c-6.332 9.125-1.105 21.74 9.824 23.72l109 19.7 19.7 109c1.975 10.93 14.59 16.16 23.72 9.824L256 446.1l91.01 63.15c9.127 6.334 21.75 1.107 23.72-9.822l19.7-109 109-19.7C510.4 368.8 515.6 356.1 509.3 347zM256 383.1c-70.69.0-127.1-57.31-127.1-127.1.0-70.69 57.31-127.1 127.1-127.1S383.1 186.2 383.1 256c0 70.7-56.4 127.1-127.1 127.1z"/></svg></span></div></button></div></div></div></footer><div id=search-wrapper class="invisible fixed inset-0 z-50 flex h-screen w-screen cursor-default flex-col bg-neutral-500/50 p-4 backdrop-blur-sm sm:p-6 md:p-[10vh] lg:p-[12vh] dark:bg-neutral-900/50" data-url=https://jpanther.github.io/congo/ja/><div id=search-modal class="top-20 mx-auto flex min-h-0 w-full max-w-3xl flex-col rounded-md border border-neutral-200 bg-neutral shadow-lg dark:border-neutral-700 dark:bg-neutral-800"><header class="relative z-10 flex flex-none items-center justify-between px-2"><form class="flex min-w-0 flex-auto items-center"><div class="flex h-8 w-8 items-center justify-center text-neutral-400"><span class="icon relative inline-block px-1 align-text-bottom"><svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="search" class="svg-inline--fa fa-search fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0
|
|
|
|
<span class="icon relative inline-block px-1 align-text-bottom"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><path fill="currentcolor" d="M310.6 361.4c12.5 12.5 12.5 32.75.0 45.25C304.4 412.9 296.2 416 288 416s-16.38-3.125-22.62-9.375L160 301.3 54.63 406.6C48.38 412.9 40.19 416 32 416S15.63 412.9 9.375 406.6c-12.5-12.5-12.5-32.75.0-45.25l105.4-105.4L9.375 150.6c-12.5-12.5-12.5-32.75.0-45.25s32.75-12.5 45.25.0L160 210.8l105.4-105.4c12.5-12.5 32.75-12.5 45.25.0s12.5 32.75.0 45.25l-105.4 105.4L310.6 361.4z"/></svg></span></button></header><section class="flex-auto overflow-auto px-2"><ul id=search-results></ul></section></div></div></div></body></html>
|