Documenter.jl icon indicating copy to clipboard operation
Documenter.jl copied to clipboard

Published 20 hours ago • verified publisher icon JuliaDocs

Support Podman containers for building LaTeX/PDFs

Open bienpierre opened this issue 2 years ago • 7 comments

Awesome work on Documenter.jl,

Using docker could be difficult due to root, so could it be possible to add Podman platform as an alternative to docker in LatexWriter.jl:

compile_tex(doc::Documents.Document, settings::LaTeX, fileprefix::String) from Documenter.jl/src/Writers/LaTeXWriter.jl

https://github.com/JuliaDocs/Documenter.jl/blob/2bcc94cbba6de049dc53d6ee453a301fe474ead2/src/Writers/LaTeXWriter.jl#L58

https://github.com/JuliaDocs/Documenter.jl/blob/2bcc94cbba6de049dc53d6ee453a301fe474ead2/src/Writers/LaTeXWriter.jl#L200

Regards

bienpierre avatar Jul 04 '22 14:07 bienpierre

I am not familiar with Podman, but the interface emulates Docker? Happy to take a PR if there is interest in this. It should be easy enough to support it. Any ideas if it's easy to run Podman on GitHub Actions?

mortenpi avatar Jul 04 '22 23:07 mortenpi

Podman takes the same terminal commands as Docker, so only small modifications is required. I do not know if Podman runs on GitHub Actions, as I am not so familiar with Github (and never push PR). I am very interested in being more competent on this. If you accept it, I can have a look on github actions and then submit a PR in order to support Podman. Regards

bienpierre avatar Jul 05 '22 13:07 bienpierre

It actually looks like it might be preinstalled on the Ubuntu images. By the way, can Podman reuse the Docker image we have?

mortenpi avatar Jul 06 '22 01:07 mortenpi

It actually looks like it might be preinstalled on the Ubuntu images. By the way, can Podman reuse the Docker image we have?

For some weird reason, trying to pull the juliadocs/documenter-latex image fails but works with others

image

uncomfyhalomacro avatar Jul 19 '22 13:07 uncomfyhalomacro

you could try with the tag: docker pull juliadocs/documenter-latex:0.1

bienpierre avatar Jul 19 '22 14:07 bienpierre

that works. weird xD

uncomfyhalomacro avatar Jul 19 '22 14:07 uncomfyhalomacro

you could try with the tag: docker pull juliadocs/documenter-latex:0.1

I am going try reading the code base next week if I have the time to probably add support for this. I also have another project for my Julia learnings too called Podman.jl in codeberg and I think that will help me learn both docker and podman 😄

uncomfyhalomacro avatar Jul 19 '22 15:07 uncomfyhalomacro