From 6733a6356a400490a05f36a18e27236299f396db Mon Sep 17 00:00:00 2001
From: Mikkeli Matlock <mikkeli@novoyuuparosk.org>
Date: Sun, 14 Jun 2026 21:20:16 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E2=80=94=20wiki=20publishing?=
 =?UTF-8?q?=20+=20columns=20shorthand?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Point to the songs pipeline schema in the novoyuuparosk-auto-wiki repo
next door, and document the side-by-side `columns` fenced-block shorthand
(=== separators, Markdown emphasis) with kairo/kimito_en.md as an example.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 README.md | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index dc28789..652f447 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,51 @@
 # Northwich committee of magic researches songs repository
-Just a collection of lyrics of songs. Probably will be managed into proper folders. Probably will have LRCs. 
\ No newline at end of file
+
+Just a collection of lyrics of songs. Probably will be managed into proper folders. Probably will have LRCs.
+
+## Publishing to the wiki
+
+Song pages are auto-published to <https://wiki.novoyuuparosk.org> by the
+**songs pipeline** in the companion repo `novoyuuparosk-auto-wiki` (the
+"repo next door"). It triggers on push to `master`.
+
+- **Source-file contract** (frontmatter fields, body conventions): see
+  [`pipelines/songs/SCHEMA.md`](../novoyuuparosk-auto-wiki/pipelines/songs/SCHEMA.md)
+  in `novoyuuparosk-auto-wiki`.
+- **Pipeline overview** (branch convention, triggers, categories, LRC, etc.):
+  [`pipelines/songs/README.md`](../novoyuuparosk-auto-wiki/pipelines/songs/README.md).
+
+In short: a file is published when its frontmatter has `wiki.publish: true`
+and it isn't under `wip/`. The `title` field becomes the wiki page name.
+
+## Side-by-side lyrics (columns shorthand)
+
+To lay two (or more) versions of a song next to each other — e.g. an original
+and its translation — use a fenced code block tagged `columns`, with each
+column separated by a line containing only `===`:
+
+````markdown
+```columns
+**原題**
+
+一行目
+二行目
+===
+**Title**
+
+first line
+second line
+```
+````
+
+Notes:
+
+- Line breaks and blank lines are preserved verbatim (each column is rendered
+  with line breaks intact).
+- `N` columns ⇒ `N − 1` `===` separators.
+- Use Markdown emphasis inside the block: `*italic*`, `**bold**`,
+  `***bold-italic***`. (No need for raw HTML.)
+
+This is implemented entirely by the auto-wiki pipeline at publish time; the
+authoritative description lives in
+[`SCHEMA.md`](../novoyuuparosk-auto-wiki/pipelines/songs/SCHEMA.md#columns-side-by-side-shorthand).
+See [`kairo/kimito_en.md`](kairo/kimito_en.md) for a real example.