kpriv/linux-hardened
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

[media] doc-rst: backward compatibility with older Sphinx versions

Browse source 
Sphinx is really evil when an older version finds an extra
attribute for the :toctree: tag: it simply ignores everything
and produce documents without any chapter inside!

As we're now using tags available only on Sphinx 1.4.x, we
need to use some creative ways to add a title before the
table of contents. Do that by using a css class.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
This commit is contained in:
Mauro Carvalho Chehab 2016-07-19 12:35:08 -03:00
parent e1813eda8e
commit ef88f10eb8
5 changed files with 18 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
Documentation/media/dvb-drivers/index.rst
View file

@ -14,12 +14,13 @@ any later version published by the Free Software Foundation. A copy of
the license is included in the chapter entitled "GNU Free Documentation the license is included in the chapter entitled "GNU Free Documentation
License". License".
.. class:: toc-title
Table of Contents
.. toctree:: .. toctree::
:maxdepth: 5 :maxdepth: 5
:numbered: :numbered:
:caption: Table of Contents
:name: dvb_mastertoc
intro intro
avermedia avermedia

6
Documentation/media/media_kapi.rst
View file

@ -14,11 +14,13 @@ any later version published by the Free Software Foundation. A copy of
the license is included in the chapter entitled "GNU Free Documentation the license is included in the chapter entitled "GNU Free Documentation
License". License".
.. class:: toc-title
Table of Contents
.. toctree:: .. toctree::
:maxdepth: 5 :maxdepth: 5
:numbered: :numbered:
:caption: Table of Contents
:name: kapi_mastertoc
kapi/v4l2-framework kapi/v4l2-framework
kapi/v4l2-controls kapi/v4l2-controls

5
Documentation/media/media_uapi.rst
View file

@ -14,11 +14,12 @@ any later version published by the Free Software Foundation. A copy of
the license is included in the chapter entitled "GNU Free Documentation the license is included in the chapter entitled "GNU Free Documentation
License". License".
.. class:: toc-title
Table of Contents
.. toctree:: .. toctree::
:maxdepth: 5 :maxdepth: 5
:caption: Table of Contents
:name: uapi_mastertoc
intro intro
uapi/v4l/v4l2 uapi/v4l/v4l2

5
Documentation/media/v4l-drivers/index.rst
View file

@ -14,12 +14,13 @@ any later version published by the Free Software Foundation. A copy of
the license is included in the chapter entitled "GNU Free Documentation the license is included in the chapter entitled "GNU Free Documentation
License". License".
.. class:: toc-title
Table of Contents
.. toctree:: .. toctree::
:maxdepth: 5 :maxdepth: 5
:numbered: :numbered:
:caption: Table of Contents
:name: v4l_mastertoc
fourcc fourcc
v4l-with-ir v4l-with-ir

5
Documentation/sphinx-static/theme_overrides.css
View file

@ -31,6 +31,11 @@
* - hide the permalink symbol as long as link is not hovered * - hide the permalink symbol as long as link is not hovered
*/ */
.toc-title {
font-size: 150%;
font-weight: bold;
}
caption, .wy-table caption, .rst-content table.field-list caption { caption, .wy-table caption, .rst-content table.field-list caption {
font-size: 100%; font-size: 100%;
} }