# 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](https://quarto.org) extension for creating APA7-ish (American Psychological Association style, 7th edition) manuscripts in PDF format via [Typst](https://typst.app/docs). (See e.g. <https://github.com/wjschne/apaquarto> for a LaTeX PDF template.)

Three document modes (akin to man, doc, and jou [here](https://mirror.lyrahosting.com/CTAN/macros/latex/contrib/apa7/apa7.pdf)) are implemented. View the example documents at <https://github.com/mvuorre/quarto-apaish/releases/latest>: 

- [Manuscript](https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-manuscript.pdf)
- [Document](https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-document.pdf)
- [Journal](https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-journal.pdf)

"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:

```bash
quarto add mvuorre/quarto-apaish
```

## Use

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

```yaml
format: apaish-typst
```

This creates a "[manuscript]((https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-manuscript.pdf))" PDF. To create a "[document](https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-document.pdf)" PDF, specify

```yaml
format: 
  apaish-typst:
    documentmode: doc
```

And to create a "[journal](https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-journal.pdf)" PDF (for preprints etc), specify

```yaml
format: 
  apaish-typst:
    documentmode: jou
```

Quarto documents use YAML metadata to control the document output. See the [example .qmd file](https://github.com/mvuorre/quarto-apaish/blob/main/example.qmd) for examples.

### Tips

#### Fonts

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

```yaml
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](https://github.com/typst/typst/issues/2360) 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 🤷
