Hugo 文章不显示怎么办：排查草稿、发布时间、过期时间与输出路径

hugo version
python3 --version
hugo list all --help
hugo list published --help

hugo_config=hugo.toml
audit_dir=$(mktemp -d)
trap 'rm -rf -- "$audit_dir"' EXIT
hugo list all --config "$hugo_config" > "$audit_dir/all.csv"
hugo list published --config "$hugo_config" > "$audit_dir/published.csv"
python3 - "$audit_dir" <<'PY_AUDIT'
import csv
from pathlib import Path
import sys

root = Path(sys.argv[1])
with (root / "published.csv").open(encoding="utf-8", newline="") as stream:
    published = {row["path"] for row in csv.DictReader(stream)}
with (root / "all.csv").open(encoding="utf-8", newline="") as stream:
    for row in csv.DictReader(stream):
        if row["kind"] == "page" and row["path"] not in published:
            print(row["path"])
            for key in ("draft", "date", "publishDate", "expiryDate", "permalink"):
                print(f"  {key}: {row[key]}")
PY_AUDIT

content/posts/new-guide.md
  draft: false
  date: 2024-01-01T00:00:00Z
  publishDate: 2030-01-01T00:00:00Z
  expiryDate: 0001-01-01T00:00:00Z
  permalink: https://example.org/new-guide/

preview_dir=$(mktemp -d)
hugo --config "$hugo_config" --destination "$preview_dir"
find "$preview_dir" -type f -name '*.html' | head -n 20
printf 'Preview directory: %s\n' "$preview_dir"

diagnostic_dir=$(mktemp -d)
hugo --config "$hugo_config" --buildDrafts --buildFuture --buildExpired \
  --destination "$diagnostic_dir"
printf 'Diagnostic directory: %s\n' "$diagnostic_dir"

rm -rf -- "$preview_dir" "$diagnostic_dir"

"""Verify Hugo visibility rules in a temporary site. Python 3.9+."""
import csv
import io
from pathlib import Path
import subprocess
from tempfile import TemporaryDirectory

CLOCK = "2026-01-01T00:00:00Z"


def run_hugo(root, *args):
    result = subprocess.run(
        ["hugo", "--source", str(root), "--clock", CLOCK, *args],
        check=True, capture_output=True, text=True, encoding="utf-8", timeout=60,
    )
    return result.stdout


with TemporaryDirectory(prefix="hugo-visibility-") as work:
    root = Path(work)
    (root / "content").mkdir()
    layouts = root / "layouts" / "_default"
    layouts.mkdir(parents=True)
    (root / "hugo.toml").write_text(
        'baseURL = "https://example.org/"\n'
        'disableKinds = ["home", "taxonomy", "term", "RSS", "sitemap"]\n',
        encoding="utf-8",
    )
    (layouts / "single.html").write_text(
        "<!doctype html><title>{{ .Title }}</title>{{ .Content }}",
        encoding="utf-8",
    )
    cases = {
        "visible": "",
        "draft": "draft: true\n",
        "future": "publishDate: 2030-01-01T00:00:00Z\n",
        "expired": "expiryDate: 2020-01-01T00:00:00Z\n",
    }
    for name, extra in cases.items():
        (root / "content" / f"{name}.md").write_text(
            f"---\ntitle: {name}\ndate: 2024-01-01T00:00:00Z\n"
            f"url: /{name}.html\n{extra}---\n\nFixture: {name}.\n",
            encoding="utf-8",
        )
    all_rows = list(csv.DictReader(io.StringIO(run_hugo(root, "list", "all"))))
    published = list(csv.DictReader(io.StringIO(run_hugo(root, "list", "published"))))
    assert {row["title"] for row in all_rows} == set(cases)
    assert {row["title"] for row in published} == {"visible"}
    builds = [
        ([], {"visible"}),
        (["--buildDrafts"], {"visible", "draft"}),
        (["--buildFuture"], {"visible", "future"}),
        (["--buildExpired"], {"visible", "expired"}),
        (["--buildDrafts", "--buildFuture", "--buildExpired"], set(cases)),
    ]
    for index, (flags, expected) in enumerate(builds):
        destination = root / f"output-{index}"
        run_hugo(root, "--destination", str(destination), *flags)
        actual = {path.stem for path in destination.glob("*.html")}
        assert actual == expected, (flags, actual, expected)
        for name in expected:
            assert f"Fixture: {name}." in (destination / f"{name}.html").read_text()
    print("PASS: inventories and 5 isolated builds")

python3 test_hugo_visibility.py