Download raw body.
pandoc: pkg-readme concerning PDF output
Dima Pasechnik <dima@sagemath.org> wrote:
> 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.
"PDF engine" is the term pandoc uses, 'latexmk' is a valid argument
to pandoc's --pdf-engine option, and there's an OpenBSD package that
provides the required command. That's all I'm trying to document.
>
> > +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.
beamer is in texlive_texmf-minimal. Beamer also isn't listed separately
in pandoc's documentation of PDF engines supported by output formats. I
could add a note about beamer here but I don't think anyone would be
lost or confused without it.
Evan
pandoc: pkg-readme concerning PDF output