Zettle

0020-worldscripture-resource-class

8 min read

ADR-0020: WorldScripture resource class

Status: Accepted Date: 2026-05-21

Context

Second UC secondary work to be ingested (after BR per ADR-0016): World Scripture II — World Scripture and the Teachings of Sun Myung Moon (Chung Hwan Kwak, ed., Universal Peace Federation, 2014). 1178-page comparative anthology that builds on Andrew Wilson’s 1991 World Scripture: A Comparative Anthology of Sacred Texts by interleaving Sun Myung Moon’s teachings alongside cross-religion quotes, organized by theme.

Structurally distinct from prior classes:

  • Anthology, not monograph. Each chapter is a curated bundle of short quotes from many traditions (Bible, Bhagavad Gita, Qur’an, Dhammapada, Tao Te Ching, SMM speeches, …) clustered under sub-themes. Wilson/Kwak’s editorial framing — the choice of sub-themes, the juxtaposition of quotes across traditions, the introductory commentary — is itself the value being cited, not the quotes in isolation.
  • Two-axis citation problem. A reader of an atomic citing “Bhagavad Gita 3:35” found via WS-II has two valid sources: the original scripture (canonical, but not ingested in our vault) and WS-II (proximate, ingested). Per ADR-0003 a citation must point to a defined class; we have no Bhagavad-Gita / Qur’an / Dhammapada classes today and adding them all up front is impractical.
  • Hierarchy. 4 Parts, 22 numbered Chapters, ~200 sub-themes. Parts are top-level navigational dividers; chapters are the natural unit of thematic coherence; sub-themes are the natural citation anchor.

