Skip to content

Promote Typst #1917

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
cwickham wants to merge 1 commit into
base: prerelease
Choose a base branch
from
Draft

Promote Typst #1917

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions _quarto.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -227,19 +227,19 @@ website:
- docs/output-formats/html-lightbox-figures.qmd
- docs/output-formats/html-publishing.qmd
- docs/output-formats/html-accessibility.qmd
- section: "PDF"
- section: "PDF with LaTeX"
contents:
- docs/output-formats/pdf-basics.qmd
- docs/output-formats/pdf-engine.qmd
- section: "MS Word"
contents:
- docs/output-formats/ms-word.qmd
- docs/output-formats/ms-word-templates.qmd
- section: "Typst"
- section: "PDF with Typst"
contents:
- docs/output-formats/typst.qmd
- text: "Custom Formats"
href: docs/output-formats/typst-custom.qmd
- section: "MS Word"
contents:
- docs/output-formats/ms-word.qmd
- docs/output-formats/ms-word-templates.qmd
- section: "Markdown"
contents:
- docs/output-formats/gfm.qmd
Expand Down
12 changes: 8 additions & 4 deletions docs/output-formats/pdf-basics.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,14 @@ doc-type:

## Overview

::: callout-tip
## Other paths to PDF

[Typst](/docs/output-formats/typst.qmd) is an alternative way to produce PDFs that comes bundled with Quarto—no separate TeX installation required. If you're new to PDF generation, Typst may offer a quicker start.

Pandoc also supports creating PDFs using ConTeXt, roff ms, or HTML (via wkhtmltopdf). See the Pandoc documentation on [Creating a PDF](https://pandoc.org/MANUAL.html#creating-a-pdf) for details.
:::

Use the `pdf` format to create PDF output. For example:

``` yaml
Expand All @@ -25,10 +33,6 @@ This example highlights a few of the options available for PDF output. This arti

If you want to produce raw LaTeX output (a .tex file) rather than a PDF, all of the options documented here are still available (see the [LaTeX Output] section below for additional details).

::: callout-note
Note that while we will focus here exclusively on the use of LaTeX to create PDFs, Pandoc also has support for creating PDFs using ConTeXt, roff ms, or HTML (via wkhtmltopdf). See the Pandoc documentation on [Creating a PDF](https://pandoc.org/MANUAL.html#creating-a-pdf) for additional details.
:::

### Prerequisites

In order to create PDFs you will need to install a recent distribution of TeX. We recommend the use of TinyTeX (which is based on TexLive), which you can install with the following command:
Expand Down
6 changes: 6 additions & 0 deletions docs/output-formats/pdf-engine.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ format: html

## Overview

::: callout-tip
## Looking for a simpler path to PDF?

[Typst](/docs/output-formats/typst.qmd) is an alternative way to produce PDFs that comes bundled with Quarto—no separate TeX installation required. If you're new to PDF generation, Typst may offer a quicker start.
:::

Pandoc supports the use of a wide range of TeX distributions and PDF compilation engines including pdflatex, xelatex, lualatex, tectonic, and latexmk.

While you can employ whatever toolchain you like for LaTeX compilation, we strongly recommend the use of [TinyTeX](https://yihui.org/tinytex/), which is a distribution of [TeX Live](https://tug.org/texlive/) that provides a reasonably sized initial download (\~100 MB) that includes the 200 or so most commonly used TeX packages for Pandoc documents.
Expand Down