Some minor code to generate dN random tables in PDF format for various OSR RPG use.
LaTeX or direct PDF output is supported. There is a lot more flexibility with your final form if you use LaTeX, since this tool simply dumps your tables into a container document which you must then compile with LaTeX if you want a PDF.
Usage: program-name [options] input-file output-file
Options:
-t, --latex LaTeX output file mode
-p, --pdf PDF output file mode
-j, --json JSON output file mode
-e, --edn EDN output file mode
-h, --help
dntables will look for a dntables.properties file in the directory you are running it from. You can override and set font choices here for both the PDF and LaTeX output, although, you can also just edit the LaTeX template to change fonts before compiling to PDF.
You can also specify which LaTeX templates to use for the document frame and the table body if you want to override the default provided templates (that are built into the uberjar).
You can specify the following:
tex.templateroot=/path/to/template/root
tex.frame=/path/to/frame/template.tex
tex.table=/path/to/table/template.tex
tex.fontmain=Book Antiqua
tex.fotheader=IM FELL English PRO
pdf.fontmain=fonts/ANTQUA.ttf
pdf.fontheader="fonts/Duvall.ttf"
Examples:
Generate an EDN file from the family weapons source text.
java -jar dntables-0.1.0.jar -e goatmansgoblet/familyweapons.txt fw.edn
Generate a TEX file from the dw d6 democracy source text.
java -jar dntables-0.1.0.jar -t ~/projects/dntables/resources/dwdiscord/d6d.txt d6d.tex
Generate a PDF directly
java -jar dntables-0.1.0.jar -p ~/projects/dntables/resources/dwdiscord/d6d.txt d6d.pdf
This varies depending on environment. This is how I do it on OSX.
xelatex output.tex && open output.pdf
Goatman's Goblet Family Ties Weapons PDF
TL;DR, the DCC fonts:
Source is a plain text file with one or more numbered random tables. Copying and pasting straight out of a discord channel works fine usually, depending on how the participants of the table generation entered their text. At the top of the file, you can add metadata as described below if you wish to have this in your final output.
The following examples will trigger table capture:
[1d20] Gifts for a goblin king
What happened in the alley behind the stables (2d6)
(d66) Magical potions with temporal effects
The thing to note is that either at the start, or end of the line of the prompt, you must encapsulate the die type in parenthesis or square brackets.
Prompt entries must start with a number and be followed by a space or other delimiter. Examples:
1. This is a valid entry for a prompt, d30 blah blah modifications.
1a. This is also valid.
1c. a..b..c labels are just considered next entries in the total entry count.
4 So Is this
8: The numeric labels are actually ignored, which may or may not be desireable.
see dntables.parsers.text/parse-entry for the exact regular expression if you really want to know ALL current entry marker possibilities.
## This is an entry:
1. I am a regular entry
a. Alternate 1
b. Alternate 2
c. Alternate 3
The above example would turn into one entry in the roll table with three subentries.
Within the source text the following attributes can be added. Place them on a line by themselves. They may not span multiple lines.
- ::license [text]
- ::licenseurl [text]
- ::author [text]
- ::source [text]
- ::doctitle [text]
- ::fontsize [+1, -1, 1] - Sets the font size for the next table encountered to either be relative or absolute sized. Currently only works with direct PDF output.
- DCC RPG
- Dungeon World
- Weapons for Family Ties Table
- Dungeon World Discord
- RPGTalk Discord
- Phishcord
- King Gizzard & The Lizard Wizard
- Phish
Copyright © 2019 Damion Junk
Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.