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"