eaydin version

I've added some custom variables to the Eisvogel template. Keeping the original README below especially (along with the whole repo of the version I've forked from). The options I've added (currently) are listed along with the already existing ones below:

---
title: "The title"
subtitle: "The subtitle"
author: [M. Emre Ayın, Galileo Galilei]
authors-on-title: true
date: "15 June 2019"
document-revision: "0.3.5"
document-revision-wording: "Current Version:"
keywords: [Uptime, Telescopes, Runtime Compilation]
lang: "en"
titlepage: true
titlepage-color: "FFFFFF"
titlepage-text-color: "00000A"
titlepage-rule-color: "10000A"
titlepage-rule-height: 2
toc-own-page: true
toc: true
toc-title: "Alternative Description for Contents"
logo: somelogo.png
papersize: a4
total-page-number: true
total-pages-on-title: true
total-pages-wording: "Number of total pages:"
skip-title-page-number: true
disable-footer: false
# header-left:
# header-center: central
# header-right: None
footer-left: "Other than Authors?"
# footer-center: None
# footer-right: None
logo-width: 150
lof: true
lof-own-page: true
lof-title: "Custom Title For List of Figures"
lof-no-color: true
figure-name: "Yet Another Figure"
url-style-same: false
lot: true
lot-title: "Alternative Name for List of Tables"
lot-no-color: true
lot-own-page: true
table-name: "Yet Another Table"
linkcolor: airforceblue
urlcolor: coolblack

...

Recommended command to create PDF:

First copy the ea_eisvogel.tex file to ~/.pandoc/templates/ea_eisvogel.latex. Then run the following with test.md being your markdown file:

pandoc test.md -o test.pdf --from markdown --template ea_eisvogel --listings --number-sections

In order to create citations, use a BibTex database and provide a valid csl. The CSL file should be located in the running directory (Probably ~/.csl would work too).

In the documents, cite to references with [@some-ref-id] notation. This should use the CSL format to show the citations.

The command below will produce an output with relavent bibliography databases:

pandoc report.md -o report.pdf --from markdown --template ea_eisvogel --listings --number-sections --bibliography=report.bib --csl=chicago.csl

This assumes we have a report.bib in the folder with BibTex style references, and chicago.csl for the Citation Style Language we want to use.

If you want to name the references section, simply give the last section name the one you want. When it has no text in it, it will not number the section and use it as a header for the references.

Please note that you need to install pandoc-citeproc package in order to generate citations.

I usually prefer using the atmosphere-ocean csl located here: https://www.zotero.org/styles?q=id%3Aatmosphere-ocean after downloading it, place it to ~/.csl/ to access easily. Now creating the PDF with references:

pandoc report.md -o report.pdf --from markdown --template ea_eisvogel --listings --number-sections --bibliography=report.bib --csl=atmosphere-ocean.csl

Floating Elements

Sometimes listings can float over normal text. This occurs at the beginning of the listing. In order to overcome this, a simple workaround is to but a backslash and a space after it between the text and the listing. Example

some text over here that gets buried under the listing. Note that backslash below has a space following it on the same line.

\ 

here goes the listing starting and ending with backticks...

Footnotes

Even though pandoc supports footnotes in a rather cool way, this template does not support using it in conjunction with the footer option set. So be careful about it. If I find a workaround, I'll update these lines.

New Colors

New colors to the template can be added easily. Colors are defined right below the \usepackage{xcolor} line. Here, simply define a color. A good list of colors that can be easily used in LaTeX can be found here: http://latexcolor.com/

Eisvogel

A clean pandoc LaTeX template to convert your markdown files to PDF or LaTeX. It is designed for lecture notes and exercises with a focus on computer science. The template is compatible with pandoc 2.

Preview

A custom title page	A basic example page
$A custom title page$	$A basic example page$

Installation

Install pandoc from http://pandoc.org/. You also need to install LaTeX.
Download the latest version of the Eisvogel template from the release page.
Extract the downloaded ZIP archive and open the folder.
Move the template eisvogel.tex to your pandoc templates folder and rename the file to eisvogel.latex. The location of the templates folder depends on your operating system:
- Unix, Linux, macOS: $XDG_DATA_HOME/pandoc/templates or ~/.pandoc/templates/
- Windows XP: C:\Documents And Settings\USERNAME\Application Data\pandoc\templates
- Windows Vista or later: C:\Users\USERNAME\AppData\Roaming\pandoc\templates
If there are no folders called templates or pandoc you need to create them and put the template eisvogel.latex inside.

Usage

Open the terminal and navigate to the folder where your markdown file is located.
Execute the following command
```
pandoc example.md -o example.pdf --from markdown --template eisvogel --listings
```
where example.md is the markdown file you want to convert to PDF.

In order to have nice headers and footers you need to supply metadata to your document. You can do that with a YAML metadata block at the top of your markdown document (see the example markdown file). Your markdown document may look like the following:

