Would it be useful to bookmark the documentation PDF?

waiting4

I have bookmarked parts of the documentation, the pdf on Github, so I could use it offline. I believe it is a pdf of the wiki. Does the wiki change a lot? Would it be helpful to have a pdf that has all the sections bookmarked, so one doesn't have to scroll a lot to find a subject? If that document changes a lot, I don't know it would be useful. 900 pages is a lot to change over and over.

I also have been reading about rst2pdf, but I don't know how to create bookmarks with it (yet.)

TwistedTwigleg

Well, the wiki doesn't change a whole lot in minor releases (like version 2.0 to 2.1). However, version 3.0 is coming out early 2017 (I think) and a lot of the syntax is going to change. Version 2 will still be supported for awhile (I think) even when version 3.0 is out, so it really depends on if you want to use version 3.0 when it first comes out or stick with version 2.

(NOTE: I'm not part of the Godot development team and cannot say for sure on how it will work)

waiting4

After a lot of trial and error, I did this:

download the zip of the documentation rst files, images, etc.
run make latex
after that I built the pdfLaTeX file

The main section bookmarks were there, but no subsections (as before), even though the LaTeX has the subsections listed. To fix this I put this dependency in:

\usepackage[depth=subsection]{bookmark}

In addition, LaTeX does not handle .gifs, but the pdf building claimed there were lots of gifs. I spot checked it at Particle Systems 2D because those are .gifs in the img directory. On the wiki you will see the .gifs because you need to see the animation of the particle system. If you look at the wiki here,

http://docs.godotengine.org/en/stable/tutorials/2d/particle_systems_2d.html#direction

you can see what I mean. These will not go in the pdf, but they aren't in original wiki pdf either. To fix this I mass converted the .gif files to .png (27 files) and changed the .tex file, replacing .gif with .png. It worked.

The only problem remaining for me is the encoding.

Nevertheless, I was then able to get all the subsections indexed.

TwistedTwigleg

Nice!