Decision

  • Class code: WorldScripture

  • Path: /resources/WorldScripture/

  • File granularity: one file per sub-theme (anthology carve-out per ADR-0004). Sub-themes are nested in Part{N}/Chapter{NN}-{chapter-slug}/ folder hierarchy. Typically 13–17 sub-theme files per chapter; ~200 sub-theme files vault-wide across the 22 chapters. Plus 4 root-level files at /resources/WorldScripture/: front matter (ws-preface.md, ws-invocation.md) and back matter (ws-notes.md, ws-list-of-sources.md).

  • Filenames:

    • Sub-themes: ws-{NN}-{subtheme-slug}.md, e.g. ws-01-knowledge-of-god.md, ws-02-the-one-god.md, ws-13-heavenly-father-and-mother.md. The 2-digit zero-padded ordinal preserves the print’s sub-theme order in alphabetical filename sort (since otherwise ws-the-one-god lands after ws-knowledge-of-god etc., which is not the print order). No part/chapter prefix in the filename — those live in the folder path. Mirrors CSG’s csg-{NN}-{NN}- two-level ordinal pattern (ADR-0018).
    • Folder structure: /resources/WorldScripture/Part{N}/Chapter{NN}-{chapter-slug}/ws-{NN}-{subtheme-slug}.md. Zero-padded chapter numbers (Chapter01-god/ through Chapter22-peace/) — mirrors CSG’s Book01/ pattern from ADR-0018 but adds chapter slug for navigability across 22 chapters spread over 4 parts.
    • Root-level front/back-matter: ws-{slug}.md — no part/chapter prefix since these aren’t in the Part hierarchy. Files: ws-preface.md, ws-invocation.md, ws-notes.md, ws-list-of-sources.md.
    • Front/back-matter frontmatter omits part/part-title/chapter/chapter-title/subtheme (no hierarchy slot). The Quartz filter tree’s pathPattern matches only Part{N}/Chapter{NN}-…/… files; root-level WS files are reachable via class pill but not via the tree.

  • Internal hierarchy inside each sub-theme file: frontmatter title: carries the sub-theme title (so the Quartz hierarchical filter’s sub-theme label resolves correctly per ADR-0018). File body opens with intro paragraphs — no top-level # H1 heading inside the body (the frontmatter title is the display title; matches the BR convention). Sub-sub-themes (where they exist) → ## {N}. {title} (H2). SMM blocks → ## SMM — {parent} (H2), always disambiguated for global slug uniqueness across the ~200-file vault.

  • Sub-sub-theme level (H2, anchor target). Some sub-themes contain numbered sub-divisions in the print (e.g. inside “Knowledge of God”: 1. Traces of God in the Creation, 2. Evidence for God within the Self, 3. Evidence of God in History). These render as ## {N}. {title}. They are citation anchors via Obsidian’s auto-slug (e.g. 2-evidence-for-god-within-the-self); the leading number prefix preserves the print’s pedagogical ordering and avoids slug collisions across sub-themes.

  • Sun Myung Moon teaching blocks (H2, disambiguated slug). Each sub-theme or sub-sub-theme in WS-II ends with a “Teachings of Sun Myung Moon” block. These are renamed during stage-2 to ## SMM — {parent}, where {parent} is the immediately preceding H1 (sub-theme, in the file body sense — i.e. frontmatter title) or H2 (sub-sub-theme) title. SMM blocks are H2 navigation only, not primary citation targets. Atomics derived from SMM quotes inside WS-II cite the future /resources/SMM/ class once those speeches are ingested per the hybrid policy below.

  • Citation form:

    • Sub-theme (file-level): [[resources/WorldScripture/Part{N}/Chapter{NN}-{chapter-slug}/ws-{NN}-{subtheme-slug}]]
      • Example: [[resources/WorldScripture/Part2/Chapter06-evil-sin-and-the-fall/ws-04-human-pride]]
    • Sub-sub-theme (anchor): [[resources/WorldScripture/Part{N}/Chapter{NN}-{chapter-slug}/ws-{NN}-{subtheme-slug}#sub-sub-theme-heading|Sub-sub-theme Heading]]
      • Example: [[resources/WorldScripture/Part1/Chapter01-god/ws-01-knowledge-of-god#2-evidence-for-god-within-the-self|2. Evidence for God within the Self]] (anchor is verbatim heading text; see ADR-0024)

  • Hybrid citation policy for quotes inside WS-II. WS-II is the citation target for the anthology’s editorial framing (sub-theme intros, chapter intros, juxtaposition). For individual quotes whose original tradition has its own ingested resource class, atomics cite the original (e.g. [[resources/Bible/Romans#121|1:21]]). For quotes whose original class is not yet ingested — the common case at time of writing — cite WS-II and migrate the citation later when the original lands. The pre-commit hook continues to enforce grammar; placeholder dead links are not allowed.

  • Class category: UC secondary literature, same bucket as BR. Future original-tradition classes (Bhagavad-Gita, Qur’an, Dhammapada, etc.) get their own ADRs when first needed.

  • Frontmatter shape (per ADR-0015 + ADR-0018 hierarchical fields):

    ---
type: resource
class: WorldScripture
title: "{Sub-theme title}"
book: "World Scripture II — World Scripture and the Teachings of Sun Myung Moon"
author: "Chung Hwan Kwak (ed.)"
publisher: "Universal Peace Federation"
year: 2014
part: {1-4}
part-title: "{Part title}"
chapter: {1-22}
chapter-title: "{Chapter title}"
subtheme: {sub-theme-slug}
source-file: "resources-raw/WorldScripture/World-S2.pdf"
ingested: {YYYY-MM-DD}
---

    title: carries the sub-theme title (the sub-theme is the file). chapter-title: is retained for inherited context (drives the Quartz hierarchical filter’s Chapter label per ADR-0018). No separate subtheme-title: — would duplicate title:. No pdf-pages field — page-range provenance lives in resources-raw/WorldScripture/bookmarks.tsv. Editor folded into author: with (ed.) suffix rather than separate editor: field.

  • Quartz hierarchical filter tree. Per ADR-0018, stage-2 also adds an entry to quartz.config.ts. Three-level hierarchy (Part → Chapter → Sub-theme):

    WorldScripture: {
  pathPattern: /WorldScripture\/(Part\d+)\/(Chapter\d+-[\w-]+)\/(ws-[\w-]+)/,
  levelNames: ["Part", "Chapter", "Sub-theme"],
}

Alternatives considered

  • Cite originals only (atomics never point at WS-II). Rejected — most originals aren’t ingested; would force ingesting ~15 world-scripture corpora before any WS-II atomic could be written.
  • Cite WS-II only (treat originals as unrecoverable). Rejected — collapses Wilson/Kwak’s curation with the underlying quotes; loses the ability to ever distinguish “what Wilson chose to highlight” from “what the Bhagavad Gita actually says”. Hybrid preserves the option.
  • Cite both, always, in the same atomic. Rejected — doubles frontmatter clutter and creates a maintenance burden (every original-tradition ingest triggers a migration sweep across all WS-II-derived atomics anyway).
  • Flat layout (no Part{N}/ subfolders). Rejected — 22 chapters is enough that grouping aids navigation, and the Parts are semantically real divisions in Wilson’s argument (God/Creation → Sin/Salvation → Path of Life → Family/Society) rather than arbitrary slabs.
  • Chapter as file granularity (one file per chapter, 22 files). Initially adopted, then reversed (this ADR was patched 2026-05-21 after the chapter-1 stage-2 pilot). Pilot file came out at 1,723 lines — 3× the size of a typical CSG chapter (~607 lines). The bloat is anthology-specific: each WS-II sub-theme bundles ~120 lines of curated cross-tradition quotes plus a ~50-line SMM commentary block, and ch1 has 13 such sub-themes. A sub-theme of an anthology is itself a coherent thematic unit (its own intro paragraphs, cross-source juxtaposition, SMM teaching) — not a sub-component of an argument as a section is in BR or CSG. ADR-0004’s original concern was per-section “vault explosion” producing tiny incoherent fragments; that worry doesn’t apply when each “section” is a 100–200-line themed file in its own right. Decision flipped to sub-theme-as-file (see ADR-0004 anthology carve-out for the parallel reasoning).

Consequences

  • (+) WS-II becomes ingestible. Stage-1 extraction via scripts/ingest_pdf.py --split-level 2 after bookmarks are added per the ADR-0019 sub-pipeline. Stage-2.5 sub-theme split via scripts/split_ws_chapter.py — deterministic mechanical pass (per the script-vs-AI rule) that converts a cleaned chapter file into N sub-theme files.
  • (+) Sub-theme-as-file granularity keeps each file at ~100–200 lines — reader-friendly in Quartz, AI-friendly for context loads.
  • (+) Hybrid citation policy is explicit and reviewable. New atomics either cite an ingested original or cite WS-II with the understanding that migration is expected when the original arrives.
  • (+) Backlink coherence is net-positive: atomic citing 3 quotes from the same sub-theme → 3 wikilinks to one file (good aggregation). Cross-sub-theme citations (e.g. one quote from “Knowledge of God” and one from “The One God”) appear as separate graph nodes — more informative than the chapter-file design collapsing everything to one node.
  • (+) Part/Chapter folder layout means URL paths on the published site are /resources/WorldScripture/Part2/Chapter06-evil-sin-and-the-fall/ws-human-pride/ — readable, mirrors the print structure with explicit chapter slugs.
  • (−) ~200 sub-theme files vault-wide. Acceptable — the natural argumentative beat in an anthology is the sub-theme, and the resulting file count is comparable to a moderately-sized SMM speech corpus.
  • (−) WS-II PDF has no publisher bookmarks (1178 pages, zero outline entries) and multi-column TOC with non-monotonic reading order in pymupdf text extraction. extract_toc.py’s dotted/spaced regexes don’t match its ❄-leader sub-themes or tab-newline chapter heads. Per the script-vs-AI split (script does deterministic work, AI handles judgment), bookmarks.tsv for WS-II is hand-written by AI from the TOC text dump rather than auto-extracted. Future similar UPF/IRF anthologies may justify extending extract_toc.py.
  • (−) Original-tradition resource classes are now an explicit backlog item. Each cite-via-WS-II atomic is a future migration. Acceptable: migrations are mechanical (filename rewrite + frontmatter sources: update) and can be scripted when the volume warrants.

Graph View