HugoのテーマをSubmodule化
Tranquilpeakテーマをsubmodule化
現在、このブログでは、Hugoのtranquilpeakと言うテーマを利用し、データをGitlab管理しています。
今までは、tranquilpeakテーマをダウンロードして、そのまま利用していたので、バージョンがインストールした時点のままで更新されません。
なので、テーマをsubmodule化して、常に新しくしておくためのメモ
現在の構成
.
├── archetypes
│ └── default.md
├── config.toml
├── content
│ ├── local
│ ├── old
│ └── post
├── data
├── layouts
│ ├── _default
│ └── robots.txt
├── public
│ ├── 404.html
│ ├── archives
│ ├── categories
│ ├── images
│ ├── img
│ ├── index.html
│ ├── index.xml
│ ├── js
│ ├── page
│ ├── post
│ ├── sitemap.xml
│ ├── tags
├── resources
│ └── _gen
├── static
│ ├── css
│ └── img
├── sync.sh
└── themes
└── hugo-tranquilpeak-theme
submodule化
上記構成のtheme内のhugo-tranquilpeak-theme
を削除
hugoのルートディレクトリで、下記コマンドでsubmodule化
$ git submodule add https://github.com/kakawait/hugo-tranquilpeak-theme.git themes/tranquilpeak
すでに、hugoはgit管理しているので、このままで良いのですが、git化していなかったり、最初からHugoをインストールする場合は、下記のようなコマンドになります
$ hugo new site yourblog
$ cd $_
$ git init
$ git submodule add https://github.com/kakawait/hugo-tranquilpeak-theme.git themes/tranquilpeak
$ cp -r themes/tranquilpeak/exampleSite/* .
$ echo 'theme = "tranquilpeak"' >> config.toml
$ git add .
$ git commit -m "first commit."
注意点
テーマ名をhugo-tranquilpeak-themeからtranquilpeakへ変更したので、config.toml内でもthemeを変更しておくこと
submodule化したので、gitから引っ張ってくる時には、submodule指定すること (そのままgit cloneでは、テーマ内がダウンロードされないため)
$ git clone --recurse-submodules --depth 1 https://gitlab.com/yourname/tranquilpeak.git
- テーマが最新になるとconfig.toml内記述が変わるかもしれないので、常にChangeLogを見ること
hugo-tranquilpeak-theme/CHANGELOG.md at master · kakawait/hugo-tranquilpeak-theme