はじめに

Hugo でブログサイトを作ってみたけれど、サマリーが大きすぎるので行数を減らしたかった。結論は以下の通り。

• config.toml の頭に hasCJKLanguage = true を入れる
• もしくは、 各々の markdown ファイルの先頭で isCJKLanguage = true を入れる

そこまで辿り着くまでの話です。 尚、ドキュメントに明記されてました。恥ずかしいっ (*ノノ

• https://gohugo.io/overview/configuration

# if true, auto-detect Chinese/Janapese/Korean Languages in the content.
 (.Summary and .WordCount can work properly in CJKLanguage)
hasCJKLanguage              false

• https://gohugo.io/content/front-matter

**isCJKLanguage** If true, explicitly treat the content as CJKLanguage
 (.Summary and .WordCount can work properly in CJKLanguage)

Hugo のサマリーの実例

デフォルトだと以下のようにサマリーが巨大になります。

hasCJK 又は isCJK の設定を入れると以下のように自然なサイズになります。

サマリーの仕様

• https://gohugo.io/content/summaries/

By default, Hugo automatically takes the first 70 words of your content as its
summary and stores it into the .Summary variable, which you may use in your
templates.

単語を70個だけ表示するそうです。 By default なので値を 70 以外に変える方法があると推測し、ドキュメントを漁りましたが見つかりません。

仕方ないので、実装を見る事にします。

• https://github.com/spf13/hugo

実装

• github.com/spf13/hugo/hugolib/page.go

if p.isCJKLanguage {
	summary, truncated = helpers.TruncateWordsByRune(p.PlainWords(), helpers.SummaryLength)
} else {
	summary, truncated = helpers.TruncateWordsToWholeSentence(p.PlainWords(), helpers.SummaryLength)
}

削る処理では helper で定義している SummaryLength を参照しています。

• github.com/spf13/hugo/helpers/content.go

// Length of the summary that Hugo extracts from a content.
var SummaryLength = 70

この SummaryLength を上書きする処理が何処にも無いので、設定で単語数を減らす事は出来なさそうです。(結論からいうと、そもそも数を減らす対策は間違えてる)

よくよく見返すと、

if p.isCJKLanguage {
	summary, truncated = helpers.TruncateWordsByRune(

CJK (中国語、日本語、韓国語をひっくるめた総称) と判定した場合に、マルチバイト文字を意識して単語毎に分割してます。それ以外だとアルファベット等として空白で分割でしょう。

日本語は単語の間に空白を挟みません。単語が連結して見えて少なく数えてしまっているようです。 さて、この isCJKLanguage は何処で設定されるのでしょう。

• github.com/spf13/hugo/hugolib/page.go

case "iscjklanguage":
	isCJKLanguage = new(bool)
	*isCJKLanguage = cast.ToBool(v)

if isCJKLanguage != nil {
	p.isCJKLanguage = *isCJKLanguage
} else if viper.GetBool("HasCJKLanguage") {
	if cjk.Match(p.rawContent) {
		p.isCJKLanguage = true
	} else {
		p.isCJKLanguage = false
	}
}

設定キーワードらしい文字列が見つかりましたし、これ以上ソースを見るのは面倒なので、後はドキュメントを検索しました。

$ cd github.com/spf13/hugo
$ grep -ri iscjklanguage docs
docs/content/content/front-matter.md:* **isCJKLanguage** If true, explicitly treat the content as CJKLanguage (.Summary and .WordCount can work properly in CJKLanguage)
$ grep -ri hascjklanguage  docs
docs/content/overview/configuration.md:    hasCJKLanguage              false

後は対応する URL を開いて確認するだけです。(冒頭で紹介した URL)

• https://gohugo.io/overview/configuration
• https://gohugo.io/content/front-matter

以上、 同じ罠にハマった方のお役に立てれば幸いです！