Numerous updates and additions; read on for more info.

THEMES
======

There is now an eberron theme that will set some fonts and recto/verso background images to match the
Eberron book stylings.  Top-level titles get some new fonts, and a couple of colors change.

You can now choose between three font sets.  The default uses the original font settings from the rpgtex
implementation.  In addition, you can provide the option `fonts=wotc` or `fonts=dmsguild`. Use `wotc` to
select the fonts that WotC uses in their published books (you'll have to pay for the fonts, and I can't
speak to any trade dress issues that might arise).  I like using this because I'm vain and I mostly write
these adventures for myself, for fun.  Yes, I'm a typography nerd, this is fun.  The `dmsguild` version
uses the fonts specified by the DM's Guild materials.

I've included details on where to obtain each of these fonts.  The official DM's Guild fonts are all
available for free download, the paid fonts can be found at either MyFonts or Adobe.

IMAGES
======

I've added support for floatable images using `tcolorbox`, with `\DndImage` providing a plain image, and
`\DndCaptionedImage` for an image with a corresponding caption, in the correct (themed) font.  You can
provide options from `tcolorbox` to both of these to provide some fine-tuning or to have images extend
out to the edges of the printed page, for example.

STAT BLOCKS
===========

You can now create stat blocks for sentient items via `\DndSentientItemAbilityScores`.  Sentient items
use `Int`, `Wis`, `Cha`, and `Alignment`.

Added `psionic` as an attack type, alongside `weapon` and `spell`.  I'm working on some Dark Sun ideas,
and one approach I have defines psionic attacks.

Added support for vehicle stat blocks using the `DndVehicle` environment.  This functions the same way
as for `DndMonster`, with appropriate no-bg variants.  There are corresponding commands for the various
components of the stat block:

  - `DndVehicleBasics`
  - `DndVehicleDetails`
  - `DndVehicleAbilityScores`
  - `DndVehicleSection`
  - `DndVehicleAction`
  - `DndVehicleSpeed`
  - `DndVehicleComponent`
  - `DndVehicleControl`
  - `DndVehicleMovement`
  - `DndVehicleWeapon`
  - `DndVehicleAttack`

NEW BOXES
=========

You can add quotation boxes now with the `DndQuotation` and `DndAside` environments.  `DndQuotation`
expects an attribution argument, and is intended for either book quotes or for notes from e.g. Tasha
or Xanathar.  `DndAside` provides the same without an attribution.  Both render in the form of a small
sticky note attached to the page, as close as I can get it to the ones in the official books.

AREAS
=====

Areas have been updated to allow for specifying ranges.  You can use `\DndAreaRange` to supply an area
description for e.g. "Area 1.10–1.12".  Area references are now also updated to make it easier to
reference areas outside the current set.  For instance, if you're in "F.3." and you want to build a
reference back to "C.5", you can now do so directly.

`\DndAreaRef` now generates the `C5` string, rather than a page number, since that's the more common
usage.  To get a page number, there's a new `\DndAreaPageRef` command which takes on the original
behavior.

UTILITIES
=========

There are new `\DndSkillCheck` and `\DndAbilityCheck` macros that can be used to generate DC checks
using localized strings from the locale file.  Ability checks render as e.g. "DC 12 Dexterity", while
skill checks render as e.g. "DC 12 Strength (Athletics)".

There are macros wrapping these for ability saves (`\DndStrSave`, `\DndConSave` etc.).  There are also
macros wrapping skills checks that provide the usual attribute name, though this can be overridden.
You can use `\DndAthletics{12}` to get "DC 12 Strength (Athletics)", or `\DndAthletics[\conname]{12}`
to get "DC 12 Constitution (Athletics)", for example.

