Match template closer

Author: mikemahoney218

README.md

@@ -2,11 +2,17 @@
 
 This is a Quarto template that assists you in creating PDF outputs which closely match those published on arXiv. If you are intending to publish your article on arXiv, it is highly recommended you upload your TeX files (and supporting files, including generated `.bbl` and figure files) directly. However, this template supports rendering PDFs which resemble arXiv preprints for upload to other repositories either before or instead of submission to arXiv itself.
 
-Please note this template should be considered an early alpha as I work out a few mismatches between the current output and the arXiv style.
+There are currently a few differences between the PDFs generated by this template and those generated by arXiv:
+
+1. The fonts and spacings are not a perfect match. PRs to fix this are more than welcome.
+2. ORCiD IDs will be rendered as clickable logos next to author names.
+3. Emails will be displayed as hyperlinks, not in monospaced fonts.
+
+Any other differences are unintentional bugs -- please open an issue about anything you encounter!
 
 ## Creating a New Article
 
-You can use this as a template to create a preprint for ArXiV. To do this, use the following command:
+You can use this as a template to create a preprint for ArXiv. To do this, use the following command:
 
 ```quarto use template mikemahoney218/quarto-arxiv```
 

_extensions/arxiv/_extension.yml

@@ -1,20 +1,21 @@
 title: ArXiV Template
 author: Mike Mahoney
-version: 0.0.1
+version: 0.1.0
 contributes:
   formats:
     common:
       # define below YAML configuration common to all formats
       filters:
         # You can include here Lua filters from your extension format 
-        - scholarly-metadata.lua
-        - author-info-blocks.lua
+        #- scholarly-metadata.lua
+        #- author-info-blocks.lua
       shortcodes:
         # You can include here Lua filters defining shortcodes from your extension
         - shortcodes.lua
       knitr:
         opts_chunk:
           echo: false
+      number-sections: true
     pdf:
       # define default configuration for the pdf version of your format
       documentclass: article
@@ -23,13 +24,12 @@ contributes:
         \usepackage{arxiv}
         \usepackage{orcidlink}
         \usepackage{amsmath}
-#      template-partials:
+        \usepackage[T1]{fontenc}
+      template-partials: ["partials/_authors.tex", "partials/title.tex", "partials/before-body.tex"]
       format-resources:
         # Add here the resources required for the PDF rendering
         - arxiv.sty
     html:
-      # define default configuration for the html version of your format
-      number-sections: true
       toc: true
       # Use a CSL file to style (https://www.zotero.org/styles/)
       csl: https://www.zotero.org/styles/chicago-author-date-16th-edition

_extensions/arxiv/arxiv.sty

@@ -32,13 +32,6 @@
 \rhead{\scshape A preprint - \today}
 \cfoot{\thepage}
 
