Home /Modules/nine-gates/MANUAL.md

MANUAL.md

nine-gates/MANUAL.md · 131 line(s) · markdown

MANUAL.md — the Nine Gates set

A short guide to the Nine Gates: what it is, how the pieces fit together, how to view and render the emblems, and how to extend the set. Everything here is original work authored for this repository (see Provenance).


1. What this is

The Nine Gates is a small, self-contained set of nine original emblems with a short written description for each. It is a thematic/artwork asset for the project — a sequence of nine "gates," each a distinct symbol and idea, meant to be used as section markers, milestone badges, step indicators, or simply as a reference motif.

It is inspired by the generic idea of a nine-stage passage (a motif found across many myths, games, and stories). It is not a copy or adaptation of any specific book, film, or other copyrighted artwork, and it deliberately does not reproduce such material. The specific fictional work the directory name alludes to is documented, as description and attribution only, in REFERENCE.md.


2. Layout

nine-gates/
  README.md            index + the gate table
  MANUAL.md            this guide
  gates/
    gate-01.md         The Threshold
    gate-02.md         The Lantern
    gate-03.md         The Bridge
    gate-04.md         The Mirror
    gate-05.md         The Keystone
    gate-06.md         The Tide
    gate-07.md         The Ember
    gate-08.md         The Compass
    gate-09.md         The Horizon
  images/
    svg/                              images are organized by file type
      gate-01.svg .. gate-09.svg      one emblem per gate
      nine-gates-contact-sheet.svg    all nine on one sheet

Images are organized by file type under images/: each format lives in its own subfolder (images/svg/ for the vector emblems). A future raster export would go in a sibling folder such as images/png/, keeping the paired gate-0N basename.

Naming convention (deliberate, so the set stays sortable and greppable):

The zero-padding (01..09) keeps lexical order equal to numeric order in every file browser and ls, and makes a tenth-or-later gate (10) sort correctly if the set is ever extended.


3. The nine gates at a glance

#GateOne-line idea
1The Thresholdthe decision to begin; crossing in
2The Lanternsight in the dark; the first guidance
3The Bridgespanning the gap; commitment over a void
4The Mirrorself-knowledge; seeing what you brought
5The Keystonethe load-bearing center; what holds it together
6The Tideforces beyond control; timing and patience
7The Emberwhat survives; the persistent spark
8The Compassdirection regained; choosing a true course
9The Horizonarrival and the next beginning; the open end

Each gate's own document (gates/gate-0N.md) gives its name, the emblem's visual motif, and a described meaning.


4. Viewing and rendering the emblems

The emblems are hand-written SVG (plain vector line-art, no external fonts or images), so they are portable and diffable.

View one emblem:

View all nine: open images/svg/nine-gates-contact-sheet.svg.

Convert to PNG (optional, if you have one of these installed):

# with rsvg-convert (librsvg)
rsvg-convert -w 512 -h 512 images/svg/gate-01.svg -o gate-01.png

# or with ImageMagick
convert -background none -resize 512x512 images/svg/gate-01.svg gate-01.png

# or with Inkscape
inkscape images/svg/gate-01.svg --export-type=png -w 512 -o gate-01.png

Each emblem is drawn on a 0 0 240 240 viewBox with a transparent background, so it scales to any size and recolors cleanly (the strokes use currentColor where a host stylesheet is present, with a dark default otherwise).


5. Provenance and licensing


6. Extending the set

To add or revise a gate:

  1. Keep the paired naming: a new gates/gate-0N.md and images/svg/gate-0N.svg with the same N.
  2. Author original art only — no copying from protected sources.
  3. Add the row to the tables in README.md and §3 above.
  4. If you add a tenth gate, the naming already sorts correctly (gate-10.*), but update the "Nine" framing in the docs so the name stays truthful to the count.