In addition to these are a couple of macros for the things I consistently forget:

  - `\DndPickLock{12}` creates "DC 12 Dexterity" because I forget lock-picking is straight Dex.
  - `\DndThievesTools{12} creates "DC 12 Dexterity (Thieves' Tools)" for those cases where tool
    proficiency is helpful.

The eagle-eyed will note a `dndmonsterlookup.sty` in here as well, which is being superceded by a
separate package.  The intent is for you to be able to say `A \Boar\ approaches` and receive
"A \textbf{boar} (\textit{MM}, p. 319) approaches" in the output.  The separate package is better
because it defines each source in an optional module, and provides a way to get plurals in place
properly.  That's coming Real Soon Now™.

Author: AlanQuatermain

.gitignore

@@ -7,3 +7,4 @@
 *.pdf
 *.synctex.gz
 *.toc
+.DS_Store

CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+
+### Added
+
+* Theming class options:
+  - Eberron-style header/footers on request
+  - Font set options:
+    * `fonts=dmsguild` for DMs Guild fonts (freely available).
+    * `fonts=wotc` for canonical WotC (paid, fairly expensive) font sets.
+    * Leave off the option to get current default fonts.
+* Image floats, captioned and standalone, based on `tcolorbox`.
+* Stat blocks: small inline ones for sentient weapons, and fully-fledged blocks for vehicles.
+* Quotation and aside environments: on a slightly rotated sticky note, with an attribution (quotation) or not (aside).
+* Area references:
+  - Define ranges (e.g. `Area 10-12: Small prison cells`).
+  - Better ways to reach outside the current top-level area to reference things from elsewhere (e.g. reference 'Area A5' from within 'Area C2').
+  - `\DndAreaRef` now prints 'C5' instead of 'p. 32'.  Use `\DndAreaPageRef` to get 'p. 32' now.
+* Several utility macros:
+  - `\DndAbilityCheck` (DC 11 Strength) and `\DndSkillCheck` (DC 11 Strength (Athletics))
+  - Ability check macros built on those, e.g. `\DndStrSave{12}` gets 'DC 12 Strength'
+  - Skill check macros also built on those, e.g. `\DndAthletics{12}` gets 'DC 12 Strength (Athletics)', or `\DndAthletics[\conname]{12}` gets 'DC 12 Constitution (Athletics)'.
+
 ### Added
 * French translation
 

dndcore.def

@@ -19,6 +19,7 @@
 \RequirePackage {tikz} % drawing ornaments and lines
 \RequirePackage {xcolor}
 \RequirePackage {xparse} % \NewDocumentCommand and expl3
+\RequirePackage {graphicx}
 
 \sys_if_engine_luatex:T
   {
@@ -82,9 +83,13 @@
 % Main modules in alphabetical order
 \RequirePackage {lib/dndcomment}    % inline comment boxes
 \RequirePackage {lib/dndheader}     % fancy headers and footers
+\RequirePackage {lib/dndimage}      % image display
 \RequirePackage {lib/dndmonster}    % stat blocks
+\RequirePackage {lib/dndquote}      % quotation/aside blocks
 \RequirePackage {lib/dndreadaloud}  % read-aloud text
 \RequirePackage {lib/dndsections}   % section styling and special section headers
 \RequirePackage {lib/dndsidebar}    % sidebars
 \RequirePackage {lib/dndtable}      % tables
 \RequirePackage {lib/dndtoc}        % table of contents styling
+\RequirePackage {lib/dndvehicle}    % vehicle/ship stat blocks
+% \RequirePackage {lib/dndmonsterlookup} % monster stat references

dndoptions.clo

@@ -31,6 +31,14 @@
 \bool_new:N \l__dnd_multitoc_bool
 \bool_new:N \l__dnd_layout_bool
 \bool_new:N \l__dnd_no_deprecated_code_bool
+\bool_new:N \l__dnd_eberron_mode_bool
+\bool_new:N \l__dnd_img_draft_bool
+\tl_new:N \l__dnd_background_name_tl
+\tl_new:N \l__dnd_fontset_tl
+
+\tl_const:Nn \l__dnd_fontset_plain_tl {plain}
+\tl_const:Nn \l__dnd_fontset_wotc_tl {wotc}
+\tl_const:Nn \l__dnd_fontset_dmsguild_dl {dmsguild}
 
 \bool_set_true:N \l__dnd_multitoc_bool
 \bool_set_eq:NN \l__dnd_layout_bool \c__dnd_isclass_bool
@@ -48,18 +56,55 @@
       {
         \bool_set_true:N \l__dnd_show_background_bool
         \bool_set_true:N \l__dnd_show_footer_scroll_bool
+        \bool_set_false:N \l__dnd_eberron_mode_bool
+      },
+    bg / eberron .code:n =
+      {
+        \bool_set_true:N \l__dnd_show_background_bool
+        \bool_set_false:N \l__dnd_show_footer_scroll_bool
+        \bool_set_true:N \l__dnd_eberron_mode_bool
       },
     bg / print .code:n =
       {
         \bool_set_false:N \l__dnd_show_background_bool
         \bool_set_true:N \l__dnd_show_footer_scroll_bool
+        \bool_set_false:N \l__dnd_eberron_mode_bool
       },
     bg / none .code:n =
       {
         \bool_set_false:N \l__dnd_show_background_bool
         \bool_set_false:N \l__dnd_show_footer_scroll_bool
+        \bool_set_false:N \l__dnd_eberron_mode_bool
       },
     bg .initial:n = full,
+    
+    % Font choice: use wotc to use the official DnD fonts
+    fonts .choice:,
+    fonts / wotc .code:n =
+      {
+        \tl_set_eq:NN \l__dnd_fontset_tl \l__dnd_fontset_wotc_tl
+      },
+    fonts / dmsguild .code:n =
+      {
+        \tl_set_eq:NN \l__dnd_fontset_tl \l__dnd_fontset_dmsguild_tl
+      },
+    fonts / plain .code:n =
+      {
+        \tl_set_eq:NN \l__dnd_fontset_tl \l__dnd_fontset_plain_tl
+      },
+    fonts .initial:n = plain,
+    
+    % Draft-mode DndImage
+    img .choice:,
+    img / draft .code:n =
+      {
+        \bool_set_true:N \l__dnd_img_draft_bool
+      },
+    img / final .code:n =
+      {
+        \bool_set_false:N \l__dnd_img_draft_bool
+      },
+    img .initial:n = final,
 
     % Justified text
     justified .code:n =
@@ -129,6 +174,14 @@
 
 \ProcessKeysOptions { dnd / options }
 
+\bool_if:NTF \l__dnd_eberron_mode_bool
+  {
+    \tl_set:Nn \l__dnd_background_name_tl {img/eberron}
+  }
+  {
+    \tl_set:Nn \l__dnd_background_name_tl {img/paper}
+  }
+
 % BEGIN section to remove in version 1.0.0
 \bool_if:NF \c__dnd_isclass_bool
   {

img/eberron-recto.jpg

@@ -5,9 +5,9 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 % Page
-\definecolor {bgtan}    {HTML} {F7F2E5}	% DndReadAloud background
-\definecolor {bgtan2018}{HTML} {F9EFD6} % lighter version of bgtan from the 2018 Basic Rules
-\definecolor {pagegold} {HTML} {B89A67} % pagenumbers and footer
+\definecolor {bgtan}      {HTML} {F7F2E5}	% DndReadAloud background
+\definecolor {bgtan2018}  {HTML} {F9EFD6} % lighter version of bgtan from the 2018 Basic Rules
+\definecolor {pagegold}   {HTML} {B89A67} % pagenumbers and footer
 
 % Type
 \definecolor {titlered}    {HTML} {58180D} % titles
@@ -42,8 +42,11 @@
 
 % Element colors that do not respond to \DndSetThemeColor
 \colorlet {readaloudcolor} {bgtan} % DndReadAloud background
-\definecolor {statblockribbon} {HTML} {E69A28} % stat block top/bottom borders (gold)
-\definecolor {statblockbg}     {HTML} {FDF1DC} % stat block background (tan)
+\colorlet {quotecolor}     {PhbMauve} % DndQuotation background
+\definecolor {statblockribbon}   {HTML} {E69A28} % stat block top/bottom borders (gold)
+\definecolor {statblockbg}       {HTML} {FDF1DC} % stat block background (tan)
+\definecolor {vehiclestatbg}     {HTML} {F2FFFF} % vehicle stat block background (pale turquoise)
+\definecolor {vehiclestatribbon} {HTML} {8777BB}
 
 % Sets the themecolor and colors for all themed elements
 % If called without the optional color, resets the color of all themed elements to the current themecolor

img/eberron-verso.jpg

@@ -0,0 +1,14 @@
+\ExplSyntaxOn
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Compatibility with external packages
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\cs_if_free:NT \str_case_e:nnF
+  {
+    % \str_case_x was renamed \str_case_e mid-2018. \str_case_x will be removed
+    % at the end of 2019:
+    %
+    %   https://github.com/latex3/latex3/blob/8fcb571ddda61c01773d9746d32cecdbe63afb26/l3kernel/l3obsolete.txt#L65
+    \cs_new_eq:NN \str_case_e:nnF \str_case_x:nnF
+  }