README.md
 1  # Quarto sample article and report templates _(RUC_quarto_tmpl)_
 2  
 3  This is a set of Quarto templates
 4  for generating academic articles and reports
 5  striving to follow both the styles of classic danish book design
 6  and (at least the spirit of) APA.
 7  
 8  ## Template customizations
 9  
10  Some changes involve forks of template files
11  derived from Quarto 1.9.18 and Pandoc 3.8.3.
12  
13    * fix author and keyword enumeration in XMP metadata in PDF output
14    * use tagpdf-default hyperref colors (not hardcoded pandoc defaults)
15      <https://tex.stackexchange.com/q/525261/309738>
16    * use papersize a4 and fontsize 12pt by default
17    * add copyright and licensing metadata to XMP in PDF output
18    * add author affiliations to PDF titlepage,
19      listing authors horisontally due to non-localized "and" delimiter
20    * add author alternative naming using key author.alternative
21    * omit supervisor in metadata author field
22    * annotate author roles, ORCID and ROR on PDF titlepage,
23      with markers inspired by <https://quarto-journals.github.io/plos/>
24    * annotate supervisor role on PDF titlepage,
25      listed separately below main authors
26    * use localized quotation marks
27    * render PDF output as v2.0 with extensions PDF/4F and PDF/UA2
28    * mangle space-surrounded en-space into em-space
29      in US english (en-US) and generic english (en) strings
30    * use single space after punctuation to avoid "rivers"
31    * avoid widow or orphan lines
32    * avoid linebreak between a number and a unit or quantifier
33  
34  ## Localization
35  
36  A few english strings are introduced that can be localized
37  by setting corresponding language metadata in the front matter,
38  like this danish example:
39  
40  ```yaml
41  language:
42    title-block-equal-contributors: |
43      Disse forfattere bidrog ligeværdigt til dette arbejde
44    title-block-corresponing_author: Korresponderende forfatter
45    title-block-supervisor-single: Vejleder
46  ```
47  
48  To mangle space-surrounded en-space into em-space for other locales,
49  define the mangling locales like this (for any english and spanish):
50  
51  Mangling of space-surrounded en-space into em-space can be overridden
52  like this to mangle any english and generic spanish:
53  
54  ```yaml
55  en2em-langs:
56    - en*
57    - es
58  ```
59  
60  ## License
61  
62  Copyright © 2024  Jonas Smedegaard <dr@jones.dk>
63  
64  This work is licensed
65  under a Creative Commons Attribution-ShareAlike 4.0 International License
66  ([CC-BY-SA-4.0]).
67  
68  NB! Separate copyright and licensing notices exist
69  for subsets of this project licensed differently.
70  
71  [CC-BY-SA-4.0]: <https://creativecommons.org/licenses/by-sa/4.0/>
72    "Creative Commons Attribution-ShareAlike 4.0 International license"