Skip to content

mvuorre/quarto-apaish

Repository files navigation

APA7ish Quarto Typst PDF template

NOTE: I don't plan to develop this further, instead take a look at https://github.com/mvuorre/quarto-preprint for a more comprehensive & Quarto-compliant extension.

Quarto extension for creating APA7-ish (American Psychological Association style, 7th edition) manuscripts in PDF format via Typst. (See e.g. https://github.com/wjschne/apaquarto for a LaTeX PDF template.)

Three document modes (akin to man, doc, and jou here) are implemented. View the example documents at https://github.com/mvuorre/quarto-apaish/releases/latest:

"Manuscript" is the horrid "double-spaced everything on its own page" kind of document, "document" aims to be a basic LaTeX kind of one-column document, whereas "journal" is a two-column document similar to papers published in APA journals.

Install

Use quarto-apaish in an existing Quarto project:

quarto add mvuorre/quarto-apaish

Use

In your manuscript's Quarto source document, add the following YAML

format: apaish-typst

This creates a "manuscript" PDF. To create a "document" PDF, specify

format: 
  apaish-typst:
    documentmode: doc

And to create a "journal" PDF (for preprints etc), specify

format: 
  apaish-typst:
    documentmode: jou

Quarto documents use YAML metadata to control the document output. See the example .qmd file for examples.

Tips

Fonts

Feel free to use any system fonts, e.g.

font: "Libertinus serif"

Limitations

Typst has limited support for tables. A suggested workaround for anything but the most basic tables is to convert your tables to figures, either figuratively speaking or literally. An example of literally converting a table to a figure is shown in the example document.

You currently cannot show full-width content in two-column Typst documents, such as apaish-journal-typst. So I guess try to make your figures small in journal mode 🤷