novoyuuparosk-wiki/novoyuuparosk-auto-wiki

Files

T

mikkeli dfe1f9c631 feat(ses): add SES light novel pipeline; extract shared lib/wiki.py

New pipeline at pipelines/ses/ publishes mikkeli/ses-light-novel to
the SES: MediaWiki namespace. All pages get Category:SES and
Category:SES:<type> (type from frontmatter, fallback to parent dir name).

Shared functions (connect_wiki, markdown_to_wikitext, strip_first_h1,
AUTO_BANNER_PREFIX) extracted from songs/publish.py into lib/wiki.py;
songs refactored to import from there.

Also adds publish-ses.yml workflow stub and updates Dockerfile and
root README.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-10 16:23:26 +09:00

4.3 KiB

Raw Blame History

SCHEMA — SES light novel source files

Source-file contract for the SES pipeline. Files in mikkeli/ses-light-novel must follow this contract to be picked up by the auto-publisher.

The schema lives entirely in the YAML frontmatter block at the top of each .md file. The body below the frontmatter is plain markdown, rendered to MediaWiki wikitext by Pandoc.

File layout

---
title: Wakkanai
type: story
wiki:
  publish: true
---

## Section 1
### The coast or the shore

... body markdown ...

The renderer parses the frontmatter, validates required fields, strips the first # Heading line if present, then hands the body to Pandoc.

Fields

Required

`title` (string)

The MediaWiki page name, without the SES: prefix — the pipeline prepends it automatically. MediaWiki capitalises the first letter; lowercase input is fine.

Example: title: Wakkanai → wiki page SES:Wakkanai at URL /wiki/SES:Wakkanai.

`wiki.publish` (boolean)

Publishing gate. true means the pipeline writes this file to the wiki. false means the file is ignored.

wiki must be a YAML mapping, not a list:

# correct
wiki:
  publish: true

# wrong — will be silently skipped
wiki:
  - publish: true

Optional

`type` (string)

The page type. Drives [[Category:SES:<type>]] injection. If omitted, the pipeline falls back to the file's immediate parent directory name (stories, people, places, etc.).

Example: type: story → [[Category:SES:story]].

If neither type nor a meaningful directory name is available (file sits at the repo root), the fallback is uncategorized.

`categories` (list of strings)

Additional wiki categories to inject beyond the automatic SES and SES:<type> ones. Each entry becomes [[Category:<value>]].

categories:
  - Featured

Body

Plain markdown. The renderer strips the first-line # Heading if present, then passes the body through Pandoc. Do not embed raw wikitext ({{Template}}, raw [[Wikilinks]], etc.) unless you intend the literal output.

Renderer behaviour

For each .md with wiki.publish: true:

Parse and validate frontmatter.
Strip the leading # Heading from the body if present.
Pipe the body through pandoc -f markdown -t mediawiki.
Prepend the auto-generated banner: {{Auto-generated|source=<source URL>|commit=<sha>}}.
Append category tags: [[Category:SES]], [[Category:SES:<type>]], and any entries from categories.
Read the current wiki page content via the MediaWiki API; if identical to the generated output, skip the write (idempotency).
If the page exists and does not start with {{Auto-generated, skip with a warning (manual page protection).
Otherwise, write the page with an edit summary referencing the source commit.

Implemented scope

Frontmatter parsing and validation
SES: title prefix
Pandoc-based markdown → wikitext body rendering
First-line h1 stripping
Banner template injection
Category:SES + Category:SES:<type> injection (type from frontmatter, fallback to parent directory)
Additional categories via categories list
Idempotent writes (no-op skip when content matches)
Manual-page protection (skip pages without auto-gen banner)
Files without wiki.publish: true silently skipped

Not in scope (intentional)

Sibling/cross-page link resolution — write wikilinks directly in the body
Separate upload of companion files (no LRC equivalent)

Examples

A story chapter

---
title: Wakkanai
type: story
wiki:
  publish: true
---

Wiki page: SES:Wakkanai. Categories: SES, SES:story.

A world entry (type from directory)

---
title: Emms White
wiki:
  publish: true
---

File at world/people/emms_white.md. Type falls back to people. Wiki page: SES:Emms White. Categories: SES, SES:people.

A draft (not published)

---
title: Helsinki
type: place
wiki:
  publish: false
---

Validation errors the renderer must produce

Files without wiki.publish: true are silently skipped. The pipeline fails fast only on opted-in files with invalid data:

Missing or empty title on a file with wiki.publish: true
wiki.publish present but not a boolean
categories (if present) is not a list
Two publishable source files resolve to the same wiki title

4.3 KiB Raw Blame History