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