---
title: "The Document Title"
author: [Example Author, Another Author]
date: "2017-02-20"
keywords: [Markdown, Example]
...

Here is the actual document text...

Custom Template Variables

This template defines some new variables to control the appearance of the resulting PDF document. The existing template variables from pandoc are all supported and their documentation can be found in the pandoc manual.

titlepage (defaults to false)

turns on the title page when true
titlepage-color

the background color of the title page. The color value must be given as an HTML hex color like D8DE2C without the leading number sign (#). When specifying the color in YAML, it is advisable to enclose it in quotes like so titlepage-color: "D8DE2C" to avoid the truncation of the color (e.g. 000000 becoming 0).
titlepage-text-color (defaults to 5F5F5F)

the text color of the title page
titlepage-rule-color (defaults to 435488)

the color of the rule on the top of the title page
titlepage-rule-height (defaults to 4)

the height of the rule on the top of the title page (in points)
caption-justification (defaults to raggedright)

justification setting for captions (uses the justification parameter of the caption package)
toc-own-page (defaults to false)

begin new page after table of contents, when true
listings-disable-line-numbers (defaults to false)

disables line numbers for all listings
listings-no-page-break (defaults to false)

avoid page break inside listings
disable-header-and-footer (default to false)

disables the header and footer completely on all pages
header-left (defaults to the title)

the text on the left side of the header
header-center

the text in the center of the header
header-right (defaults to the date)

the text on the right side of the header
footer-left (defaults to the author)

the text on the left side of the footer
footer-center

the text in the center of the footer
footer-right (defaults to the page number)

the text on the right side of the footer
book (defaults to false)

typeset as book
logo

path to an image that will be displayed on the title page. The path is always relative to where pandoc is executed. The option --resource-path has no effect.
logo-width (defaults to 100)

the width of the logo (in points)
first-chapter (defaults to 1)

if typesetting a book with chapter numbers, specifies the number that will be assigned to the first chapter
float-placement-figure (defaults to H)

Reset the default placement specifier for figure environments to the supplied value e.g. htbp. The available specifiers are listed below. The first four placement specifiers can be combined.
1. h: Place the float here, i.e., approximately at the same point it occurs in the source text.
2. t: Place the float at the top of the page.
3. b: Place the float at the bottom of the page.
4. p: Place the float on the next page that will contain only floats like figures and tables.
5. H: Place the float HERE (exactly where it occurs in the source text). The H specifier is provided by the float package and may not be used in conjunction with any other placement specifiers.

Examples

Numbered Sections

For PDFs with numbered sections use the --number-sections or -N option.

pandoc example.md -o example.pdf --template eisvogel --number-sections

Syntax Highlighting with Listings

You can get syntax highlighting of delimited code blocks by using the LaTeX package listings with the option --listings. This example will produce the same syntax highlighting as in the example PDF.

pandoc example.md -o example.pdf --template eisvogel --listings

Syntax Highlighting Without Listings

The following examples show syntax highlighting of delimited code blocks without using listings. To see a list of all the supported highlight styles, type pandoc --list-highlight-styles.

pandoc example.md -o example.pdf --template eisvogel --highlight-style pygments

pandoc example.md -o example.pdf --template eisvogel --highlight-style kate

pandoc example.md -o example.pdf --template eisvogel --highlight-style espresso

pandoc example.md -o example.pdf --template eisvogel --highlight-style tango

Standalone LaTeX Document

To produce a standalone LaTeX document for compiling with any LaTeX editor use .tex as an output file extension.

pandoc example.md -o example.tex --template eisvogel

Changing the Document Language

The default language of this template is American English. The lang variable identifies the main language of the document, using a code according to BCP 47 (e.g. en or en-GB). For an incomplete list of the supported language codes see the documentation for the hyph-utf8 package (Section 2). The following example changes the language to British English:

pandoc example.md -o example.pdf --template eisvogel -V lang=en-GB

The following example changes the language to German:

pandoc example.md -o example.pdf --template eisvogel -V lang=de

Typesetting a Book

To typeset a book supply the template variable -V book from the command line or via book: true in the metadata.

To get the correct chapter headings you need to tell pandoc that it should convert first level headings (indicated by one # in markdown) to chapters with the command line option --top-level-division=chapter. Chapter numbers start at 1. If you need to change that, specify first-chapter in the template variables.

There will be one blank page before each chapter because the template is two-sided per default. So if you plan to publish your book as a PDF and don't need a blank page you should add the class option onesided which can be done by supplying a template variable -V classoption=oneside.

Example Images

A green title page	Code blocks styled with listings
$A green title page$	$Code blocks styled with listings$

images and tables	Code blocks styled without listings
$images and tables$	$Code blocks styled without listings$

Credits

This template includes code for styling block quotations from pandoc-letter by Aaron Wolen.

License

This project is open source licensed under the BSD 3-Clause License. Please see the LICENSE file for more information.

eaydin / pandoc-latex-template