:orphan: .. include:: /_templates/include-file/page-prefix.rst .. _hell-system-dd-b15-floor-layer-naming: ************************************************************* DD b15 --- Floor-Layer Naming & Transform for Jubilee Floor Pours ************************************************************* | **Status:** tested on the ``b11-intro-pet-mmv5`` pilot, 2026m05d29. Extends :doc:`DD b12 (5D-link names) ` for the Floor Model of :doc:`bug c103 `. | **Worked example (the spec-by-example):** ``source/study/matheo/b11-intro-pet-mmv5.rst``. | **Per-paper data:** the floor-plan table ``source/study/matheo/matheo-floor-plan-table.html``. .. contents:: On this page :local: :depth: 1 1. Scope ======== How to **pour** the latest-of-each-type HELL paper onto the clean, citable ``/study/matheo/`` floor. **Copy, never move** --- HELL originals stay untouched (old links never break). Each pour is independent, so papers parallelise across fresh sessions; a single **wrap-up** assembles the cross-paper nav/table afterward. 2. Naming & citation ==================== - **FileID** = ``b---mmv5`` (TYPE first: ``form`` / ``math`` / ``intro`` / ``theophil`` / ``syseng`` / ``socpsy`` / ``econ`` / ``polsci`` / ``why`` / ``esc`` …). The FileID **is** the RST ``:ref:`` anchor (a label at the top of the file). Internal section anchors are prefixed with the FileID. - **Citation form:** ``Matheo-`` (e.g. ``Matheo-b11-intro-pet-mmv5``). - **Stability:** uniform ``mmv5`` for every floor copy (the first official Matheo release marker). This deliberately flattens real maturity --- a documented StayVS-bend, chosen for a memorable single release; true maturity stays in the HELL source + the floor-plan table. 3. The cover sequence (the b19 model --- NOT b18) ================================================= Echo the high-quality **b19** title-page structure. Order: #. ``.. only:: latex`` raw titlepage (PDF cover): header macros · title · byline · fn 1--3 · "4--N See **Declarations**" pointer · Broader Significance · ``\vfill`` · Declarations (fn 4--N) · License-as-last-fn · ``\end{titlepage}\newpage``. #. ``####`` **title heading** (the HTML ``

