Loading repository data…
rpgtex / repository
LaTeX package to typeset material for the fifth edition of the "world's greatest roleplaying game".
This is a LaTeX template for typesetting documents in the style of the fifth edition of the "world's greatest roleplaying game".
There are three options for using this project; choose the one that's right for you.
TEXMFHOME (recommended)This will install the template for your current user in one of the following locations:
~/.texmf/tex/latex~/Library/texmf/tex/latexC:\Users\{username}\texmf\tex\latexLaTeX will find the package automatically.
Prepare your TEXMFHOME directory.
mkdir "$(kpsewhich -var-value TEXMFHOME)/tex/latex/"
Download the latest release and extract it in $TEXMFHOME/tex/latex/.
wget https://github.com/rpgtex/DND-5e-LaTeX-Template/archive/master.zip
unzip -d "$(kpsewhich -var-value TEXMFHOME)/tex/latex/" master.zip
cd "$(kpsewhich -var-value TEXMFHOME)/tex/latex/"
mv DND-5e-LaTeX-Template-master dnd
Alternatively, clone the repo to the same location:
git clone https://github.com/rpgtex/DND-5e-LaTeX-Template.git "$(kpsewhich -var-value TEXMFHOME)/tex/latex/dnd"
Overleaf is an online TeX editor -- think about it like Google Docs for TeX documents. This option does not require a local TeX installation and is an ideal approach for one-off projects.
TEXINPUTSYou can also clone a copy of the repository to each LaTeX project. For example, to clone the repository to a lib/ directory in your project:
mkdir lib/
git clone https://github.com/rpgtex/DND-5e-LaTeX-Template.git lib/dnd
LaTeX will not find the template automatically. Set TEXINPUTS when compiling your project to locate the package:
TEXINPUTS=./lib//: pdflatex project.tex
Load the dndbook class in your preamble:
\documentclass[10pt,twoside,twocolumn,openany,nodeprecatedcode]{dndbook}
\usepackage[english]{babel}
\usepackage[utf8]{inputenc}
\begin{document}
% ...
You can also load the dnd package directly to use it with another class.
Note that the package has only been tested with the book class.
\documentclass[10pt,twoside,twocolumn,openany]{book}
\usepackage[english]{babel}
\usepackage[utf8]{inputenc}
\usepackage[layout=true]{dnd}
\begin{document}
% ...
| Option | Package dnd | Class dndbook |
|---|---|---|
bg | ✓ | ✓ |
justified | ✓ | ✓ |
layout | ✓ | |
nomultitoc | ✓ | ✓ |
nodeprecatedcode | ✓ | ✓ |
The dndbook class also supports all the options of the book class.
bgDeclare how to load background and footer images. This is a key-value option with the following possible values:
full: Load both background and footer images. (default)none: Removes both background and footer images.print: Loads only the footer images.justifiedJustify column copy.
layoutControls whether loading the dnd package also modifies the document layout (geometry, colors, typography, etc.).
This is a boolean option with the following possible values:
true: Modify the document layout.false: Do not modify the document layout.The default value is true for backwards compatibility with early releases.
This will change in a future release.
nomultitocDisable multi-column table of contents.
nodeprecatedcodeExcludes all deprecated code from the build process.
If you don't have LaTeX installed, we recommend installing a complete TeX Live distribution.
sudo apt-get install texlive-full
sudo pacman -S texlive-bin texlive-core texlive-latexextra
MacTex has its own installer, but you can install it through brew cask:
brew cask install mactex
brew cask install mactex-no-gui
Use tlmgr to install packages as needed, see this answer for more information
brew cask install basictex
brew cask install tex-live-utility
After any of this, use the following such that the texlive directory doesn't require admin rights.
sudo chown -R myuser:mygroup /usr/local/texlive
For more information about MacTex permissions, see the following StackExchange post
This is a known issue in tcolorbox. According to the tcolorbox 4.12 manual (p. 363):
If your text content contains some text color changing commands, your color will not survive the break to the next box.
You can use LuaTeX to compile the document.
lualatex main.tex
monsterbox in float disrupts spacing inside stat blockWrapping a monsterbox (or monsterboxnobg) in a floating figure adds extra space between stat block elements:
\begin{figure}[b]
\begin{monsterbox}{Orc Warden}
% ...
\end{monsterbox}
\end{figure}
Instead, use the tcolorbox float parameter:
\begin{monsterbox}[float=b]{Orc Warden}
% ...
\end{monsterbox}
Refer to the tcolorbox documentation (section 4.13) for more float parameters.
We use EditorConfig to enforce consistent formatting. Install the appropriate plugin for your editor.
Run ./bin/bump-version to tag the new version.
./bin/bumpversion <version>
Compile the example PDF.
Save the first page of the PDF as scrot.jpg.
Update the change log for the new release; commit your changes.
Push changes.
git push && git push --tags
Create a new release and attach the PDF and scrot.
MIT
Selected from shared topics, language and repository description—not editorial ratings.
matsavage /
LaTeX package to typeset character sheets for the fifth edition of the "world's greatest roleplaying game".