Em Tue, 19 Jul 2016 11:53:19 -0300 Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx> 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 <mchehab@xxxxxxxxxxxxxxxx> 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-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html