HTML-Generation challenges

[danwos]

I don't really understand the mechanism behind the HTML generation for the source code and can't find any docs for it.

My questions are:

• What is created folder/file structure for all Code-HTML files? Any forbidden folder/files names in my docs, as they might get overwritten?
• They seem to be integrated into the Sphinx structure/layout:
  • How to make them available in the toctree?
• Can the code-HTML files get a Page title? Otherwise there is no reference what I'm really looking at.
• I need to deploy them on a server. Why are the local links absolute for the build-machine?
• It seems that also the original code files get copied. Can I avoid this?
  As they are part of the _build folder, I would then deploy also the complete code on the server.

[danwos]

Code-copy may be my fault, is it is part of the doc-folder in my scenario.