Commit Graph

53 Commits

Author SHA1 Message Date
Stephen Finucane
e4e5c509b6 doc: Rework "templating" documents
Signed-off-by: Stephen Finucane <stephen@that.guru>
2020-05-30 15:29:13 +01:00
Takeshi KOMIYA
f13c546862 doc: Update docs 2020-03-07 02:00:50 +09:00
Vince Salvino
9fdc18d8de Adding documentation 2020-02-21 18:41:46 -05:00
Takeshi KOMIYA
d6063ff35b doc: Fold lines by 80 columns 2019-05-30 01:07:05 +09:00
Takeshi KOMIYA
fa00458f4f docs: Fold lines by 80 chars 2019-05-12 17:57:38 +09:00
Takeshi KOMIYA
68e0210746 doc: Add deprecation info to script_files (template variable) 2018-11-21 20:15:47 +09:00
Takeshi KOMIYA
52ed9ef3a0 Closes #2157: helper function `warning()` for HTML themes is added 2018-03-19 00:18:10 +09:00
Aaron Carlisle
8ef71551cb
Docs: Templating: Small wording fix 2018-02-16 18:58:47 -05:00
Kurt McKee
beefd445c1 Convert doc HTTP links to HTTPS, even in documentation examples
A small number of URL's redirected, or were stale but had obvious
alternatives. These have been updated. For example, a Google style
guide for Python was no longer available at googlecode.com, and
Paver docs are now at readthedocs.io.
2018-01-20 16:50:35 -06:00
Jellby
e59a8028d7 Rewrite and simplify stylesheet handling
Thanks to tk0miya's comment, I learnt one can add stuff to template
blocks, that allows a much simpler stylesheet configuration, considering
that changes at the template level will be more... well, low-level.
Hopefully this is now acceptable.
2017-04-15 17:07:33 +02:00
Jellby
68cf06a2ce Update version (there's still hope) 2017-03-04 12:14:54 +01:00
Jellby
3ce6168958 Merge remote-tracking branch 'upstream/master'
Conflicts:
	tests/test_build_html.py
2017-03-04 12:03:15 +01:00
Timotheus Kampik
0b4ebbeebb Improve templating options documentation #2788
--
Move `parents`, `prev` & `next` to
*documents that are created from source files* section.
It doesnt make any sens to use them for auto-generated files like index and
search, does it?
Add documentation for `body`, `display_toc`, `metatags` and `title`.
2017-01-22 22:05:35 +01:00
Jellby
6ce1bb1f00 Merge remote-tracking branch 'upstream/master'
Conflicts:
	sphinx/application.py
	sphinx/builders/html.py
2016-12-06 19:14:12 +01:00
Takeshi KOMIYA
463ab88b67 docs: sourcename has empty value on creating genindex and so on (refs: #3094) 2016-11-04 23:36:27 +09:00
Jellby
ea219a04ed Move CSS properties to a different variable 2016-03-06 13:49:57 +01:00
Ignacio Fdez. Galván
d5cbda5c79 Merge remote-tracking branch 'upstream/master' 2015-07-09 17:35:23 +02:00
Eric Holscher
5f6503c905 Add suffix to HTML context. Fixes #1873 2015-06-06 13:12:56 -07:00
Ignacio Fdez. Galván
204b9cc521 Changed 'rel' to 'alternate' 2015-03-12 10:51:45 +01:00
Ignacio Fdez. Galván
a18c04b955 Allow setting 'rel' and 'title' attributes for stylesheets. 2015-03-11 15:48:40 +01:00
Robert Lehmann
3eb4afaa1a Document pass-through of language in HTML templates.
Originally added in dee3e60.
2015-02-14 10:02:04 +01:00
EricFromCanada
4883e1eba2 more corrections for spelling and grammar 2014-06-19 12:14:47 -04:00
EricFromCanada
178a97cd73 improved consistency for how docs refer to True and False 2014-06-18 12:34:28 -04:00
Georg Brandl
48524dcecc Closes #983: clarify "docstitle" behavior with singlehtml 2014-01-11 20:18:37 +01:00
Roland Meister
50fadb9e94 Bug #1047: templating toctree()'s includehidden argument
Document the includehidden option and give it sane defaults.
See bug #1047 for implementation alternatives.
2012-12-10 21:54:11 +01:00
Georg Brandl
8965cf1095 Closes #658: fix error in script_files example and document css_files. 2011-05-15 13:05:31 +02:00
Georg Brandl
580e1c90d3 #481, #482: fix `.name` reference matching.
#482: When doing a non-exact search, match only the given type of object.
#481: Apply non-exact search for Python reference targets with ``.name`` for modules too.
2010-08-05 13:39:23 +02:00
Georg Brandl
187e78adf6 Mention type of "meta". 2010-06-14 09:49:48 +02:00
Georg Brandl
35f0b555a4 The `toctree callable in templates now accepts a titles_only` keyword argument. 2010-05-30 13:16:26 +02:00
Georg Brandl
454ecf80a4 Make the concept of "module index" generalized to domains. As a side-effect, the latex modindex is no longer generated by LaTeX. 2010-02-20 01:13:23 +01:00
Georg Brandl
c227fc2720 merge with trunk (and remove debugging leftover from test layout.html template) 2010-01-07 21:51:23 +01:00
Georg Brandl
03b9d79b34 Fix compatibility with blocks in the old sidebar scheme: blocks cannot be used in included templates. Deprecate the blocks accordingly. 2010-01-07 21:49:31 +01:00
Georg Brandl
5d0812fb91 merge with trunk 2009-12-28 19:49:57 +01:00
Georg Brandl
98437cfd28 Fix typo. 2009-12-01 21:04:46 +01:00
Georg Brandl
0792ad7498 The `toctree() callable in templates now has a maxdepth`
keyword argument to control the depth of the generated tree.

Also add tests for that callable.
2009-09-09 15:56:52 +02:00
Georg Brandl
a43b651804 Make "make check" happy. 2009-02-19 23:31:34 +01:00
Georg Brandl
d5ea00899c Change html_collapse_toctree setting to an argument of the toctree() callable. 2009-02-16 00:08:08 +01:00
Georg Brandl
106ef21629 More templating docs. 2009-02-15 11:38:23 +01:00
Georg Brandl
e974741c74 Added a toctree variable to the templates, and the ability to
include external links in toctrees.

Patch by Stefan Seefeld.
2009-01-26 21:57:15 +01:00
Georg Brandl
f02a90ca6e Add sidebarsourcelink block. 2008-12-20 23:08:26 +01:00
Georg Brandl
bd12a8e547 Some more fixes after the great renaming. 2008-11-29 20:04:11 +01:00
Georg Brandl
3d3bcb00df Rename rellinks to linktags. 2008-09-24 11:48:43 +00:00
Georg Brandl
262edb1413 Add logo options, add blocks to sidebar. 2008-04-27 19:43:45 +00:00
Georg Brandl
f7f2cf3a81 Fix markup. 2008-04-27 18:10:48 +00:00
Georg Brandl
1ba3902225 Review templating docs. 2008-04-27 16:35:55 +00:00
Armin Ronacher
ed68fefabe simplified layout template a bit, working on templating documentation 2008-04-27 14:23:11 +00:00
Georg Brandl
ae8813c788 Add new templating API, remove Jinja external and add it to setup.py dependencies. 2008-04-13 18:16:55 +00:00
Georg Brandl
2da5b3df46 Expand on the pickle builder. 2008-03-25 19:20:26 +00:00
Georg Brandl
8057b0f80e Rebuild all HTML files in case of a template change.
Also, record image docnames in order to be able to delete image records from the env.
2008-03-25 15:22:25 +00:00
Georg Brandl
5fb481715c Remove outdated info and add an XXX. 2008-03-23 14:33:11 +00:00