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 1.xからのアップグレード · Congo</title>
|
2024-03-09 04:37:45 +00:00
|
|
|
<meta name=title content="Congo 1.xからのアップグレード · 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.8cd4199ad423a763e2dd42a32c20643d8eb472bc550188be85b60444140826dd.css integrity="sha256-jNQZmtQjp2Pi3UKjLCBkPY60crxVAYi+hbYERBQIJt0="><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 1.xからのアップグレード
|
2024-03-09 04:37:45 +00:00
|
|
|
"><link rel=canonical href=https://jpanther.github.io/congo/ja/docs/version-2/upgrade/><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="Congo 1.xからのアップグレード"><meta property="og:description" content="Congo 1.xからのアップグレード"><meta property="og:type" content="article"><meta property="og:url" content="https://jpanther.github.io/congo/ja/docs/version-2/upgrade/"><meta property="article:section" content="docs"><meta property="article:published_time" content="2022-01-20T00:00:00+00:00"><meta property="article:modified_time" content="2022-01-20T00:00:00+00:00"><meta name=twitter:card content="summary"><meta name=twitter:title content="Congo 1.xからのアップグレード"><meta name=twitter:description content="Congo 1.xからのアップグレード"><script type=application/ld+json>{"@context":"https://schema.org","@type":"Article","articleSection":"ドキュメント","name":"Congo 1.xからのアップグレード","headline":"Congo 1.xからのアップグレード","description":"Congo 1.xからのアップグレード","abstract":"Congo 2.","inLanguage":"ja","url":"https:\/\/jpanther.github.io\/congo\/ja\/docs\/version-2\/upgrade\/","author":{"@type":"Person","name":"Congo"},"copyrightYear":"2022","dateCreated":"2022-01-20T00:00:00\u002b00:00","datePublished":"2022-01-20T00:00:00\u002b00:00","dateModified":"2022-01-20T00:00:00\u002b00:00","keywords":["new","docs"],"mainEntityOfPage":"true","wordCount":"317"}</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-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.
|
|
|
|
|
<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/version-2/upgrade/ 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/version-2/upgrade/ 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/version-2/upgrade/ 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=inline><a class="dark:underline-neutral-600 decoration-neutral-300 hover:underline" href=/congo/ja/docs/version-2/>What's New in 2.0 ✨</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/version-2/upgrade/>Congo 1.xからのアップグレード</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">Congo 1.xからのアップグレード</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=読むのに必要な時間>2 分</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/version-2/upgrade/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="block cursor-pointer bg-neutral-100 py-1 ps-5 text-lg font-semibold text-neutral-800 dark:bg-neutral-700 dark:text-neutral-100 lg:hidden">目次</summary><div class="border-s border-dotted border-neutral-300 py-2 ps-5 dark:border-neutral-600"><nav id=TableOfContents><ul><li><a href=#step-1-hugoのアップグレード>Step 1: Hugoのアップグレード</a></li><li><a href=#step-2-congoのアップグレード>Step 2: Congoのアップグレード</a><ul><li><a href=#upgrade-using-hugo>Upgrade using Hugo</a></li><li><a href=#upgrade-using-git>Upgrade using Git</a></li><li><a href=#upgrade-manually>Upgrade manually</a></li></ul></li><li><a href=#step-3-テーマの設定>Step 3: テーマの設定</a><ul><li><a href=#languagestoml>languages.toml</a></li><li><a href=#menustoml>menus.toml</a></li><li><a href=#configtoml>config.toml</a></li><li><a href=#markuptoml>markup.toml</a></li><li><a href=#paramstoml>params.toml</a></li></ul></li><li><a href=#step-4-assetsの移動>Step 4: assetsの移動</a></li><li><a href=#step-5-コンテンツの確認>Step 5: コンテンツの確認</a></li><li><a href=#step-6-再構築>Step 6: 再構築</a></li></ul></nav></div></details></div></div><div class="min-h-0 min-w-0 max-w-prose grow"><p>Congo 2.0には多くの変更点が含まれていますが、最新リリースへのアップグレードに必要な労力を最小限に抑えるように設計されています。</p><p>とはいえ、Version 1.xで構築された既存のサイトには、調整が必要な場合もあります。このガイドでは、そのプロセスを順を追って説明し、考慮すべき点を説明します。</p><h2 id=step-1-hugoのアップグレード class="relative group">Step 1: Hugoのアップグレード <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=#step-1-hugo%e3%81%ae%e3%82%a2%e3%83%83%e3%83%97%e3%82%b0%e3%83%ac%e3%83%bc%e3%83%89 aria-label=アンカー>#</a></span></h2><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>Congo 2.0は<strong>Hugo v0.87.0以上</strong>が必要です。</span></div><p>Congoは、Hugoの最新機能のいくつかを利用するように作られています。問題を避けるために、定期的にHugoのインストールを最新の状態に保つ必要があります。</p><p>Hugoのバージョンは <code>hugo version</code> コマンドで確認できます。あなたのプラットフォーム用の新しいリリースを入手する方法については、<a href=https://gohugo.io/getting-started/installing/ target=_blank rel=noreferrer>Hugoのドキュメント</a>をご覧ください。</p><h2 id=step-2-congoのアップグレード class="relative group">Step 2: Congoのアップグレード <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=#step-2-congo%e3%81%ae%e3%82%a2%e3%83%83%e3%83%97%e3%82%b0%e3%83%ac%e3%83%bc%e3%83%89 aria-label=アンカー>#</a></span></h2><p>Congoをアップグレードする手順は、プロジェクトにどのようにテーマを含めるかによって異なります。各手順は以下にあります。</p><ul><li><a href=#upgrade-using-hugo>Upgrade using Hugo</a></li><li><a href=#upgrade-using-git>Upgrade using Git</a></li><li><a href=#upgrade-manually>Upgrade manually</a></li></ul><h3 id=upgrade-using-hugo class="relative group">Upgrade using Hugo <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=#upgrade-using-hugo aria-label=アンカー>#</a></span></h3><p>Goモジュールを新しいメジャーリリースにアップグレードするには、 <code>modules.toml</code> と <code>go.mod</code> ファイルを更新する必要があります。それぞれのファイルで、テーマへのパスを <code>github.com/jpanther/congo</code> から <code>github.com/jpanther/congo/v2</code> に更新してください。</p><p>そして、プロジェクト・ディレクトリに移動し、以下のコマンドを実行してください。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>hugo mod get -u
|
2023-10-22 23:23:53 +00:00
|
|
|
</span></span></code></pre></div><p>Hugo がローカルにモジュールをキャッシュしているため、状況によってはこのステップで問題が発生する場合があることに注意してください。上記のコマンドがうまくいかない場合は、 <code>hugo mod clean</code> を使ってローカルキャッシュを消去し、モジュールを再ダウンロードしてみてください。</p><p>Congoがアップグレードされたら、次のステップに進みます。</p><h3 id=upgrade-using-git class="relative group">Upgrade using Git <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=#upgrade-using-git aria-label=アンカー>#</a></span></h3><p>Git サブモジュールは <code>git</code> コマンドを使ってアップグレードできます。次のコマンドを実行するだけで、最新バージョンのテーマがローカルリポジトリにダウンロードされます:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-shell data-lang=shell><span class=line><span class=cl>git submodule update --remote --merge
|
2024-03-09 04:37:45 +00:00
|
|
|
</span></span></code></pre></div><p>サブモジュールがアップデートされたら、次のステップに進みます。</p><h3 id=upgrade-manually class="relative group">Upgrade manually <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=#upgrade-manually aria-label=アンカー>#</a></span></h3><p>Congoを手動で更新するには、テーマの最新コピーをダウンロードして、プロジェクト内の古いバージョンを置き換える必要があります。</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>テーマファイルに対して行ったローカルでのカスタマイズは、この処理中に失われますのでご注意ください。</span></div><ol><li><p>テーマのソースコードの最新リリースをダウンロードする。</p><a class="inline-block !rounded-md bg-primary-600 px-4 py-1 !text-neutral !no-underline hover:!bg-primary-500 dark:bg-primary-800 dark:hover:!bg-primary-700" href=https://github.com/jpanther/congo/releases/latest target=_blank role=button>Download from Github</a></li><li><p>アーカイブを解凍し、ディレクトリ名を <code>congo</code> に変更して、Hugoプロジェクトのルートディレクトリ内の <code>themes/</code> ディレクトリに移動します。すべてのテーマファイルを置き換えるには、既存のディレクトリを上書きする必要があります。</p></li><li><p>次のステップに進んでください。</p></li></ol><h2 id=step-3-テーマの設定 class="relative group">Step 3: テーマの設定 <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=#step-3-%e3%83%86%e3%83%bc%e3%83%9e%e3%81%ae%e8%a8%ad%e5%ae%9a aria-label=アンカー>#</a></span></h2><p>Congo 2.0では新しいテーマ設定パラメーターが多数導入されています。このテーマは既存のバージョン1の設定に適応しますが、より新しいテーマ機能のいくつかを利用するためには、既存の設定を調整する必要があります。</p><p>これを行う最も簡単な方法は、テーマのデフォルト設定のコピーを取り、既存のファイルと比較することです。以下にその手順を詳しく説明します。</p><h3 id=languagestoml class="relative group">languages.toml <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=#languagestoml aria-label=アンカー>#</a></span></h3><p>多言語サポートを提供するために、言語固有のテーマパラメーターは新しい設定ファイル <code>languages.[lang-code].toml</code> に移動されました。テーマにはテンプレート <code>languages.en.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>多言語サポートが必要ない場合は、このステップは必要ありません。</span></div><p>言語設定ファイルはこのような構造になっています:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-toml data-lang=toml><span class=line><span class=cl><span class=c># config/_default/languagues.en.toml</span>
|
2023-10-22 23:23:53 +00:00
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>languageCode</span> <span class=p>=</span> <span class=s2>"en"</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>languageName</span> <span class=p>=</span> <span class=s2>"English"</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>displayName</span> <span class=p>=</span> <span class=s2>"EN"</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>htmlCode</span> <span class=p>=</span> <span class=s2>"en"</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>weight</span> <span class=p>=</span> <span class=mi>1</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>rtl</span> <span class=p>=</span> <span class=kc>false</span>
|
|
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=c># Language-specific parameters go here</span>
|
|
|
|
|
</span></span></code></pre></div><p>お好みの言語を使って、 <code>config/_default/</code> に新しいファイルを作成し、既存の設定ファイルから言語固有のパラメーターをこの新しいファイルに移動するだけです。下の表は移動させる必要のあるパラメーターの概要です。</p><table><thead><tr><th>Parameter</th><th>Old location</th></tr></thead><tbody><tr><td><code>title</code></td><td><code>config.toml</code></td></tr><tr><td><code>description</code></td><td><code>params.toml</code></td></tr><tr><td><code>copyright</code></td><td><code>config.toml</code></td></tr><tr><td><code>dateFormat</code></td><td><code>params.toml</code></td></tr><tr><td><code>[author]</code></td><td><code>config.toml</code></td></tr></tbody></table><p>値を移行したら、これらのパラメーターは元の場所から削除すべきです。</p><h3 id=menustoml class="relative group">menus.toml <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=#menustoml aria-label=アンカー>#</a></span></h3><p>テーマが言語を認識するようになったので、 <code>menus.toml</code> ファイルの名前も言語コードを含むように変更する必要があります。既存の <code>menus.toml</code> を <code>menus.[lang-code].toml</code> にリネームしてください。言語コードは前のセクションの <code>languages.toml</code> ファイルで使用したコードと同じです。</p><h3 id=configtoml class="relative group">config.toml <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=#configtoml aria-label=アンカー>#</a></span></h3><p>config.toml`ファイルには、Hugoの基本設定値のみが含まれるようになりました。上記の言語固有の文字列を削除した以外に、考慮すべき変更は2つだけです。</p><p>英語以外の言語を使用している場合は、その言語用に作成した設定ファイルの言語コードと一致する <code>defaultContentLanguage</code> 値を指定してください。次に、Congo 2.0の新しいサイト内検索を利用するために、 <code>[outputs]</code> ブロックを用意する必要があります。</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-toml data-lang=toml><span class=line><span class=cl><span class=c># config/_default/config.toml</span>
|
|
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>defaultContentLanguage</span> <span class=p>=</span> <span class=s2>"en"</span>
|
|
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>enableRobotsTXT</span> <span class=p>=</span> <span class=kc>true</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>paginate</span> <span class=p>=</span> <span class=mi>10</span>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=nx>summaryLength</span> <span class=p>=</span> <span class=mi>0</span>
|
|
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=p>[</span><span class=nx>outputs</span><span class=p>]</span>
|
|
|
|
|
</span></span><span class=line><span class=cl> <span class=nx>home</span> <span class=p>=</span> <span class=p>[</span><span class=s2>"HTML"</span><span class=p>,</span> <span class=s2>"RSS"</span><span class=p>,</span> <span class=s2>"JSON"</span><span class=p>]</span>
|
|
|
|
|
</span></span></code></pre></div><h3 id=markuptoml class="relative group">markup.toml <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=#markuptoml aria-label=アンカー>#</a></span></h3><p>Congo 2.0では記事ページの目次がサポートされました。Hugoには目次を生成するためのデフォルト設定が同梱されていますが、 <code>markup.toml</code> ファイルに新しい <code>[tableOfContents]</code> ブロックを追加することで、この動作を調整することができます。</p><p>推奨設定は以下のとおりで、目次にレベル2、3、4のの見出しを含みます:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-toml data-lang=toml><span class=line><span class=cl><span class=c># config/_default/markup.toml</span>
|
|
|
|
|
</span></span><span class=line><span class=cl>
|
|
|
|
|
</span></span><span class=line><span class=cl><span class=p>[</span><span class=nx>tableOfContents</span><span class=p>]</span>
|
|
|
|
|
</span></span><span class=line><span class=cl> <span class=nx>startLevel</span> <span class=p>=</span> <span class=mi>2</span>
|
|
|
|
|
</span></span><span class=line><span class=cl> <span class=nx>endLevel</span> <span class=p>=</span> <span class=mi>4</span>
|
2024-03-09 04:37:45 +00:00
|
|
|
</span></span></code></pre></div><h3 id=paramstoml class="relative group">params.toml <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=#paramstoml aria-label=アンカー>#</a></span></h3><p>Congo 2.0では多くの新しいテーマ・パラメーターが導入されました。既存の設定にも若干の変更が必要です。パラメーターが提供されない場合、常にデフォルト値に戻ることを覚えておいてください。</p><p>Congoでのダークモードの動作方法が変更され、より柔軟に設定できるようになりました。従来の <code>darkMode</code> と <code>darkToggle</code> パラメーターは <strong>削除され、3つの新しいパラメーターに置き換えられました</strong>。これらの新しいオプションはそれぞれ独立して動作するため、強制的に表示させることができ、またユーザーが上書きすることもできます。</p><table><thead><tr><th>New parameter</th><th>Type</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>defaultAppearance</code></td><td>String</td><td><code>"light"</code></td><td>デフォルトの外観; <code>light</code> か <code>dark</code> のどちらか。<br>⚠️ <em><code>light</code> に設定すると以前の <code>darkMode = false</code> の設定が再現され、 <code>dark</code> に設定すると <code>darkMode = true</code> の設定が再現される。</em></td></tr><tr><td><code>autoSwitchAppearance</code></td><td>Boolean</td><td><code>true</code></td><td>外観をオペレーティングシステムの環境設定に基づいて自動的に切り替えるかどうか。 <code>false</code> に設定すると、常に <code>defaultAppearance</code> を使用します。<br>⚠️ <em>これを <code>true</code> にすることで以前の <code>darkMode = "auto"</code> 設定が再現されます。</em></td></tr><tr><td><code>showAppearanceSwitcher</code></td><td>Boolean</td><td><code>false</code></td><td>外観スイッチャーをフッターに表示するかどうか。<br>⚠️ <em>この設定は <code>darkToggle</code> を置き換えます。</em></td></tr></tbody></table><p>次の表は、Version 2の新機能を制御する、その他の主要なパラメーターの概要です:</p><table><thead><tr><th>New parameter</th><th>Type</th><th>Default</th></tr></thead><tbody><tr><td><code>enableSearch</code></td><td>Boolean</td><td><code>false</code></td></tr><tr><td><code>showScrollToTop</code></td><td>Boolean</td><td><code>true</code></td></tr><tr><td><code>article.showTaxonomies</code></td><td>Boolean</td><td><code>false</code></td></tr><tr><td><code>article.showTableOfContents</code></td><td>Boolean</td><td><code>false</code></td></tr><tr><td><code>list.showTableOfContents</code></td><td>Boolean</td><td><code>false</code></td></tr></tbody></table><p>サポートされるすべてのパラメーターについては<a href=https://jpanther.github.io/congo/ja/docs/configuration/>設定</a>を参照ください。</p><h2 id=step-4-assetsの移動 class="relative group">Step 4: assetsの移動 <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=#step-4-assets%e3%81%ae%e7%a7%bb%e5%8b%95 aria-label=アンカー>#</a></span></h2><p>ファビコンを除くすべてのassetsが、Hugo Pipesにて最適化されるようになりました。テーマがあなたのファイルを見つけるためには、以前の <code>static/</code> から <code>assets/</code> ディレクトリに移動する必要があります。主に、著者画像とサイトロゴです:</p><p><code>static/me.jpg</code> <strong>→</strong> <code>assets/me.jpg</code>
|
|
|
|
|
<code>static/logo.jpg</code> <strong>→</strong> <code>assets/logo.jpg</code></p><p>著者画像やサイトロゴを提供した場合は、これらのアセットを <code>static/</code> から <code>assets/</code> に移動するだけです。同じディレクトリ構造を使用している場合、テーマはこれらのファイルがどこにあるかを自動的に認識します。新しいパスを指定したい場合は、 <code>logo</code> と <code>author.image</code> の設定値を適宜更新してください。</p><p>このステップは、プロジェクト内の静的なassetsには適用されないことに注意してください。例えば、記事内から直接リンクしているPDFファイルは静的なassetsです。これらのファイルは、Hugoがサイトを構築するときに出力ディレクトリに確実にコピーされるよう、<code>static/</code> ディレクトリに残しておく必要があります。</p><h2 id=step-5-コンテンツの確認 class="relative group">Step 5: コンテンツの確認 <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=#step-5-%e3%82%b3%e3%83%b3%e3%83%86%e3%83%b3%e3%83%84%e3%81%ae%e7%a2%ba%e8%aa%8d aria-label=アンカー>#</a></span></h2><p>Congo 2.0では <code>figure</code> ショートコードの振る舞いが変わります。記事内で <code>figure</code> を使用している場合、パラメーターを調整する必要があるかもしれません。</p><p>サポートされているパラメーターについては、<a href=https://jpanther.github.io/congo/ja/docs/shortcodes/#figure>shortcode</a>を参照してください。</p><h2 id=step-6-再構築 class="relative group">Step 6: 再構築 <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=#step-6-%e5%86%8d%e6%a7%8b%e7%af%89 aria-label=アンカー>#</a></span></h2><p>これですべての設定変更が完了したので、いよいよサイトを再構築します。 <code>hugo</code> またはあなたのビルドコマンドを実行し、すべてが期待通りに動作することを確認してください。</p><p>エラーに遭遇した場合は、設定が正しいことを確認し、<a href=https://jpanther.github.io/congo/ja/docs/>ドキュメント</a>を参照してください。テーマに同梱されている設定ファイルの例には、デフォルトのパラメーターがすべて含まれており、出発点として最適です。</p><p>🙋♀️ それでもまだ助けが必要な場合は、<a href=https://github.com/jpanther/congo/discussions target=_blank rel=noreferrer>GitHub Discussions</a>で遠慮なく質問してください。</p></div></section><footer class="max-w-prose pt-8 print:hidden"></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="noo
|
2024-01-21 22:23:05 +00:00
|
|
|
<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>
|
