summaryrefslogtreecommitdiff
path: root/doc/content-templates/README.md
diff options
context:
space:
mode:
authortanaka takashi <isazaka@gmail.com>2026-08-26 21:32:11 +0900
committertanaka takashi <isazaka@gmail.com>2026-08-26 21:32:11 +0900
commite3f41a8140cfed799a2c977b3d799cd06204b09a (patch)
tree1f9541eee045a0b53f11fcb61b99c568e7d1e529 /doc/content-templates/README.md
parent9f2fb3bda733c32995c008bd0f40365e43c348da (diff)
feat: 公開コンテンツとサイト表示を実運用向けに更新
サンプル中心だった初期コンテンツを整理し、最初の挨拶Noteとollama-webのSoftware記事、画面キャプチャーを追加する。Aboutとサイト説明はzola.tomlの値を参照する構成に揃え、Software一覧から自前cgitへ案内する。不要になったサンプルNotesとSoftwareは削除する。 ホームの重複する紹介要素を取り除き、見出しサイズ、ページ余白、記事内の見出し間隔、一覧行間を縮小する。bodyとmainをFlexレイアウト化して短いページでもフッターの位置と内側余白を統一し、Software詳細のメタ情報が奇数項目でも罫線と列幅を維持する。 NotesとSoftwareのFront Matterを網羅したコピー用テンプレートと利用手順をdoc/content-templatesへ追加し、設計書と仕様書を現在の構成へ同期する。生成物に加えてdraftディレクトリをGit管理対象外とし、公開前の記事をローカルだけで管理できるようにする。
Diffstat (limited to 'doc/content-templates/README.md')
-rw-r--r--doc/content-templates/README.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/content-templates/README.md b/doc/content-templates/README.md
new file mode 100644
index 0000000..0180943
--- /dev/null
+++ b/doc/content-templates/README.md
@@ -0,0 +1,27 @@
+# コンテンツテンプレート
+
+`content/`へ新しい記事を追加するときに、このディレクトリのMarkdownをコピーして使用する。
+
+| 記事種別 | テンプレート | コピー先 |
+|---|---|---|
+| Notes | `note.md` | `content/notes/<英語ASCIIのslug>.md` |
+| Software | `software.md` | `content/software/<英語ASCIIのslug>.md`、または`content/software/<英語ASCIIのslug>/index.md` |
+
+画像などの記事固有assetがあるSoftwareは、後者のPage Bundle形式を使用し、`index.md`と同じディレクトリへassetを置く。
+
+## 使用手順
+
+1. 対応するテンプレートをコピーする。
+2. Front Matter内の説明コメントを削除する。
+3. 必須項目と日付を実際の値へ置き換える。
+4. 不要な任意項目は空文字列または空配列のまま残せる。
+5. `zola check`で内部リンクとFront Matterを検証する。
+
+関連コンテンツのpathは、`content/`を基準にしたMarkdown pathを指定する。`@/`は付けない。
+
+```toml
+related_software = ["software/example/index.md"]
+related_notes = ["notes/example.md"]
+```
+
+`date`と`updated`はTOMLの日付として記述するため、引用符で囲まない。更新日のないNotesでは、`updated`をコメントのままにする。