Em Tue, 19 Jul 2016 11:53:19 -0300
Mauro Carvalho Chehab <mche...@s-opensource.com> escreveu:
> Yet, this doesn't solve the specific issue for the TOC index
> name. How this could be done in a way that would be backward
> compatible to 1.2.x?
Answering myself, the following patch should trick Sphinx to
allow the media books to be built against older versions of
the toolchain.
Regards,
Mauro
[PATCH] [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 <mche...@s-opensource.com>
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
the license is included in the chapter entitled "GNU Free Documentation
License".
+.. class:: toc-title
+
+ Table of Contents
.. toctree::
:maxdepth: 5
:numbered:
- :caption: Table of Contents
- :name: dvb_mastertoc
intro
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
the license is included in the chapter entitled "GNU Free Documentation
License".
+.. class:: toc-title
+
+ Table of Contents
+
.. toctree::
:maxdepth: 5
:numbered:
- :caption: Table of Contents
- :name: kapi_mastertoc
kapi/v4l2-framework
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
the license is included in the chapter entitled "GNU Free Documentation
License".
+.. class:: toc-title
+
+ Table of Contents
.. toctree::
:maxdepth: 5
- :caption: Table of Contents
- :name: uapi_mastertoc
intro
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
the license is included in the chapter entitled "GNU Free Documentation
License".
+.. class:: toc-title
+
+ Table of Contents
.. toctree::
:maxdepth: 5
:numbered:
- :caption: Table of Contents
- :name: v4l_mastertoc
fourcc
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 @@
* - 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 {
font-size: 100%;
}
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
