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.16.30~2^2~1
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=dafacea24cf8a6a1afe62db37fc5e7e97b288af2;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.

(cherry picked from commit a5dd98ac1bde58a79b105ed44952628525c27f6b)
---

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 c266add20b5..87957f243dd 100644
--- a/doc/arm/conf.py
+++ b/doc/arm/conf.py
@@ -167,6 +167,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 LaTeX output ------------------------------------------------
 latex_engine = 'xelatex'