``; in PDF it is the body title). #. ``.. only:: html`` block: byline · ``titlepage-credentials`` (fn 1--3 + "4--N See Declarations" + **the header-line**, see §5) · ``
`` · Broader Significance · ``
`` · **Declarations** (fn 4--N) · ``
``. #. **Abstract** --- bold ``**Abstract**`` (NOT a heading, so it stays out of the ToC), placed before the ToC. ``.. raw:: latex \newpage`` after it so the ToC gets its own page. #. ``.. contents::`` ToC, then ``.. raw:: latex \newpage`` before the body. #. Body sections. **Hard rule (clutter → SI):** anything that is *not* in the Title → byline → fn 1--3 → Broader Significance → Abstract → ToC → Introduction sequence (e.g. a ``.. note:: Draft status…`` block, old ``Study aN-Intro`` / series ID lines) moves **verbatim** to the Supplementary-Info appendix (§9). Old ID/subtitle lines are deleted from the cover. 4. Byline (which form) ====================== Per ``AHA/study-title-page-footnotes-template.md``: - **STD (9 fn, 3 authors)** --- LLoL¹⁻⁵ + AI Claude Opus 4.6-4.7 Max⁶⁻⁷ + Everyone⁸ + License⁹: **all matheology papers b11--b18.** - **B19** (conditional, LLoL alone, no AI on byline): **b19 only.** - **B21** (framework form): **b21 only.** fn 5 carries a **per-paper hope sentence** (≤ ~80 chars). Author an **Abstract** and **Broader Significance** where missing; **FLAG every one you write** for LLoL. 5. Headers (the FileID line) ============================ - **PDF** ``\paperheadercenter`` = ``Matheo-`` (e.g. ``\renewcommand{\paperheadercenter}{\scriptsize Matheo-b11-intro-pet-mmv5}``). - **HTML** --- a matching plain-text line as the last entry of the ``titlepage-credentials`` block (after the "4--N See Declarations" line, before the Broader-Significance ``
``): ``| This is Balospe.com/study Matheo- ().`` (no code-style backticks.) 6. Labels, citations, images, refs ================================== - **Labels:** namespace every internal section/figure anchor with the FileID (``b11-mmv3r1-foo`` → ``b11-intro-pet-mmv5-foo``) so copies never collide with the HELL originals. Reference canonical axiom/theorem anchors (DD b12); do not redefine them. - **Citations:** neutralise broken docutils refs (``[Matheo-N-m]_`` / ``[Balospe-N-m]_``) to plain ``Matheo-bNN`` text; **deactivate** ``:doc:`` links to inert path literals so they cannot warn. (Proper bib + intra-floor links are the post-pour task --- see AA #5.) - **External (non-Matheo) bibliography** (rule added 2026m05d29 from the b13/b14 pour): a paper may cite outside works (e.g. ``(Schelling 1960)``, ``(Piketty 2014)``) in prose or via docutils ``.. [KEY]`` defs. Handle by the **in-bib test**: - *Key already in* ``source/_bib/references.bib`` *(e.g.* ``Schelling1960`` *):* wire the citation to ``:cite:`Key``` and add a ``References`` section with ``.. bibliography:: :filter: cited and True`` just before the footer (the proven ``b12-math`` / ``b14-math`` pattern). This renders **with** the FF footer --- the footer does **not** interfere (the bibliography is emitted above it). Bibtex ``:cite:`` keys are shared across docs, so reusing a key another floor paper cites causes **no** duplicate-citation collision. - *Key NOT yet in the bib* --- the common case (most floor papers' hand-written reference lists: Piketty / Acemoglu / Ostrom / Buchanan / Plantinga / Spence …): **leave the source's plain-text list or prose as-is.** Do **not** auto-convert to ``:cite:`` --- a blanket sweep would emit missing-key warnings or drop references, and author/year→key matching is error-prone (e.g. several ``Plantinga`` entries). Adding those works to ``references.bib`` then wiring them is **AA #5** (a careful, per-paper task, not a quick pour step). - *Docutils* ``.. [KEY]`` *external defs* (not ``:cite:`` roles): must be converted to plain text (or to ``:cite:`` if the key is in the bib), or they collide with the built HELL original's identical defs (duplicate-citation warnings). - **Images:** stay in ``/_file/`` (absolute paths); not moved. - **References (if any):** at the very end, ``\newpage`` before; add ``.. raw:: latex \newpage`` before each major section so ref-link landings sit on the right page. 7. Supplementary-Info appendix (down-payment) ============================================= A ``Supplementary Info`` section at the end carrying: a **HUMANE** statement (human + AI POV, stub), **author contributions** (who did what), a **Provenance** hatch (cautioned HELL links), the **moved cover clutter**, and a deferred-naming note. Stubs now; full write-ups later. 8. Close like a feedback page ============================= - **FF FeedbackFlow footer** (``FOOTER FORM`` block, slug = ``FF+study-matheo-@balospe.com``). - **og:card** social-card ``:og:card:title:`` + ``:og:card:description:`` in the ``.. meta::`` block. 9. Folder layout & nav (wrap-up step) ===================================== - Files live in ``source/study/matheo/bNN/.rst`` (per-paper folders). - Each ``study/matheo/bNN/index.rst`` = a **chooser page**: per type, the short-label + title + **abstract** (the **formal abstract first**, then intro, then others --- "AuditTheMath, not buildALearningPath"), with a ``toctree`` of its type-files (so files de-orphan; sidebar shows b11--b21, expandable). - ``study/matheo/index.rst`` = on-ramp (lead with ``b11-why-matheo``, then b18a Phase 1) + the public table (cols #, FileID, Audience, Title, PDF) + a toctree of the bNN nodes + a small link to the floor-plan HTML for HELL-tracing. - Root nav: add ``Matheo Study Series `` to ``source/index.rst`` under **The Solution**, right after **Good News Pack**. 10. The transform-script template (proven on b11) ================================================= Set the per-paper variables, then run. Steps 1--2 are mechanical; steps 3--5 use the worked ``b11-intro-pet-mmv5.rst`` as the pattern (cover order, Abstract, SI, FF). Build with ``make pdf SECTION=`` and ``make dev``; surface any authored Abstract/Broader-Significance to LLoL. .. code-block:: bash SRC=source/matheology/hell/mm/b/NN/<...source.rst> DST=source/study/matheo/bNN/.rst # mkdir -p the bNN folder FID=b---mmv5 cp "$SRC" "$DST" # 1) namespace labels (replace the source's label stem with the FileID) sed -i '' "s//$FID/g" "$DST" # 2) neutralise broken citations + (then, in Python) deactivate :doc: links, # add og:card, set \paperheadercenter=Matheo-$FID + the HTML header-line, # move clutter notes to SI, port the cover to the b19 order, TL;DR/lead -> # **Abstract**, add the FF footer. (See b11-intro-pet-mmv5.rst verbatim.) (For papers that already carry the new STD/B19/B21 title page --- b11, b18a, b19, b21 --- the cover port is light. For papers lacking one, stamp the form from the AHA template and author a Broader Significance + Abstract.) 11. Open follow-ups (AnyAims --- mirror the floor-plan table) ============================================================= #. **AA #1** ``h*→h_star`` / ``h₀→h_zero`` / ``h/→h_dark`` content sweep (post-launch; plan: ``hell/ll/study/b/17/b17-prompt-naming-transition-v1``). #. **AA #2** Broader-Significance / Abstract where missing. #. **AA #3** b18b adversarial review before any public exposure. #. **AA #4** b18e war paper (post-launch). #. **AA #5** add floor papers to ``references.bib`` + wire intra-floor citations (replaces the neutralised refs and the deactivated ``:doc:`` links). **Also** add each floor paper's **external** works not yet in the bib (Piketty, Acemoglu, Ostrom, Buchanan/Tullock, Olson, Spence, Scheidel, the specific Plantinga/Hartshorne titles, …) and convert the current hand-written reference lists to ``:cite:`` + ``.. bibliography::`` (per §6's in-bib test). Per-paper and careful --- **not** a blanket sweep (most works are not yet in the bib, so a sweep would drop refs or warn; b14-math's single in-bib ``Schelling1960`` was wired during the pour as the one safe case). .. ---------------------------------------------------------------------- .. VVN: dv_ClaOp48Max_MMv1r1_b15-floor-layer-naming-and-transform_2026m05d29 .. (r1, 2026m05d29: §6 external-bibliography in-bib-test rule + AA #5 expansion, from the b13/b14 pour.) .. ----------------------------------------------------------------------