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 (file)
index 0000000..e81d66d
--- /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 c266add20b5d531585281e4384dbd1a787e30011..87957f243dde35a5a211d4cc73a36dd908e86538 100644 (file)
--- 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'