From: Evan Silberman Subject: Re: pandoc: pkg-readme concerning PDF output To: Dima Pasechnik Cc: ports@openbsd.org, job@openbsd.org Date: Sun, 25 Feb 2024 14:03:31 -0800 Dima Pasechnik 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 > > 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