dockerfiles icon indicating copy to clipboard operation
dockerfiles copied to clipboard

`pandoc/core` not working as documented

Open cmahnke opened this issue 2 years ago • 7 comments

Either the documentation is outdated or the image is missing a dependency:

docker run --rm \
>        --volume "$(pwd):/data" \
>        --user $(id -u):$(id -g) \
>        pandoc/core protokoll.md -o outfile.pdf
pdflatex not found. Please select a different --pdf-engine or install pdflatex

cmahnke avatar Jul 27 '23 08:07 cmahnke

pandoc/core does not contain pdflatex. You have to use pandoc/latex instead.

simondueckert avatar Aug 06 '23 19:08 simondueckert

If that is the case, then the default --pdf-engine should not be pdflatex. @cmahnke is referring to what is documented by pandoc on DockerHub.

gobborg avatar Aug 07 '23 14:08 gobborg

I don't see anywhere in documentation that suggests using the core image to generate PDF files. If it is miss-documented somewhere can somebody please point out the exact reference? The core image has no backends for generating PDFs, only things that Pandoc can generate natively are supported.

alerque avatar Aug 12 '23 18:08 alerque

@alerque https://github.com/pandoc/dockerfiles/blob/61b1fbf7355923f817b447301543d40316eea9c2/docs/sections/run.md?plain=1#L11

cmahnke avatar Aug 15 '23 18:08 cmahnke

@cmahnke That reference is already explicitly shown as using the pandoc/latex image, not the pandoc/core image. I'm still happy to fix anywhere it is actually miss-documented, but that example is correct already.

alerque avatar Aug 15 '23 19:08 alerque

I might have been wrong, the problem still exists: https://hub.docker.com/r/pandoc/core

Section "Run the pandoc Docker container"

Maybe someone have to renew the Text on Dockerhub, it should be automated anyways

cmahnke avatar Aug 16 '23 05:08 cmahnke

@tarleb The README copy on Docker Hub does in fact appear to be over a year behind what is in this repository. The include system also seems like it will produce sub-optimal results in that it will have the PDF example using the latex image in the docs for all the images including core. I don't have access to the Docker Hub org where these are stored so I can't fix that end of things. Can you either regen the docs there or give my alerque user access to the Docker end of things?

alerque avatar Aug 16 '23 16:08 alerque

Thank you for raising this issue. I've fixed it in the doc template, and which means that it will be fixed on Docker Hub the next time I go through the release process.

tarleb avatar May 03 '24 17:05 tarleb