-
-
Notifications
You must be signed in to change notification settings - Fork 97
Docs: explain the small dignity letters shown next to planet icons (r, d, e, E, f) #118
Description
Context
Issue #87 asks: "What is the meaning of the small letter at the bottom of planet icons when creating a transit chart? (e.g. t or d)"
These letters are astrological dignity indicators rendered next to each planet symbol on both radix and transit charts. They are not explained on any documentation page, which makes the chart confusing for users who do not already know the convention.
What is missing from the docs
The settings reference lists the DIGNITIES_* keys in a table, but:
- It never explains what a dignity is or what the letters mean visually on the chart.
- The Transit Chart guide never mentions dignities at all, even though transit planets show them.
- There is no visual reference mapping letter to meaning.
What should be added
In the Settings Reference (api/settings.md) - Dignities section
Add a short explanation paragraph above the table:
Planet dignities are traditional astrological strength indicators. When SHOW_DIGNITIES_TEXT is true (the default), a small letter is rendered next to each planet symbol:
| Letter (default) | Dignity | Meaning |
|---|---|---|
| r | Rulership | The planet rules this sign - strongest position |
| d | Detriment | The planet is in the opposite sign of its rulership - weakened |
| e | Exaltation | The planet is in its exalted sign - elevated strength |
| E | Exact exaltation | The planet is at its precise degree of exaltation |
| f | Fall | The planet is in the opposite sign of its exaltation - weakened |
All five letter strings are configurable. Set SHOW_DIGNITIES_TEXT: false to hide them entirely.
In the Transit Chart guide (guides/transit-chart.mdx)
Add a short note explaining that transit planets show the same dignity letters as radix planets, based on the transiting planet's current sign position.
In the Custom Settings guide (guides/custom-settings.md)
Add a practical example:
// Hide dignity labels entirely
const chart = new Chart('chart', 600, 600, { SHOW_DIGNITIES_TEXT: false })
// Use different abbreviations
const chart = new Chart('chart', 600, 600, {
DIGNITIES_RULERSHIP: 'rul',
DIGNITIES_DETRIMENT: 'det',
DIGNITIES_EXALTATION: 'exalt',
DIGNITIES_FALL: 'fall',
})Relevant links
- Original question: I have a few questions. #87
- Settings source: project/src/settings.ts (SHOW_DIGNITIES_TEXT, DIGNITIES_*)
- Rendering logic: project/src/radix.ts drawPoints() and project/src/transit.ts drawPoints()