Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mikemahoney218/quarto-arxiv

Quarto template for arXiv preprints
https://github.com/mikemahoney218/quarto-arxiv

arxiv latex pandoc pdf pdf-generation publishing python quarto quarto-extension quarto-template r rstats tex

Last synced: 3 months ago
JSON representation

Quarto template for arXiv preprints

Awesome Lists containing this project

README 

        
# ArXiv Template



This is a Quarto template that assists you in creating PDF outputs which closely match the arXiv template for the rticles package (which is itself derived from [kourgeorge/arxiv-style](https://github.com/kourgeorge/arxiv-style)). If you are intending to publish your article on arXiv, it is highly recommended you upload your TeX files (and supporting files) directly. However, this template supports rendering decent looking PDFs for upload to other repositories either before or instead of submission to arXiv itself. The TeX generated from the default `.qmd` template also passes arxiv's pre-submission build process and checks, and so preprints generated from this template _may_ be able to be submitted to arXiv without any alterations.



There are currently a few differences between the PDFs generated by this template and those generated by the arXiv rticles template:



1. The fonts and spacings are not a perfect match. PRs to fix this are more than welcome.

2. References and links are not currently hyperlinked. PRs to fix this also more than welcome.

3. ORCiD IDs will be rendered as clickable logos next to author names. This is an intentional change.

4. Emails will be displayed as hyperlinks, and not in monospaced font. This is intentional.

5. Authors with multiple affiliations will have each affiliation listed. This is intentional.



Any other differences are unintentional bugs -- please open an issue about anything you encounter!



## Installation



You can use this as a template to create a new article. To do this, use the following command:



```bash

quarto use template mikemahoney218/quarto-arxiv

```



This will install the extension and create an example qmd file and bibiography that you can use as a starting place for your article.



You may also use this format with an existing Quarto project or document. From the quarto project or document directory, run the following command to install this format:



```bash

quarto install extension mikemahoney218/quarto-arxiv

```



This template uses the Latin Modern family of fonts. On Mac, you might need to install these using:



```bash

brew tap homebrew/cask-fonts

brew install font-latin-modern

brew install font-latin-modern-math

```



On Ubuntu, you might need to install these fonts using:



```bash

sudo apt install lmodern

```



If you have installation instructions for these fonts on another platform, please feel free to open an issue or send in a PR!



## Usage



To use the format, you can use the format names `arxiv-pdf` and `arxiv-html`. For example:



```bash

quarto render article.qmd --to arxiv-pdf

```



or in your document yaml



```yaml

format:

  pdf: default

  arxiv-pdf:

    keep-tex: true    

```



You can view a preview of the rendered template at .



This template provides a few custom YAML header options to control the PDF output:



```yaml

linenumbers: false # Add (continuous) line numbers?

doublespacing: false # Double space the PDF output?

runninghead: "A Preprint" # The text on the top of each page of the output

authorcols: false # Should authors be listed in a single column (default) or in multiple columns (`authorcols: true`)

```



Both `linenumbers` and `doublespacing` are booleans, defaulting to `false`, 

and were added in version 0.2.0. `runninghead` can be any text and was added

in version 0.2.1. You can define these either as top-level options, or under 

`arxiv-pdf`; they only impact the generated PDF.



## In The Wild



Use this template for a paper or a preprint? [Let me know,](https://github.com/mikemahoney218/quarto-arxiv/issues/new) and I'll add it to the list below!



The following papers were rendered using this template:



+ [Fine-resolution landscape-scale biomass mapping using a spatiotemporal patchwork of LiDAR coverages](https://arxiv.org/pdf/2205.08530.pdf) -- now published at [International Journal of Applied Earth Observation and Geoinformation](https://doi.org/10.1016/j.jag.2022.103059)!

+ [Classification and mapping of low-statured ‘shrubland’ cover types in post-agricultural landscapes of the US Northeast](https://arxiv.org/pdf/2205.05047.pdf) (version 1) -- now published at [International Journal of Remote Sensing](https://doi.org/10.1080/01431161.2022.2155086)!

+ [Borch: A Deep Universal Probabilistic Programming Language](https://arxiv.org/abs/2209.06168)

+ [Analysing and visualising bike-sharing demand with outliers](https://arxiv.org/abs/2204.06112) (version 2)

+ [RANG: Reconstructing reproducible R computational environments](https://arxiv.org/abs/2303.04758) (with source code at https://github.com/chainsawriot/rang/tree/paper/paper !)

+ [Assessing the performance of spatial cross-validation approaches for models of spatially structured data](https://arxiv.org/abs/2303.07334) (with source code at https://github.com/cafri-labs/assessing-spatial-cv/ !)

+ [waywiser: Ergonomic Methods for Assessing Spatial Models](https://arxiv.org/abs/2303.11312)

+ [Mapping historical forest biomass for stock-change assessments at parcel to landscape scales](https://arxiv.org/abs/2304.02632) -- now published at [Forest Ecology and Management](https://doi.org/10.1016/j.foreco.2023.121348)!

+ [tmfast fits topic models fast](https://arxiv.org/abs/2305.01535)

+ [Strategies and Challenges for Creating Systematic Individual Reports in R using RMarkdown and Quarto](https://doi.org/10.31235/osf.io/2jx9a)