利用上の注意点

この CMS は便利ですが、「GitHub の Issue を原稿にする」「Quarto で実行・生成する」という性質から、いくつか気をつける点があります。ここでは重要度の高い順にまとめます。

① slug は必ずユニークに

slug が重複すると、後から処理される方の記事が スキップ（無視）されます。特に：

slug: my-first-post   # 使い回さない
slug: my-second-post  # 一意に

値の中に :（コロン＋スペース）を含むと YAML 解析エラーになります。

title: "Tutorial: 公開手順"   # OK（引用符で囲む）
title: Tutorial: 公開手順      # NG

title だけでなく excerpt も同様に注意してください。

この CMS は画像をローカルに保存せず、Issue に貼った画像の URL をそのまま使います。

運用上は「画像を貼り直したら URL が変わる → 記事も更新が必要」という点だけ覚えておいてください。

{python} や {r} のブロックは毎回（変更時は）実行されます。

Discussion を原稿に使う場合：

Python: この CMS ではデフォルト有効。requirements.txt（jupyter, numpy, pandas, matplotlib, seaborn, marimo）をビルド時にインストール
R: 既定ではオフ。使いたい場合は .github/workflows/build.yml の ENABLE_R を true に変更
使いたいパッケージが増えたら requirements.txt に追記

category は1つだけ書けます（配列ではなく単一の値）。複数カテゴリで整理したい場合は tags を使いましょう。