From: Petr Špaček <pspacek@isc.org>
Date: Tue, 10 May 2022 14:53:40 +0000 (+0200)
Subject: Allow wrapping for ARM table content
X-Git-Tag: v9.19.2~3^2~1
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=a5dd98ac1bde58a79b105ed44952628525c27f6b;p=thirdparty%2Fbind9.git

Allow wrapping for ARM table content

RTD style default never wraps <th> and <td> elements and that just does
not work for real sentences or any other long lines.

We can reconsider styling some tables separately, but at the moment we
do not have use for tables with long but unwrappable lines so it's
easier to allow wrapping globally.
---

diff --git a/doc/arm/Makefile.am b/doc/arm/Makefile.am
index e8024040f02..798d6ba839f 100644
--- a/doc/arm/Makefile.am
+++ b/doc/arm/Makefile.am
@@ -61,6 +61,7 @@ EXTRA_DIST =					\
 	troubleshooting.inc.rst			\
 	tsig.inc.rst				\
 	zones.inc.rst				\
+	_static/custom.css			\
 	../dnssec-guide				\
 	../misc/acl.grammar.rst			\
 	../misc/controls.grammar.rst		\
diff --git a/doc/arm/_static/custom.css b/doc/arm/_static/custom.css
new file mode 100644
index 00000000000..e81d66d321d
--- /dev/null
+++ b/doc/arm/_static/custom.css
@@ -0,0 +1,17 @@
+/*
+Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+SPDX-License-Identifier: MPL-2.0
+
+This Source Code Form is subject to the terms of the Mozilla Public
+License, v. 2.0.  If a copy of the MPL was not distributed with this
+file, you can obtain one at https://mozilla.org/MPL/2.0/.
+
+See the COPYRIGHT file distributed with this work for additional
+information regarding copyright ownership.
+*/
+
+/* make table content wrappable */
+.wy-table-responsive table td {
+    white-space:normal;
+}
diff --git a/doc/arm/conf.py b/doc/arm/conf.py
index 60131b41f6e..403b6cf5296 100644
--- a/doc/arm/conf.py
+++ b/doc/arm/conf.py
@@ -154,6 +154,10 @@ master_doc = 'index'
 # a list of builtin themes.
 #
 html_theme = 'sphinx_rtd_theme'
+html_static_path = ['_static']
+html_css_files = [
+    'custom.css'
+]
 
 # -- Options for EPUB output -------------------------------------------------