hugoを再インストールした -- blog.10rane.com

久々にblogに記事を書こうと新しいmacにhugoをインストールしたが、まったく動かなかっていたので自分用にメモ。

ちなみに構成は、Hugo本体をbitbucketのリポジトリに非公開で管理し、生成した記事(HTML)をgithub pagesで管理している。

Install Hugo

今回はhomebrewでインストール。

$ brew install hugo
$ hugo version
Hugo Static Site Generator v0.27.1 darwin/amd64 BuildDate: 2017-09-16T19:35:01+09:00

Quick Start

Add submodule

まずgithub pageでブログを公開するために、github上に生成したHTMLを管理するリポジトリをsubmoduleとして管理している。

そもそもsubmoduleの仕組みだが、git submodule addすると、リポジトリの直下に.gitmodules、.git/config、.git/modulesの３箇所に記載、ファイルが追加される。

しかし今回のように、すでにある(add moduleした)リポジトリをcloneした場合.git/modules中にファイルが存在しない。なので一旦git rm publicでsubmoduleを削除し(すると上記３ファイルの記載が消える)、再度git submodule addする。

$ git rm public
$ git submodule add git@github.com:tatsuyano/tatsuyano.github.io.git

##.gitsubmodules
[submodule "public"]
        path = public
        url = git@github.com:tatsuyano/tatsuyano.github.io.git

## .git/config
[submodule "public"]
    url = git@github.com:tatsuyano/tatsuyano.github.io.git

## git/modules
$ ll .git/modules/
drwxr-xr-x  13 noguchi  staff   442B Sep 18 19:50 public //<-追加される
drwxr-xr-x   4 noguchi  staff   136B Sep 18 20:20 themes

Git のさまざまなツール - サブモジュール

version 0.15から静的ファイル(public)が自動生成されなくなった

そのためまずhugo server --renderToDisk=trueでpublic配下にHTMLファイルを生成してから、deploy(githubにpush)する必要がでてきた。

$ hugo version
Hugo Static Site Generator v0.27.1 darwin/amd64 BuildDate: 2017-09-16T19:35:01+09:00

$ hugo server --renderToDisk=true

Hugo の public フォルダへの生成が v0.15 から変更に

ローカルで確認してからdeploy

hugo serverでローカル( http://localhost:1313 )で確認し終わったら、いつもどおりdeploy.shでgithubにpushし、github pagesでblogを公開する。

$ sh .deploy.sh