diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-19 11:35:08 -0400 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-19 11:35:08 -0400 |
commit | ef88f10eb877c427a61c3aacc7ed08ffed0712ab (patch) | |
tree | bb678e7e9924674a9ea2cf07b6813f502c2d971b | |
parent | e1813eda8e7fdacd992224b79102925cf134be8b (diff) |
[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>
-rw-r--r-- | Documentation/media/dvb-drivers/index.rst | 5 | ||||
-rw-r--r-- | Documentation/media/media_kapi.rst | 6 | ||||
-rw-r--r-- | Documentation/media/media_uapi.rst | 5 | ||||
-rw-r--r-- | Documentation/media/v4l-drivers/index.rst | 5 | ||||
-rw-r--r-- | Documentation/sphinx-static/theme_overrides.css | 5 |
5 files changed, 18 insertions, 8 deletions
diff --git a/Documentation/media/dvb-drivers/index.rst b/Documentation/media/dvb-drivers/index.rst index e1d4d87f2a47..e4c2e74db9dc 100644 --- a/Documentation/media/dvb-drivers/index.rst +++ b/Documentation/media/dvb-drivers/index.rst | |||
@@ -14,12 +14,13 @@ any later version published by the Free Software Foundation. A copy of | |||
14 | the license is included in the chapter entitled "GNU Free Documentation | 14 | the license is included in the chapter entitled "GNU Free Documentation |
15 | License". | 15 | License". |
16 | 16 | ||
17 | .. class:: toc-title | ||
18 | |||
19 | Table of Contents | ||
17 | 20 | ||
18 | .. toctree:: | 21 | .. toctree:: |
19 | :maxdepth: 5 | 22 | :maxdepth: 5 |
20 | :numbered: | 23 | :numbered: |
21 | :caption: Table of Contents | ||
22 | :name: dvb_mastertoc | ||
23 | 24 | ||
24 | intro | 25 | intro |
25 | avermedia | 26 | avermedia |
diff --git a/Documentation/media/media_kapi.rst b/Documentation/media/media_kapi.rst index 0af80e90b7b5..5414d2a7dfb8 100644 --- a/Documentation/media/media_kapi.rst +++ b/Documentation/media/media_kapi.rst | |||
@@ -14,11 +14,13 @@ any later version published by the Free Software Foundation. A copy of | |||
14 | the license is included in the chapter entitled "GNU Free Documentation | 14 | the license is included in the chapter entitled "GNU Free Documentation |
15 | License". | 15 | License". |
16 | 16 | ||
17 | .. class:: toc-title | ||
18 | |||
19 | Table of Contents | ||
20 | |||
17 | .. toctree:: | 21 | .. toctree:: |
18 | :maxdepth: 5 | 22 | :maxdepth: 5 |
19 | :numbered: | 23 | :numbered: |
20 | :caption: Table of Contents | ||
21 | :name: kapi_mastertoc | ||
22 | 24 | ||
23 | kapi/v4l2-framework | 25 | kapi/v4l2-framework |
24 | kapi/v4l2-controls | 26 | kapi/v4l2-controls |
diff --git a/Documentation/media/media_uapi.rst b/Documentation/media/media_uapi.rst index debe4531040b..aaa9a0e387c4 100644 --- a/Documentation/media/media_uapi.rst +++ b/Documentation/media/media_uapi.rst | |||
@@ -14,11 +14,12 @@ any later version published by the Free Software Foundation. A copy of | |||
14 | the license is included in the chapter entitled "GNU Free Documentation | 14 | the license is included in the chapter entitled "GNU Free Documentation |
15 | License". | 15 | License". |
16 | 16 | ||
17 | .. class:: toc-title | ||
18 | |||
19 | Table of Contents | ||
17 | 20 | ||
18 | .. toctree:: | 21 | .. toctree:: |
19 | :maxdepth: 5 | 22 | :maxdepth: 5 |
20 | :caption: Table of Contents | ||
21 | :name: uapi_mastertoc | ||
22 | 23 | ||
23 | intro | 24 | intro |
24 | uapi/v4l/v4l2 | 25 | uapi/v4l/v4l2 |
diff --git a/Documentation/media/v4l-drivers/index.rst b/Documentation/media/v4l-drivers/index.rst index 8d1710234e5a..2aab653905ce 100644 --- a/Documentation/media/v4l-drivers/index.rst +++ b/Documentation/media/v4l-drivers/index.rst | |||
@@ -14,12 +14,13 @@ any later version published by the Free Software Foundation. A copy of | |||
14 | the license is included in the chapter entitled "GNU Free Documentation | 14 | the license is included in the chapter entitled "GNU Free Documentation |
15 | License". | 15 | License". |
16 | 16 | ||
17 | .. class:: toc-title | ||
18 | |||
19 | Table of Contents | ||
17 | 20 | ||
18 | .. toctree:: | 21 | .. toctree:: |
19 | :maxdepth: 5 | 22 | :maxdepth: 5 |
20 | :numbered: | 23 | :numbered: |
21 | :caption: Table of Contents | ||
22 | :name: v4l_mastertoc | ||
23 | 24 | ||
24 | fourcc | 25 | fourcc |
25 | v4l-with-ir | 26 | v4l-with-ir |
diff --git a/Documentation/sphinx-static/theme_overrides.css b/Documentation/sphinx-static/theme_overrides.css index c97d8428302d..3a2ac4bcfd78 100644 --- a/Documentation/sphinx-static/theme_overrides.css +++ b/Documentation/sphinx-static/theme_overrides.css | |||
@@ -31,6 +31,11 @@ | |||
31 | * - hide the permalink symbol as long as link is not hovered | 31 | * - hide the permalink symbol as long as link is not hovered |
32 | */ | 32 | */ |
33 | 33 | ||
34 | .toc-title { | ||
35 | font-size: 150%; | ||
36 | font-weight: bold; | ||
37 | } | ||
38 | |||
34 | caption, .wy-table caption, .rst-content table.field-list caption { | 39 | caption, .wy-table caption, .rst-content table.field-list caption { |
35 | font-size: 100%; | 40 | font-size: 100%; |
36 | } | 41 | } |