pandoc / dockerfiles

Dockerfiles for various pandoc images
GNU General Public License v2.0
364 stars 98 forks source link

`pandoc/core` not working as documented #214

Closed cmahnke closed 4 months ago

cmahnke commented 1 year ago

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
simondueckert commented 1 year ago

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

gobborg commented 1 year ago

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.

alerque commented 1 year ago

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.

cmahnke commented 1 year ago

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

alerque commented 1 year ago

@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.

cmahnke commented 1 year ago

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

alerque commented 1 year ago

@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?

tarleb commented 4 months ago

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.