doc: Add explanation about stable sort of html_*_files

This commit is contained in:
Takeshi KOMIYA 2021-01-03 00:17:19 +09:00
parent e9a4ebf70d
commit 7739b7d7dd

View File

@ -929,9 +929,11 @@ class Sphinx:
Add *filename* to the list of JavaScript files that the default HTML Add *filename* to the list of JavaScript files that the default HTML
template will include in order of *priority* (ascending). The filename template will include in order of *priority* (ascending). The filename
must be relative to the HTML static path , or a full URI with scheme. must be relative to the HTML static path , or a full URI with scheme.
If the keyword argument ``body`` is given, its value will be added If the priority of JavaScript file is the same as others, the JavaScript
between the ``<script>`` tags. Extra keyword arguments are included as files will be included in order of the registration. If the keyword
attributes of the ``<script>`` tag. argument ``body`` is given, its value will be added between the
``<script>`` tags. Extra keyword arguments are included as attributes of
the ``<script>`` tag.
Example:: Example::
@ -974,8 +976,10 @@ class Sphinx:
Add *filename* to the list of CSS files that the default HTML template Add *filename* to the list of CSS files that the default HTML template
will include in order of *priority* (ascending). The filename must be will include in order of *priority* (ascending). The filename must be
relative to the HTML static path, or a full URI with scheme. The relative to the HTML static path, or a full URI with scheme. If the
eyword arguments are also accepted for attributes of ``<link>`` tag. priority of CSS file is the same as others, the CSS files will be
included in order of the registration. The keyword arguments are also
accepted for attributes of ``<link>`` tag.
Example:: Example::