デモサイトを確認したい(exampleSite

1$ cd ~/repos/sandbox/ # テスト用のディレクトリ
2$ git clone テーマのリポジトリ テーマ名
3$ cd テーマ名/exampleSite/
4$ hugo server --themesDir ../..

Hugoのギャラリーにあるテーマの多くは、Netlifyなどでホストされているデモサイトが確認できるようになっています。

このデモサイトは、ローカル環境で構築でき、編集を加えることができます。 自分が作成したいサイトの用途に合っているかどうかを、より具体的に確認するのに役立ちます。

テーマには、exampleSiteというデモサイトを構築するためのディレクトリがあります。 そのディレクトリに移動し、テーマがあるディレクトリを指定(--themesDir ../../)して、ローカルサーバーを起動(hugo server)します。 exampleSite/config.tomlの設定内容にしたがってデモサイトが立ち上がります。 サイトのタイトルや言語設定を編集します。

注釈

もし、exampleSiteのディレクトリがない場合、そのテーマは選ばないほうがいいかもしれないです

デモサイトを確認&編集して、使えそうだなと感じた場合は、自分のプロジェクトのthemes/にインストールします。 その後exampleSite/config.tomlを、プロジェクトのルートにコピペして編集します。

1$ cd themes/
2$ git clone テーマのリポジトリURL テーマ名
3$ git rm -rf themes/テーマ名/.git/
4$ cp themes/テーマ名/exampleSite/config.toml .
5$ code config.toml

config.tomlにはHugoの基本設定になっている項目と、テーマ固有の項目があります。 テーマのドキュメントが充実していればそこを読みましょう。 充実してなさそうであれば、テーマのソース内を検索しながら、使い方を紐解いていく必要があります。