PDF docs deployment broken

[cdluminate]

The PDF document is invalid:

https://raw.githubusercontent.com/JuliaLang/docs.julialang.org/assets/julia-1.3.0.pdf

and the link is found here:

https://docs.julialang.org/en/v1.3/

[aerdely]

Still broken as of today 😕

[ViralBShah]

Would be nice to fix this. I am happy to do it, if there's instructions I can follow somewhere.

[xerz-one]

The build script should be the one at julialang/docs.julialang.org. To run it (you might have to install dependencies like PDFLaTeX or Docker, I haven't figured that out), you have to do something like:

git clone https://github.com/JuliaLang/docs.julialang.org
git clone https://github.com/JuliaLang/julia
cd docs.julialang.org/pdf
JULIA_SOURCE=../../julia julia make.jl releases

I decided to modify the make.jl script with my own small patches, to save myself some time and effort, adding a #!/usr/bin/env julia header and rewriting the following function:

function collect_versions()
    versions = VersionNumber[]
    push!(versions, v"1.3.0")
    return versions
end

...and I got this error

┌ Error: LaTeXWriter: failed to compile tex with docker. Logs and partial output can be found in /tmp/jl_yokbBF.
│   exception =
│    failed process: Process(`docker exec -u zeptodoctor latex-container bash -c 'mkdir /home/zeptodoctor/build
│    cd /home/zeptodoctor/build
│    cp -r /mnt/. .
│    latexmk -f -interaction=nonstopmode -view=none -lualatex -shell-escape TheJuliaLanguage.tex
│    '`, ProcessExited(12)) [12]
│    
└ @ Documenter.Writers.LaTeXWriter ~/Projects/julia/doc/deps/packages/Documenter/cMNJA/src/Writers/LaTeXWriter.jl:173

[xerz-one]

(keep in mind: I keep my Julia repo at ~/Projects/julia, and I couldn't find that /tmp/jl_yokbBF anywhere)

[fredrikekre]

This is the real issue: JuliaDocs/Documenter.jl#1200

[aerdely]

The problem has been fixed!

[StefanKarpinski]

It was fixed manually, we should still track the upstream issue to make sure the PDF is automatically generated in the future.

[ViralBShah]

Inside the pdf, it says the manual is for 1.3.0-alpha. Not sure if it is the right manual with an incorrect version, or if it is an older manual.

[fredrikekre]

It's an older manual.

[ViralBShah]

Should we remove the pdf link from the manual until this gets fixed?

[knuesel]

The link on https://docs.julialang.org/en/v1/ is still broken.

[fredrikekre]

No, it just broke due to 1.4.1. PDFs are generated once a day so it will be up tomorrow.

[ViralBShah]

I had no idea the pdf docs were so popular!