Hugo でドラフトページを作成する

ドラフト記事

Hugo のドラフト機能は、未完成の記事ファイルを一時的にほかの記事と同じ場所に保存しておくための機能です。 ページの Front matter 部分に、draft: true という記述があると、そのページはドラフトとして扱われます。

---
draft: true
---

本文

+++
draft = true
+++

本文

ドラフトとして作成された記事は、デフォルトでは HTML ファイルとして出力されません。 ドラフト記事も出力するようにするには、hugo コマンドに -D (--buildDrafts) オプションを指定します。

$ hugo -D         # サイトを生成する場合
$ hugo server -D  # サーバーを立ち上げる場合

public ディレクトリに出力されたドラフト記事に注意

hugo コマンドは、デフォルトで public ディレクトリに HTML ファイルなどを出力しますが、このとき、public ディレクトリ内に既に存在するドラフト記事を削除することはありません。

$ hugo -D  # ここでドラフト記事も含めて生成される
$ hugo     # 次にドラフトモード OFF で生成しても、既存のドラフト記事が削除されない

Web サイトを公開するときは、ドラフト記事が間違ってアップロードされないように気を付けてください。 記事のアップロード前は、public ディレクトリを削除してから hugo コマンドで再生成すると安全です。

$ rm -Rf public && hugo

C:\> rmdir /s /q public & hugo

ドラフト記事の一覧を表示する

コマンドラインから

コマンドラインで hugo list drafts と実行すると、contents ディレクトリ内の記事のうち、ドラフトとしてマークされている（フロントマターに draft: true と記述されている）ファイルの一覧を確認することができます。

$ hugo list drafts
draft.md
diaries/temp.md
books/work-shift.md

• 参考: hugo list drafts｜Hugo

テンプレートから

テンプレートファイル内で、ドラフト記事のリンクを列挙するには以下のようにします。

<h2>ドラフト記事の一覧</h2>
<ul>
  {{ range (where .Site.Pages ".Draft" true) }}
    <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
  {{ end }}
</ul>

テンプレートの中でドラフト記事かどうかを判別する

テンプレートファイル の中で、今レンダリングしている記事がドラフトである（フロントマターに draft: true と記述されている）かどうかを調べるには、Page 変数 の .Draft を参照します。

<h1>{{ .Title }}</h1>
{{ if .Draft }}
  <b>注: この記事はまだドラフトです。</b>
{{ end }}