Commit Graph

12 Commits

Author SHA1 Message Date
Bénédikt Tran
f44ff30673
[doc] cleanup references and update external URLs (#12182) 2024-03-25 11:39:05 +01:00
Adam Turner
655bd15749 Adorn top-level files with a '.rst' suffix 2023-09-14 11:08:17 +01:00
Jean-François B
a34a34fe53 Mumble (line too long but this is raw LaTeX, and we should be exempted) 2022-09-24 23:17:34 +02:00
Jean-François B
464d0815e9 [DOC] Avoid collisions in TOC of sphinx.pdf in Changelog chapter
Relates #10858
2022-09-24 23:09:31 +02:00
jfbu
ddef4950ee LaTeX: let bookmarks use high default depth
Add bookmarksdepth key to latex_elements['sphinxsetup']
2021-02-18 13:11:28 +01:00
jfbu
3a3a479f1e Improve Sphinx own pdf docs
Prior to this the depth of the bookmarks is too low, one does not even
get to see for example what are the built-in extensions offered by
Sphinx.

Similarly the LaTeX created table of contents has not enough depth.
Dozens of contiguous pages from our documentation get only a single
link, it is very hard for newcomer to get some feeling of the scope of
Sphinx.  With a more detailed table of contents (be it inside the PDF or
via the collapsable bookmark panel of PDF viewer) learning Sphinx is
easier.
2021-01-24 00:41:59 +01:00
Stephen Finucane
6b480c97b2 docs: Rework contributing document, re-add CONTRIBUTING
Reorder this to flow a little better and re-add the CONTRIBUTING
document, which now simply points to the main documentation.

Signed-off-by: Stephen Finucane <stephen@that.guru>
2020-06-02 12:10:21 +01:00
Takeshi KOMIYA
ba4510d01f doc: Hide changelog entries on ToC page 2020-03-28 22:01:32 +09:00
Georg Brandl
109cb873de Use "any" role in changelog. 2014-09-19 13:18:29 +02:00
Georg Brandl
bd4166c2d6 Add maxdepth for TOCs. 2008-06-12 21:56:06 +00:00
Georg Brandl
5fe73576a5 Support app.add_crossref_type(). 2008-03-28 18:45:32 +00:00
Georg Brandl
f264cb6679 Add the changelog to the documentation. 2008-03-23 21:25:19 +00:00