add new platform to compile only to latex

[cserteGT3]

As described in #1338 I would like to compile the documentation to latex only. Here's my implmentation for it.
Please let me know what you think about it.

[mortenpi]

It's a good idea, and it can also help when debugging LaTeX builds (i.e. that you can inspect the TeX; currently we always throw away the intermediate TeX code and you have to jump through some hoops to retrieve it).

However, just the .tex file is not enough to build the PDF afterwards. The temporary build/ directory will also contain all the images, the .sty file etc. We should probably copy the whole thing over to build/?

[cserteGT3]

However, just the .tex file is not enough to build the PDF afterwards. The temporary build/ directory will also contain all the images, the .sty file etc. We should probably copy the whole thing over to build/?

Agree, I forgot about the other files. Made the changes, to copy the whole source directory to the build directory. Also corrected the documentation, as you requested.

[mortenpi]

LGTM, thanks! @fredrikekre, any thoughts on this one?

[inkydragon]

We should probably copy the whole thing over to build/?

If I build HTML first and then build LaTeX without PDF, Will I get a mix of HTML and LaTeX file in build/ dir?

Maybe copy the whole dir to build/latex/ ?

[cserteGT3]

We should probably copy the whole thing over to build/?

If I build HTML first and then build LaTeX without PDF, Will I get a mix of HTML and LaTeX file in build/ dir?

makedocs cleans the build directory by default.

Maybe copy the whole dir to build/latex/ ?

and makedocs has a build="build" keyword to specify the build directory. I think that is sufficient.

[mortenpi]

makedocs cleans the build directory by default.

That is true. However, I believe currently platform="none" will not actually honor clean = false currently? The force=true in the cp will erase the original build/?

[cserteGT3]

makedocs cleans the build directory by default.

That is true. However, I believe currently platform="none" will not actually honor clean = false currently? The force=true in the cp will erase the original build/?

Yes, I think so. I'll test it later today, and report back.

[cserteGT3]

I've tested the followings (on Windows and WSL Linux):

1. makedocs(..., format = Documenter.HTML(), clean=true)
2. makedocs(..., LaTeX(platform = "none"), clean=false)

The first step is the usual Documenter build, and after the second command nothing is deleted, and the result is a mix of HTML and LaTeX files. Though, I'm not sure why this happens.

cp(src::AbstractString, dst::AbstractString; force::Bool=false, follow_symlinks::Bool=false)

Copy the file, link, or directory from src to dst. force=true will first remove an existing dst.

If follow_symlinks=false, and src is a symbolic link, dst will be created as a symbolic link. If follow_symlinks=true and src is a symbolic link, dst will be a copy of the file or directory src refers to. Return dst.

[mortenpi]

and after the second command nothing is deleted, and the result is a mix of HTML and LaTeX files.

I can confirm that, although interestingly when I run cp("foo", "bar"; force=true) on some directories, the contents of bar/ is lost. But Documenter seems to work the way we want it so 🤷‍♂️