Add and document html_extra_path option.

This commit is contained in:
Matthias C. M. Troffaes
2013-08-22 08:51:06 +01:00
parent 88c72be190
commit 57aceed4ed
3 changed files with 20 additions and 4 deletions

View File

@@ -509,10 +509,11 @@ that use Sphinx' HTMLWriter class.
.. confval:: html_static_path
A list of paths that contain custom static files (such as style sheets or
script files). Relative paths are taken as relative to the configuration
directory. They are copied to the output directory after the theme's static
files, so a file named :file:`default.css` will overwrite the theme's
A list of paths that contain custom static files (such as style
sheets or script files). Relative paths are taken as relative to
the configuration directory. They are copied to the output's
:file:`_static` directory after the theme's static files, so a file
named :file:`default.css` will overwrite the theme's
:file:`default.css`.
.. versionchanged:: 0.4
@@ -521,6 +522,15 @@ that use Sphinx' HTMLWriter class.
.. versionchanged:: 1.0
The entries in :confval:`html_static_path` can now be single files.
.. confval:: html_extra_path
A list of paths that contain extra files (such as
:file:`robots.txt` or :file:`.htaccess`). Relative paths are taken
as relative to the configuration directory. They are copied to the
output directory, and will overwrite any existing generated file.
.. versionadded:: 1.2
.. confval:: html_last_updated_fmt
If this is not the empty string, a 'Last updated on:' timestamp is inserted