Use h1 headings (# Heading Title) for the main chapter title. All hx headings will appear in the sidebar as bookmarks.
If the title is not an h1 heading, the sidebar will have a duplication error showing the page and then the h2 'title' heading.
Use h2 headings (## Section Heading) preceded by a divider (---)for each new main section.
Use h3 headings (### Subsection Heading) for each new Subsection, and h4 headings (#### Sub-Subsection Heading) for each new sub-subsection.
The sub-headings get mixed up in the sidebar if h-progression is not dealt with correctly.
The heading marker should increase by one or nothing.
h2 followed by h2 or h3 is fine. h3 followed by h3 or h4 is also fine.
h2 followed by h4 causes issues. The sidebar places the sub-heading somewhere above the heading in the table of contents.
This doesn't seem to be an issue. eg. h4 to h3 or h2 is fine.
The following styles are the norm for these Imperative SRDs in Markdown format.
- Use double asterisks (
**Bold**) for Bold text. - Use underscores (
_Italic_) for Italic text.- nb: Avoid using single asterisks for Italics!
- Use backslashes (
\_) to 'escape' a character: _Not Italic_. - Use angled quotes (
`code`) to makecode blocks. - Use three hyphens (
---) to insert a horizontal dividing line.
Aim to stick to the following patterns...
Use bold titles for when describing spells, effects etc.
- Magic Title: Description.
Use italic titles for 'sub-lists' of variants spells etc.
- Magic: Description.
- Magic Variant-A: Description.
- Magic Variant-B: Description.
Use italic titles when referencing a book such as Mythras Imperative or the core Mythras ruleset.
- Unordered lists are made with hyphens.
- Unordered lists are made with hyphens.
- Increase the indent level with 2 spaces or a tab.
- Numbered lists are made with the digit and a full stop/period.
- Numbered lists are made with the digit and a full stop/period.
- Mix up with bullet points
- And indentation
- Mix numbers back in
- And bullets
For lists of related sub-headings embolden the title and colon.
- Example 1: Bla, bla, bla...
- Example 2: Bla, bla, bla...
For lists of related sub-headings embolden & italicise the title and colon.
- Example 1: Bla, bla, bla...
- Example 2: Bla, bla, bla...
Give tables a sub-header so they appear bookmarked in the sidebar, indented a level from their parent section.
Make the heading row bold text.
Making the header row bold actually renders it in normal text. The default CSS has that row bolded.
Use row 2 for content alignment: :--, :-:, or --:.
This will affect the whole column.
| Column 1 | Column 2 |
|---|---|
| 1 | alpha |
| 2 | beta |
| 3 | gamma |
- Use centre alignment for numbers or similar value lists.
- Use left alignment for sentences of text.
| Number | Description |
|---|---|
| 1 | Descriptive text |
| 2 | Descriptive text |
| 3 | Descriptive text |
| Intensity | Examples | Time to Ignite | Damage |
|---|---|---|---|
| 1 | Candle | 1d4 | 1d2 |
| 2 | Torch | 1d3 | 1d4 |
| 3 | Campfire | 1d2 | 1d6 |
| 4 | Room-filling conflagration | 1d2 | 2d6 |
| 5 | Volcanic lava | Instant | 3d6 |
There are many uses for links in the SRD and only a few main cases are covered here.
Formatting a link is done with bracketed text. Use square brackets for the visible link text, and curved brackets for the destination URL: [Link Text](URL).
In these documents the most commonly used external link will be the Mythras Encounter Generator.
[Mythras Encounter Generator](https://mythras.skoll.xyz)
External links go to other pages via the internet and will need an http://example.com URL and, by default, they will always open in a new browser tab.
To having multiple tabs cluttering the document being read, internal links and bookmarks are formed with relative URLs referencing the markdown files visible in the GitHub repository. Instead of a new tab, these internal links will rapidly scroll to the linked section.
-
Chapter links: These point to the start of a main (h1) section. e.g. the Combat chapter.
- Link format:
[Combat](0005_Combat.md)
- Link format:
-
Subsection links: These point to a heading within a chapter referencing the document as above but appending
?id=followed immediately by the destination heading. e.g. Leaping Attacks- Link format:
[Leaping Attacks](0005_Combat.md?id=leaping-attacks)
- Link format:
There may be occasion to reference a known section of an external document, for instance, a specific table in another SRD. The formatting is the same as with subsection links, above, only using the external HTTP URL.
As an example, here is the Imperial to Metric conversions table from the Classic Fantasy Imperative SRD.
[Imperial to Metric conversions table](https://cfi-srd.mythras.net/#/Appendix_B_Conversion_Tables?id=imperial-weights-and-measures-to-metric-conversion)
Start a 'clean' section with an h2 heading for lists of available spells, powers etc; then h3 for each list item.
Spells and powers are usually presented in a single flat list by magic type (Folk Magic, Theism, etc) but if the list requires its own subsections, like school or cult specialisms, increase the heading level appropriately. For example, h2 for Theism Miracles List, h3 for Cult: Mithras, and h4 for each Mithras cult miracle.
Particularly in the case of spells, but in any description using keyword attributes, list them in italic text.
Descriptive text and special rules use normal text.
## h2 List name
### List item
_Attributes_
Description text.
Example: formatted spell list (block quoted)
Instant, Ranged
Avert is used to dismiss another spell within range. Avert can be cast reactively to neutralize offensive spells, by using the Counter Magic Reactive Action.
Start a 'clean' section with an h2 heading for the listings, then increase the h-level as usual for categories and list items.
Each listed example has the stats and descriptions presented as a bullet point list with bolded point titles.
## h2 List name
### Category
#### List Item
- **Stat 1:** [Value]
- **Stat 2:** [Value]
- **Description:** Descriptive text.
Example: formatted vehicle stat block (block quoted)
Hull: 6 (Medium Military), 40 Structure
Speed: Fast
Systems: 3
Traits: Ejector Seat, Enhanced Performance, Superior Handling, Surveillance Suite, Tough, Weaponized
Weapons: Oil slick dispenser, smoke dispenser, twin linked medium machine guns
Description: A souped-up luxury car, sports car or similar, this car is built to go fast and give as good as it takes in a battle. This is the sort of vehicle people think of when someone says, "spy car."
Start a 'clean' section with an h2 heading for the listings. Creature stat blocks use tables and are more complex in terms of formatting and space requirements. For clarity, avoid subsections and add dividers between list items.
Each listed example should have the following...
-
Creature title: A divider followed by an h3 header for the creature name.
-
MEG entry: An external link to the specified creature on the Mythras Encounter Generator.
-
Core Details: Creature name/type, attributes, skills and any special descriptions or character notes as required.
-
Weapon Details: Abridged desciptions with columns for the weapon name and the following attributes: Size (include Force here), Reach (include Range here), Damage, AP/HP, and any special rules.
-
Hit Locations & Armor: Location tables will vary based on differing creature anatomy but should be included even for traditional humanoids as a means to track armor and damage.
## Bestiary/List Name
Descriptive text.
---
### Example Creature
[MEG Entry](https://mythras.skoll.xyz/enemy_template/8626/)
| Creature Name | Example Creature |
| :-- | :-- |
| Key Attributes | STR 11, CON 14, SIZ 11, DEX 11, INT 11, POW 11, CHA 7 |
| Other notes | Values and details |
Example: formatted creature stat block tables (block quoted)
Creature Name Goblin/Orc Key Attributes STR 11, CON 14, SIZ 11, DEX 11, INT 11, POW 11, CHA 7 Action Points 2 Damage Modifier - Initiative +11 Move 6m Abilities Night Sight Skills Athletics 52%, Brawn 42%, Deceit 57%, Endurance 48%, Evade 62%, Perception 61%, Unarmed 52%, Willpower 42% Combat Style Warrior (Shortsword, Shield, Spear, Sling) 62%
Weapon Size Reach Damage AP/HP Special Shortsword M M 1d6 6/8 Spear M L 1d8+1 4/5 Sling L 10/150/300 1d8 1/2 Shield L S 1d4 4/9 Protects 3 locations for Passive Blocking/Warding
1d20 Location AP/HP 1-3 Right Leg 1/5 4-6 Left Leg 1/5 7-9 Abdomen 1/6 10-12 Chest 1/7 13-15 Right Arm 1/4 16-18 Left Arm 1/4 19-20 Head 1/5
Edits to 'clean up' the authors' text should be kept minimal but typos and other mistakes should just be changed inline without any signposting.
Where a given rule is too ambiguous, incomplete, or simply wrong, add in a collapsible Community Errata note.
Explain the issue in italics using only bold italics for the issue's title - no h(x) headers! - so as not to create confusing sidebar entries.
If replacement text is added place it in double-quotes in bold italic, preceded by "Community Errata:" in normal weight italics.
Additional rules, if required, should be presented in normal weight text.
<details>
<summary>* Community Errata</summary>
_**Issue Title**_
_Community Errata:_
_**"Replacement text if required."**_
_Explanation text stating how the rule as written causes problems._
</details>
* Community Errata
Climb
Community Errata: "Worn armor hinders climbers by an amount equal to the average of worn Armor Points. Find this by totalling every location's worn armor points and divide that figure by the number of locations."
The rule as written quickly causes issues. Wearing a single piece of 6AP armor would reduce a human to Move 0 meaning a human wearing a steel helmet and nothing else would be too overburdened to climb at all. This seems unreasonably restrictive hence the edited version suggested above. This will be updated should the original authors revise the rule as written.
* Community Errata
Gaits: Walk, Run, Sprint
The published version of Mythras Imperative has no explicit rules for moving at different Gaits though they are covered in the Mythras core rulebook. The Gait multipliers above have been added as part of the Community Errata.
Where required it should be enough to treat Gaits as follows:
-
Gaits faster than Walk apply a multiplier to the Move rating: 3x for Run, 5x for Sprint.
-
While at a Run or Sprint Gait, characters cannot attempt most proactive actions like attacking or casting spells. Some exceptions include...
- Attacks when using the Charging rules.
- Firing ranged weapons with the Skirmishing trait.
-
As a general rule, any allowed actions should be treated as one Grade harder to pull off at a Run, and two Grades harder at a Sprint.
Leave a blank line between different types of entry. Headers, dividers, tables etc. These won't be rendered visible in reading view but their absence can cause formatting issues.
Each paragraph has to be marked as bold or italic text. The new line between paragraphs will break the formatting leaving orphaned formatting marks.
The regressive and deplorable powers have seen fit to remove all British spellings in favor of the objectively weaker US versions. Be on the look out for British -OUR words: armour, favour, etc.