はじめに

テンプレートからクイックスタート

 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

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

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

git submodule update --init

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

git submodule update --remote

git submodule update --remote themes/hextra

次へ

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