-
-%Handling Keywords
-\def\keywordname{{\bfseries \emph Keywords}}%
-\def\keywords#1{\par\addvspace\medskipamount{\rightskip=0pt plus1cm
-\def\and{\ifhmode\unskip\nobreak\fi\ $\cdot$
-}\noindent\keywordname\enspace\ignorespaces#1\par}}
-
 % font sizes with reduced leading
 \renewcommand{\normalsize}{%
   \@setfontsize\normalsize\@xpt\@xipt

_extensions/arxiv/partials/_authors.tex

@@ -0,0 +1,10 @@
+$-- You can use as many custom partials as you need. Convention is to prefix name with '_'
+$-- It can be useful to use such template to split some template parts in smaller pieces, which is easier to reuse. 
+$-- This '_custom.tex' is used on 'title.tex' as example.
+$-- See other existing format in quarto-journals/ organisation.
+$-- %%%% TODO %%%%%
+$-- Use it if you need to insert content at this specific place of the main Pandoc's template. Otherwise, remove it.
+$-- Here we are using it to format the authors part of the template.
+$-- %%%%%%%%%%%%%%%
+
+$it.name.literal$$if(it.orcid)$~\orcidlink{$it.orcid$}$endif$$for(it.affiliations/first)$\\$it.department$\\$it.name$\\$if(it.city)$$it.city$$if(it.postal-code)$,\ $it.postal-code$$endif$$endif$$endfor$\\$if(it.email)$\href{mailto:$it.email$}{$it.email$}$endif$

_extensions/arxiv/partials/before-body.tex

@@ -0,0 +1,27 @@
+$-- Implements the frontmatter, title page, and abstract.
+$--
+$-- %%%% TODO %%%%%
+$-- Customize is needed, otherwise remove this partials to use Quarto default one
+$-- %%%%%%%%%%%%%%%%
+$if(has-frontmatter)$
+\frontmatter
+$endif$
+$if(title)$
+$if(beamer)$
+\frame{\titlepage}
+$else$
+\maketitle
+$endif$
+$if(abstract)$
+\begin{abstract}
+$abstract$
+\end{abstract}
+$endif$
+$endif$
+$if(keywords)$
+{\bfseries \emph Keywords}
+\def\sep{\textbullet\ }
+$for(keywords/allbutlast)$$keywords$ \sep $endfor$
+$for(keywords/last)$$keywords$$endfor$
+
+$endif$

_extensions/arxiv/partials/title.tex

@@ -0,0 +1,21 @@
+$-- Provides configuration of document metadata for writing the title block. 
+$-- Note that in addition to these templates and partials, Quarto will also make normalized authors and affiliations data available to the template, 
+$-- making is easy to write custom title blocks against a standard schema.
+$--
+$-- %%%% TODO %%%%%
+$-- Customize is needed, like below for printing the authors. Otherwise remove this partials to use Quarto default one. 
+$-- %%%%%%%%%%%%%%%%
+$if(title)$
+\title{$title$$if(thanks)$\thanks{$thanks$}$endif$}
+$endif$
+$if(subtitle)$
+\usepackage{etoolbox}
+\makeatletter
+\providecommand{\subtitle}[1]{% add subtitle to \maketitle
+  \apptocmd{\@title}{\par {\large #1 \par}}{}{}
+}
+\makeatother
+\subtitle{$subtitle$}
+$endif$
+\author{${ by-author:_authors.tex()[\and \\] }}
+\date{$date$}

template.qmd

@@ -4,25 +4,37 @@ format:
   arxiv-pdf:
     keep-tex: true  
   arxiv-html: default
-institute:
-  - gpes: Graduate Program in Environmental Science, State University of New York College of Environmental Science and Forestry, 1 Forestry Drive, Syracuse, NY, 13210
-  - srm: Department of Sustainable Resources Management, State University of New York College of Environmental Science and Forestry, 1 Forestry Drive, Syracuse, NY, 13210
 author:
-  - Michael J Mahoney:
-      institute: [gpes]
-      email: [email protected]
-      correspondence: "yes"
-  - Some One Else:
-      institute: [srm]
+  - name: Michael J Mahoney
+    affiliations:
+      - name: State University of New York College of Environmental Science and Forestry
+        department: Graduate Program in Environmental Science
+        address: 1 Forestry Drive
+        city: Syracuse, NY
+        country: USA
+        postal-code: 13210
+    orcid: 0000-0003-2402-304X
+    email: [email protected]
+    url: https://mm218.dev
+  - name: Someone Else
+    affiliations:
+      - name: State University of New York College of Environmental Science and Forestry
+        department: Department of Sustainable Resources Management
+        address: 1 Forestry Drive
+        city: Syracuse, NY
+        country: USA
+        postal-code: 13210
 abstract: |
   This document is only a demo explaining how to use the template.
-keywords: [template, demo]
+keywords: 
+  - template
+  - demo
 bibliography: bibliography.bib  
 ---
 
 # Introduction {#sec-intro}
 
-This is an example of how to use this template to render articles in the standard arXiv format. Please note that this template is still in alpha as I work out some of the mismatches between PDF output and the arXiv style.
+This is an example of how to use this template to render articles in the standard arXiv format. 
 
 This quarto extension format supports PDF and HTML outputs. `quarto-journals` is aiming at porting existing {{< latex >}} template from journals to be used with quarto. PDF format is what require the most work to fit the journals guideline, but Quarto offer a nice rendering for HTML output too. This template only uses basic HTML format without any customization for now.
 
@@ -56,9 +68,9 @@ m_pois <- glm(Days ~ (Eth + Sex + Age + Lrn)^2, data = quine, family = poisson)
 kableExtra::kbl(broom::tidy(m_pois))
 ```
 
-## Using references {.unnumbered}
+## Using references
 
-I did not read this book [@CameronTrivedi2013] but it must be interesting 
+I did not read this book [@CameronTrivedi2013] but it must be interesting.
 
 {{< pagebreak >}}