inst/memarticle/README.md

In agoldst/scuro: An R Markdown Beamer-Presentation Setup

A memoir-based article template for markdown

This pandoc template and Makefile make it possible to generate an article-length document in PDF, making use of some of the layout and formatting capacities of the memoir package. The included Makefile allows us to govern xelatex and biber with a single make (relying on latexmk to determine the number of passes needed).

The included memoir-article.latex template adds support for a few further metadata variables:

anon: Remove author information (including from PDF metadata) for anonymous submission.

thanks: An unnumbered note is added to the first package with the contents of this variable (which can be any LaTeX).

Fonts: the mainfont, mainfontoptions, etc. metadata variables work as in the pandoc default. The typeface for the title block can be configured with titlefont. (If none is specified, the main font is used.)

Page headers and footers: these can be set with metadata variables olhead (odd-side left header), ecfoot (even-side center footer), etc.; these variables can contain LaTeX (e.g. ecfoot: '\thepage').

If the title block layout used here does not appeal, set manual-title: true (in which case \maketitle is not used) and compose one as you prefer.

On my system, the example paper.md is converted into this PDF: paper.pdf. I have used a commercial font, Garamond Premier Pro. Change mainfont (and titlefont, and the corresponding *options) to your own choices. The name of any system font should work.

Note in the example paper.md file the use of classoption: [oneside] to set symmetric margins. More exacting control over the overall page layout is best achieved by using memoir's layout commands in the document preamble, by writing LaTeX in the header-includes: YAML field.

Chicago Style

To use the marvelous biblatex-chicago package for Chicago Manual of Style bibliography generation, set:

biblatex: true
biblatex-chicago: true
biblatexoptions: notes
bibliography: ../mybib.bib

Note that the bibliography path is relative to the out directory that is created by the Makefile. The biblatexoptions are given to biblatex-chicago (e.g. you might try [notes,short,noibid]).

Footnotes are also formatted according to Chicago's recommendations. To use widely spaced ellipses, specify chicago-ellipses: true.

If you use full citations in notes and do not want a bibliography, use option nobib: true.

Relationship to pandoc defaults

The template is closely modeled on pandoc's default.latex but I do not keep up with every change made upstream. The current memoir-article.latex follows the template in pandoc 2.16.

agoldst/scuro documentation built on Nov. 5, 2021, 3:44 a.m.