Issue #31,#41: Added support for background images on the title page.

README.md

@@ -67,6 +67,9 @@ This template defines some new variables to control the appearance of the result
 - `titlepage-rule-height` (defaults to `4`)
 
     the height of the rule on the top of the title page (in points)
+- `titlepage-background`
+
+    the path to a background image for the title page. The background image is scaled to cover the entire page. In the examples folder under `titlepage-background` are a few example background images.
 - `caption-justification` (defaults to `raggedright`)
 
     justification setting for captions (uses the `justification` parameter of the [caption](https://ctan.org/pkg/caption?lang=en) package)
@@ -193,14 +196,18 @@ There will be one blank page before each chapter because the template is two-sid
 
 ### Example Images
 
-A green title page      |  Code blocks styled with listings
+A green title page | A background image on the title page
 :-------------------------:|:-------------------------:
-[![A green title page](examples/green-titlepage/green-titlepage.png)](examples/green-titlepage/green-titlepage.pdf)  |  [![Code blocks styled with listings](examples/listings/listings.png)](examples/listings/listings.pdf)
+[![A green title page](examples/green-titlepage/green-titlepage.png)](examples/green-titlepage/green-titlepage.pdf)  |  [![A background image on the title page](examples/titlepage-background/titlepage-background.png)](examples/titlepage-background/titlepage-background.pdf)
 
-images and tables      |  Code blocks styled without listings
+images and tables | Code blocks styled without listings
 :-------------------------:|:-------------------------:
 [![images and tables](examples/images-and-tables/images-and-tables.png)](examples/images-and-tables/images-and-tables.pdf)  |  [![Code blocks styled without listings](examples/without-listings/without-listings.png)](examples/without-listings/without-listings.pdf)
 
+A book | Code blocks styled with listings
+:-------------------------:|:-------------------------:
+[![A book](examples/book/book.png)](examples/book/book.pdf)  |  [![Code blocks styled with listings](examples/listings/listings.png)](examples/listings/listings.pdf)
+
 ## Credits
 
 - This template includes code for styling block quotations from [pandoc-letter](https://github.com/aaronwolen/pandoc-letter) by [Aaron Wolen](https://github.com/aaronwolen).

examples/titlepage-background/titlepage-background.md

@@ -1,9 +1,10 @@
 ---
-title: "Example PDF"
-author: [Author]
-date: 2019-08-04
+title: "Vinaque sanguine metuenti cuiquam Alcyone fixus"
+author: [Author Name]
+date: "2017-02-20"
 subject: "Markdown"
 keywords: [Markdown, Example]
+subtitle: "Aesculeae domus vincemur et Veneris adsuetus lapsum"
 lang: "en"
 titlepage: true,
 titlepage-rule-color: "360049"
@@ -51,7 +52,7 @@ vel pede inter si.
 Tamen condeturque saxa Pallorque num et ferarum promittis inveni lilia iuvencae
 adessent arbor. Florente perque at condeturque saxa et ferarum promittis tendebat. Armos nisi obortas refugit me.
 
-> Et nepotes poterat, se qui. Euntem ego pater desuetaque aethera Maeandri, et
+Et nepotes poterat, se qui. Euntem ego pater desuetaque aethera Maeandri, et
 [Dardanio geminaque](http://example.com#Dardanio_geminaque) cernit. Lassaque poenas
 nec, manifesta $\pi r^2$ mirantia captivarum prohibebant scelerato gradus unusque
 dura.