Option to display latex log on error

[baggepinnen]

When trying to get PDF from Latex working in a CI build environment it would be useful if the latex log was dumped to stdout
The current error message only points to a folder, but that folder is not going to be accessible after the build has failed.

Documenter.jl/src/Writers/LaTeXWriter.jl

Line 177 in 743f0fd

"Logs and partial output can be found in $(Utilities.locrepr(logs))." exception = err

Something like

format = Documenter.LaTeX(show_log = true)

would be useful.

[baggepinnen]

I've noticed that there is an undocumented option to set

ENV["DOCUMENTER_LATEX_DEBUG"] = "some/path"

to copy all latex files into a specified folder. This, together with artifacts could perhaps solve this issue?

[odow]

It's probably sufficient to just print the output of the LaTeXWriter.stderr file.

Documenter.jl/src/Writers/LaTeXWriter.jl

Lines 195 to 197 in 743f0fd

	logs = cp(pwd(), mktempdir(); force=true)
	@error "LaTeXWriter: failed to compile tex with docker. " *
	"Logs and partial output can be found in $(Utilities.locrepr(logs))." exception = err

println(stdout, read("LaTeXWriter.stderr", String))

There's also the DOCUMENTER_VERBOSE flag to print everything into the CI log, but that can get pretty large for big projects.

Documenter.jl/src/Writers/LaTeXWriter.jl

Line 209 in 743f0fd

verbose = "--verbose" in ARGS || get(ENV, "DOCUMENTER_VERBOSE", "false") == "true"

[DilumAluthge]

I'd like to set up some kind of "display LaTeX logs" feature for https://github.com/JuliaLang/docs.julialang.org.

@fredrikekre @mortenpi What do you think is the best option for that repo?