2023-11-04 23:14:50 +00:00
|
|
|
[{"content":"Congo 2.0には多くの変更点が含まれていますが、最新リリースへのアップグレードに必要な労力を最小限に抑えるように設計されています。\nとはいえ、Version 1.xで構築された既存のサイトには、調整が必要な場合もあります。このガイドでは、そのプロセスを順を追って説明し、考慮すべき点を説明します。\nStep 1: Hugoのアップグレード # Congo 2.0はHugo v0.87.0以上が必要です。 Congoは、Hugoの最新機能のいくつかを利用するように作られています。問題を避けるために、定期的にHugoのインストールを最新の状態に保つ必要があります。\nHugoのバージョンは hugo version コマンドで確認できます。あなたのプラットフォーム用の新しいリリースを入手する方法については、Hugoのドキュメントをご覧ください。\nStep 2: Congoのアップグレード #Congoをアップグレードする手順は、プロジェクトにどのようにテーマを含めるかによって異なります。各手順は以下にあります。\nUpgrade using Hugo Upgrade using Git Upgrade manually Upgrade using Hugo #Goモジュールを新しいメジャーリリースにアップグレードするには、 modules.toml と go.mod ファイルを更新する必要があります。それぞれのファイルで、テーマへのパスを github.com/jpanther/congo から github.com/jpanther/congo/v2 に更新してください。\nそして、プロジェクト・ディレクトリに移動し、以下のコマンドを実行してください。\nhugo mod get -u Hugo がローカルにモジュールをキャッシュしているため、状況によってはこのステップで問題が発生する場合があることに注意してください。上記のコマンドがうまくいかない場合は、 hugo mod clean を使ってローカルキャッシュを消去し、モジュールを再ダウンロードしてみてください。\nCongoがアップグレードされたら、次のステップに進みます。\nUpgrade using Git #Git サブモジュールは git コマンドを使ってアップグレードできます。次のコマンドを実行するだけで、最新バージョンのテーマがローカルリポジトリにダウンロードされます:\ngit submodule update --remote --merge サブモジュールがアップデートされたら、次のステップに進みます。\nUpgrade manually #Congoを手動で更新するには、テーマの最新コピーをダウンロードして、プロジェクト内の古いバージョンを置き換える必要があります。\nテーマファイルに対して行ったローカルでのカスタマイズは、この処理中に失われますのでご注意ください。 テーマのソースコードの最新リリースをダウンロードする。\nDownload from Github アーカイブを解凍し、ディレクトリ名を congo に変更して、Hugoプロジェクトのルートディレクトリ内の themes/ ディレクトリに移動します。すべてのテーマファイルを置き換えるには、既存のディレクトリを上書きする必要があります。\n次のステップに進んでください。\nStep 3: テーマの設定 #Congo 2.0では新しいテーマ設定パラメーターが多数導入されています。このテーマは既存のバージョン1の設定に適応しますが、より新しいテーマ機能のいくつかを利用するためには、既存の設定を調整する必要があります。\nこれを行う最も簡単な方法は、テーマのデフォルト設定のコピーを取り、既存のファイルと比較することです。以下にその手順を詳しく説明します。\nlanguages.toml #多言語サポートを提供するために、言語固有のテーマパラメーターは新しい設定ファイル languages.[lang-code].toml に移動されました。
|