Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mvuorre/quarto-apaish
APA7-ish Quarto templates
https://github.com/mvuorre/quarto-apaish
quarto quarto-extension typst
Last synced: 2 days ago
JSON representation
APA7-ish Quarto templates
- Host: GitHub
- URL: https://github.com/mvuorre/quarto-apaish
- Owner: mvuorre
- License: cc0-1.0
- Created: 2023-10-09T19:08:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-19T13:50:11.000Z (7 months ago)
- Last Synced: 2025-01-20T22:57:50.300Z (8 days ago)
- Topics: quarto, quarto-extension, typst
- Language: Typst
- Homepage: https://github.com/mvuorre/quarto-apaish/releases/latest/download/example-journal.pdf
- Size: 333 KB
- Stars: 18
- Watchers: 3
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# APA7ish Quarto Typst PDF template
**NOTE: I don't plan to develop this further, instead take a look at 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. 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 :
- [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 🤷