Skip to content

Latest commit

 

History

History
363 lines (298 loc) · 17.3 KB

example.org

File metadata and controls

363 lines (298 loc) · 17.3 KB

The Dark \LaTeX

Layouts

Templates

This package provides three different templates. They differ in the underlying \LaTeX{} classes that they use and in the way that they map the different Org headers to \LaTeX{} headers.

dndbook

This is the most complete one. It will use the dndbook \LaTeX{} class and it will map the headers starting at part and going down from there.

dndbookbrief

This is an alternative version of the above. It also uses the dndbook class, but the first level of headers is mapped to chapter. This makes the output more compact as parts uses full pages.

dndarticle

This is the best style for short documents and it uses the dndarticle class. Top level headers are mapped to sections, therefore, there are less levels available than in the others.

Sections

\DndDropCapLine{T}{his package is designed to aid you in} writing beautifully typeset documents for the fifth edition of the world’s greatest roleplaying game. It starts by adjusting the section formatting from the defaults in \LaTeX{} to something a bit more familiar to the reader. The article formatting is displayed above.

Section

Sections break up chapters into large groups of associated text. Sections are defined by using Org headings. Depending on the template selected, the headings will be mapped to different latex section types. See the org-latex-classes variable to see how the mappings are done for the different templates.

Subsection

Subsections further break down the information for the reader.

Subsubsection

Subsubsections are the furthest division of text that still have a block header. Below this level, headers are displayed inline.

Paragraph.

The paragraph format is seldom used in the core books, but is available if you prefer it to the “normal” style.

Subparagraph The subparagraph format with the paragraph indent is likely going to be more familiar to the reader.
Hanging indent feature

The description list allows hanging indented lists of options, such as those used for class features, background skill/tool proficiency options, and sometimes area features, for example:

Doors:
The doors are made from thick lumber and are unlocked.
Light:
The area is illuminated by candles placed in sconces on the walls. Each candle has had a continual flame spell cast on it. Dispelling a flame is rumoured to give grievous offence to the host.
Ventilation:
All areas contain an adequate air supply. The air is renewed via lung-like sacks that cling to the ceiling.

Special Sections

The module also includes functions to aid in the proper typesetting of multi-line section headers: \DndFeatHeader for feats, \DndItemHeader magic items and traps, and \DndSpellHeader for spells.

Map Regions

The map region commands provides automatic numbering of areas. You just need to add the map tag to your headings and they will be considered part of a map. Notice that only headings equivalent to certain levels in the hierarchy (subsection and subsubsection when translated to \LaTeX) will be tagged in this way.

Village of Hommlet

This is the village of hommlet.

Inn of the Welcome Wench

Inside the village is the inn of the Welcome Wench.

Blacksmith’s Forge

There’s a blacksmith in town, too.

Foo’s Castle

This is foo’s home, a hovel of mud and sticks.

Moat

This ditch has a board spanning it.

Entrance

A five-foot hole reveals the dirt floor illuminated by a hole in the roof.

Alternative Map Region Styles

Published modules sometimes use plain numbers for locations, sometimes plain letters, and sometimes they prefix a character to the front of the numbers. The following options can be used to display in these forms. Notice that only the second heading has number/letters vs the two levels from the standard style:

Numbered Dungeon

Areas in the Numbered Dungeon have sequential numbers. This is done using the numberedmap tag in your headers:

Entry

The entry.

Trap

The trap.

Fight

The fight.

Exit

The exit.

Lettered Dungeon

Same as above but using the letteredmap tag in the headers:

Entry

The entry.

Trap

The trap.

Fight

The fight.

Exit

The exit.

Text Boxes

The module has three environments for setting text apart so that it is drawn to the reader’s attention. readaloud is used for text that a game master would read aloud.

As an Aside

The other two environments are the commentbox and the sidebar. The commentbox is breakable and can safely be used inline in the text.

The sidebar is not breakable and is best used floated toward a page corner as it is below.

Tables

Table headTable head
Some valueSome value
Some valueSome value
Some valueSome value
Table headTable head
Some valueSome value
Some valueSome value
Some valueSome value
Table headTable headTable head
Some valueSome very long value that might expand more than one lineSome value
Some valueSome valueSome value
Some valueSome value
Some valueSome valueSome value
Some valueSome value
Some valueSome valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value
Some valueSome value

Customizations

Colors

This package provides several global color variables to style commentbox, readaloud, sidebar, and dndtable environments.

ColorDescription
commentboxcolorControls commentbox background.
paperboxcolorControls paperbox background.
quoteboxcolorControls quotebox background.
tablecolorControls background of even dndtable rows.

See Table tab:colors for a list of accent colors that match the core books.

ColorDescription
\rowcolor{PhbLightGreen} PhbLightGreenLight green used in PHB Part 1
\rowcolor{PhbLightCyan} PhbLightCyanLight cyan used in PHB Part 2
\rowcolor{PhbMauve} PhbMauvePale purple used in PHB Part 3
\rowcolor{PhbTan} PhbTanLight brown used in PHB appendix
\rowcolor{DmgLavender} DmgLavenderPale purple used in DMG Part 1
\rowcolor{DmgCoral} DmgCoralOrange-pink used in DMG Part 2
\rowcolor{DmgSlateGrey} DmgSlateGray (DmgSlateGrey)Blue-gray used in PHB Part 3
\rowcolor{DmgLilac} DmgLilacPurple-gray used in DMG appendix
\rowcolor{BrGreen} BrGreenLight-gray used for tables in Basic Rules
  • Use \DndSetThemeColor[<color>] to set themecolor, commentcolor, paperboxcolor, and tablecolor to a specific color.
  • Calling \DndSetThemeColor without an argument sets those colors to the current themecolor.
  • commentbox, dndtable, paperbox, and quoteboxcolor also accept an optional color argument to set the color for a single instance.

Examples

Using themecolor

\DndSetThemeColor[PhbMauve]

\DndSetThemeColor[PhbLightCyan]

d8Item
1Small wooden button
2Red feather
3Human tooth
4Vial of green liquid
6Tasty biscuit
7Broken axe handle
8Tarnished silver locket
Using element color arguments
d8Item
1Small wooden button
2Red feather
3Human tooth
4Vial of green liquid
6Tasty biscuit
7Broken axe handle
8Tarnished silver locket

\appendix

Appendices

One Last Thing

\DndDropCapLine{U}sing the \appendix command causes all subsequent chapters to be formatted as appendices. Neat!