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

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

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

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

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

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

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%;
} }