はじめに

テンプレートから始める

 imfing/hextra-starter-template

上記のテンプレートリポジトリを使用して、すぐに始めることができます。

GitHub Actions ワークフローを提供しており、サイトを自動的にビルドして GitHub Pages にデプロイし、無料でホストすることができます。 その他のオプションについては、サイトのデプロイを確認してください。

🌐 デモ ↗

新規プロジェクトとして始める

Hugo プロジェクトに Hextra テーマを追加する主な方法は2つあります:

1. Hugo モジュール (推奨): 最も簡単で推奨される方法です。Hugo モジュールを使用すると、テーマをオンラインソースから直接取り込むことができます。テーマは自動的にダウンロードされ、Hugo によって管理されます。

2. Git サブモジュール: または、Hextra を Git サブモジュールとして追加します。テーマは Git によってダウンロードされ、プロジェクトの themes フォルダに保存されます。

Hugo モジュールとして Hextra をセットアップ

前提条件

開始する前に、以下のソフトウェアがインストールされている必要があります:

• Hugo (拡張版)
• Git
• Go

手順

hugo new site my-site --format=yaml

# Hugo モジュールを初期化
cd my-site
hugo mod init github.com/username/my-site

# Hextra テーマを追加
hugo mod get github.com/imfing/hextra

module:
  imports:
    - path: github.com/imfing/hextra

hugo new content/_index.md
hugo new content/docs/_index.md

hugo server --buildDrafts --disableFastRender

hugo mod get -u

hugo mod get -u github.com/imfing/hextra

Git サブモジュールとして Hextra をセットアップ

前提条件

開始する前に、以下のソフトウェアがインストールされている必要があります:

• Hugo (拡張版)
• Git

手順

hugo new site my-site --format=yaml

cd my-site
git init

git submodule add https://github.com/imfing/hextra.git themes/hextra

theme: hextra

hugo new content/_index.md
hugo new content/docs/_index.md

hugo server --buildDrafts --disableFastRender

Hugo ウェブサイトのデプロイに CI/CD を使用する場合、hugo コマンドを実行する前に以下のコマンドを実行することが重要です。

git submodule update --init

このコマンドを実行しないと、テーマフォルダに Hextra テーマファイルが配置されず、ビルドが失敗します。

git submodule update --remote

git submodule update --remote themes/hextra

次に

以下のセクションを探索して、さらにコンテンツを追加しましょう: