Download raw body.
pandoc: pkg-readme concerning PDF output
On Sun, Feb 25, 2024 at 11:50:28AM -0800, Evan Silberman wrote:
> job@ emailed me asking why PDF output for pandoc via LaTeX was failing.
> Here's a pkg-readme about that.
>
> -----------------------------------------------
> commit 86a9ed9487281ed9cebbbcfda4d3989dc603a1c4 (master)
> from: Evan Silberman <evan@jklol.net>
> date: Sun Feb 25 19:48:17 2024 UTC
>
> Add a pkg-readme concerning PDF output
>
> diff a18126b97cb145ff893d6fd7356f0af4cfb07383 86a9ed9487281ed9cebbbcfda4d3989dc603a1c4
> commit - a18126b97cb145ff893d6fd7356f0af4cfb07383
> commit + 86a9ed9487281ed9cebbbcfda4d3989dc603a1c4
> blob - ab326cff68ef82345156ce5a9c598d7d043b8c5d
> blob + e6b38f6738430522bca61316801e2bbf0a87210d
> --- textproc/pandoc/Makefile
> +++ textproc/pandoc/Makefile
> @@ -1,6 +1,7 @@
> V = 3.1.12.1
> COMMENT = convert between markup and document formats
> PKGNAME = pandoc-${V}
> +REVISION = 0
>
> CATEGORIES = converters textproc
>
> blob - 4ebc16ad3a98cae122f25b75c1dba37c3106c7a7
> blob + 8cc3b2217127fa785a3dd84d6c11967a320e3bce
> --- textproc/pandoc/pkg/PLIST
> +++ textproc/pandoc/pkg/PLIST
> @@ -2,3 +2,4 @@
> @man man/man1/pandoc-lua.1
> @man man/man1/pandoc-server.1
> @man man/man1/pandoc.1
> +share/doc/pkg-readmes/${PKGSTEM}
> blob - /dev/null
> blob + c959cfa7bfa1231cec8ddb7ed88f2be5e86a5083 (mode 644)
> --- /dev/null
> +++ textproc/pandoc/pkg/README
> @@ -0,0 +1,27 @@
> +PDF output for pandoc on OpenBSD
> +================================
> +
> +Pandoc's PDF output mode relies on external programs to render a PDF from a
> +markup format. By default, PDF output uses LaTeX and pandoc's default LaTeX
> +template requires a number of common packages. On OpenBSD, installing
> +texlive_texmf-minimal is sufficient for pandoc to generate PDFs via LaTeX.
> +
> +The table below lists the PDF engines directly supported by pandoc for each
> +output format and, when available, the OpenBSD package providing the required
> +executable. For complete details on the --pdf-engine option see the pandoc
> +manual.
> +
> +Output format PDF Engine OpenBSD package
> +-------------- ----------- ----------------
> +latex latexmk latexmk
I won't call latexmk "PDF Engine". Latexmk is an engine-agnostic
stript to run pdf/lua/xe/latex sufficiently many times (perhaps
adding a call to biber or bibtex) to produce the final result.
It won't work without the appropriate engine installed.
> +latex lualatex texlive_base
> +latex pdflatex texlive_base
> +latex tectonic n/a (not in ports)
> +latex xelatex texlive_texmf-minimal
> +context context texlive_texmf-context (broken on OpenBSD)
> +html pagedjs-cli n/a (NPM package)
> +html prince n/a (commercial/proprietary)
> +html weasyprint weasyprint
> +html wkhtmltopdf wkhtmltopdf
> +ms pdfroff groff
> +typst typst n/a (not in ports)
>
I'd also say that a popular pandoc LaTeX output format is beamer (beamer is a
LaTeX package to create presentations), which, I
think, is in full texlive, not minimal, on OpenBSD. And beamer output
format can also be used to output pdfs. So it seems it's missing in the
table, and it also contracdicts the claim above that
texlive_texmf-minimal is always sufficient.
Best,
Dima
pandoc: pkg-readme concerning PDF output