Schema — Page taxonomy & conventions

The canonical reference for how this wiki is organised. Every page follows these rules. Update this file before adding new categories or frontmatter fields.

Page categories (directories)

Filename rules

• ASCII only, lowercase, hyphen-separated.
• Transliterate Arabic with standard scholarly system (roughly ALA-LC), dropping diacritics for filenames:
  • al-kamm-wa-al-kayf.md (الكمّ والكيف)
  • ibn-arabi.md (ابن عربي)
  • maratib-al-wujud.md (مراتب الوجود)
• For books: pure slug, no TR-XX prefix — haymanat-al-kamm-wa-alamat-akhir-al-zaman.md. The TR-XX identifier is internal plumbing and must never appear in wiki filenames, link paths, display text, or body prose.

Required frontmatter (all pages)

---
title: ...                # Arabic title (primary)
title_fr: ...             # French original term, if known (optional)
title_en: ...             # English rendering (optional)
type: concept|symbol|figure|tradition|text|place|cycle|term|book|query|meta
aliases: [...]            # Arabic synonyms/variants for search
books: ["[[books/<slug>|<short Arabic title>]]", ...]   # Books where this entity appears — wiki-links, NOT tr_ids
updated: YYYY-MM-DD
---

The books: property value is a list of wiki-link strings so Obsidian’s Properties pane displays clickable Arabic titles. Never use bare TR-XX strings in books:.

Per-type extra frontmatter

• book: author: رينيه غينون, translator: عبد الباقي مفتاح, source_file: raw/TR-XX-slug.md (internal plumbing path — the only place TR-XX is allowed in a wiki file), chapters: <int>. Do NOT set books: on a book page (it would be self-referential).
• figure: tradition: [islamic, hermetic, ...], era: <century or period>.
• symbol: domain: [cosmological, initiatic, geometric, alphabetic, ...].
• tradition: region: ..., primary_texts: [[...]].

Body conventions

• Arabic body, justified (Obsidian handles RTL by default once configured).
• Open with a one-sentence definition (Meftah’s vocabulary preferred).
• Then sections: ## التعريف, ## الشرح عند غينون, ## الموقع في التقاليد, ## ارتباطات, ## شواهد من الكتب (quotations with citations), ## مراجع داخلية (backlinks summary).
• Use [[...]] wiki-links for every mention of another entity with a page.
• Never link a page to itself. In the ## التعريف or elsewhere, when the page’s own subject appears in prose, leave it as plain text (or wrap in Arabic guillemets «…» if it’s being named as a term). Self-links are noise — the page title already names the entity. Alternate names of the same concept go in aliases:, not as self-wiki-links.
• Citations use the book’s short Arabic title, never TR-XX: (هيمنة الكمّ، ص. 42) inline; or as a blockquote trailing — (هيمنة الكمّ، الفصل الخامس). The first citation on a page may be a wiki-link to the book; subsequent citations can be plain text.
• Never paraphrase a quotation as if it were a direct citation. Quoted text must be verbatim from raw/TR-XX-*.md (raw files keep their TR-XX prefix — that’s the one and only zone where it lives).
• Keep Meftah’s layer split by voice:
  • ## نصوص الشيخ عبد الباقي مفتاح contains only verbatim quoted material from Meftah’s introductions, footnotes, or translator comments.
  • ## قراءة الموسوعة لتعليق الشيخ عبد الباقي مفتاح contains editor synthesis about what Meftah’s comment means. It must carry explicit [صياغة الموسوعة] attribution whenever the paragraph could be mistaken for Meftah’s own wording.
  • Book pages may use the plural form ## قراءة الموسوعة لتعليقات الشيخ عبد الباقي مفتاح for summary prose. Never blend this prose into Guénon’s claims.

Cross-reference rules

• Every entity page links to every book where it appears (in books: frontmatter AND in body).
• Every book page lists the entities it introduces or substantially develops.
• When two concepts are paired (quantity/quality, center/periphery, inner/outer, spiritual/temporal), each page must link the other in its first paragraph.

Spine files

• index.md — catalog. Organised by category. One line per page: - [[filename|Arabic title]] — one-line summary.
• log.md — append-only chronological record. Every ingest, query, lint operation gets one entry. Format in ingestion-spec.md.

When to add a new category

Open a type: value in schema.md first, explain what belongs there and why it’s not already covered, then create pages. Categories should be few and stable. Resist splitting.

Language of meta files

schema.md, ingestion-spec.md, index.md, log.md, all frontmatter keys, filenames, and directory names are English/Latin. Page bodies and titles are Arabic. This split is deliberate: tooling reads the Latin, humans read the Arabic.

The TR-XX zone rule

TR-XX is an internal plumbing identifier used by the conversion pipeline. It has one zone of legitimate use and is forbidden everywhere else:

• Allowed in: manifest.tsv, raw/TR-XX-*.md filenames, raw/*.md frontmatter (tr_id:, source_file:), and a book page’s source_file: back-pointer.
• Forbidden in: wiki page filenames, [[link]] paths, [[...|display text]], body prose, citations, books: property values, index.md, or anything a reader sees in Obsidian.

If you find yourself writing TR-01 in a wiki body or a display label, stop — replace with the book’s Arabic short title and wiki-link.