Fix modules and TOC in generated PDF

[bgazzera]

I kept digging and it seems that to generate the full documentation, including all the modules, and a working TOC you have to execute a couple of Makefiles.

In ansible/docsite, I edited the build-site.py just as you did, replacing the buildername from html to "latex" Then I run make docs that in turn runs ansible/hacking/module_formatter.py that as far as I see adds a footer to every module section and not much. Then cd htmlout and make

And I got a nice formatted TOC.

Inside the Makefile I see that LaTex is run several times, as you suggested.

    %.pdf: %.tex
        $(PDFLATEX) $(LATEXOPTS) '$<'
        $(PDFLATEX) $(LATEXOPTS) '$<'
        $(PDFLATEX) $(LATEXOPTS) '$<'
        -$(MAKEINDEX) -s python.ist '$(basename $<).idx'
        $(PDFLATEX) $(LATEXOPTS) '$<'
        $(PDFLATEX) $(LATEXOPTS) '$<'

So instead of running pdflatex --interaction=nonstopmode ansible.tex maybe a better option is to direct people to just run make. But of course, it's your call. And again if you feel that the suggestion helps, I'll PR it to you.

[bonndan]

Anything that improves the project is appreciated. Feel free to create a PR, thanks.

[xenithorb]

I can't seem to get the TOC anymore, though I did manage to get it working back in March time-frame. I prefer to build it without the modules, but I sure did like that TOC

Any ideas?

[bonndan]

It's quite some time now since I've been using LaTeX. I remember that sometimes the toc appeared after a second run. I'm afraid I'm not of much help here.

[fossilet]

@bgazzera Can you create a PR for the TOC? We would love it with TOC.