Improve Sphinx LaTeX builder support

changelogs/fragments/195-latex.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - "Adjust default RST output to work better with Spinx's LaTeX builder (https://github.com/ansible-community/antsibull-docs/pull/195)."

changelogs/fragments/195-problems.yml

@@ -0,0 +1,3 @@
+known_issues:
+  - "When using Sphinx builders other than HTML, the indentation for nested options and return values is missing,
+     and the collection links section is empty (https://github.com/ansible-community/antsibull-docs/pull/195)."

src/antsibull_docs/data/docsite/ansible-docsite/macros/attributes.rst.j2

@@ -7,12 +7,13 @@
 {% from 'macros/version_added.rst.j2' import version_added_rst %}
 
 {% macro in_rst(attributes, role_entrypoint=None) %}
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Attribute
     - Support

src/antsibull_docs/data/docsite/ansible-docsite/macros/parameters.rst.j2

@@ -11,12 +11,13 @@
 {% from 'macros/version_added.rst.j2' import version_added_rst, version_added_html %}
 
 {% macro in_rst(elements, suboption_key='suboptions', parameter_html_prefix='', parameter_rst_prefix='', role_entrypoint=None) %}
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

src/antsibull_docs/data/docsite/ansible-docsite/macros/returnvalues.rst.j2

@@ -9,12 +9,13 @@
 {% from 'macros/version_added.rst.j2' import version_added_rst, version_added_html %}
 
 {% macro in_rst(elements, role_entrypoint=None) %}
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns/col2/foo2_module.rst

@@ -92,12 +92,13 @@ The below requirements are needed on the host that executes this module.
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -288,12 +289,13 @@ Parameters
 Attributes
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Attribute
     - Support
@@ -479,12 +481,13 @@ Return Values
 -------------
 Common return values are documented :ref:`here <common_return_values>`, the following are the fields unique to this module:
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns/col2/foo3_module.rst

@@ -87,12 +87,13 @@ The below requirements are needed on the host that executes this module.
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -245,12 +246,13 @@ Parameters
 Attributes
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Attribute
     - Support

tests/functional/baseline-default/collections/ns/col2/foo4_module.rst

@@ -76,12 +76,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

tests/functional/baseline-default/collections/ns2/col/bar_filter.rst

@@ -82,12 +82,13 @@ Input
 
 This describes the input of the filter, the value before ``| ns2.col.bar``.
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -140,12 +141,13 @@ Positional parameters
 This describes positional parameters of the filter. These are the values ``positional1``, ``positional2`` and so on in the following
 example: ``input | ns2.col.bar(positional1, positional2, ...)``
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -242,12 +244,13 @@ Keyword parameters
 This describes keyword parameters of the filter. These are the values ``key1=value1``, ``key2=value2`` and so on in the following
 example: ``input | ns2.col.bar(key1=value1, key2=value2, ...)``
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -346,12 +349,13 @@ Examples
 Return Value
 ------------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns2/col/bar_test.rst

@@ -80,12 +80,13 @@ Input
 
 This describes the input of the test, the value before ``is ns2.col.bar`` or ``is not ns2.col.bar``.
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -162,12 +163,13 @@ Examples
 Return Value
 ------------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns2/col/foo2_module.rst

@@ -80,12 +80,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -133,12 +134,13 @@ Parameters
 Attributes
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Attribute
     - Support
@@ -343,12 +345,13 @@ Return Values
 -------------
 Common return values are documented :ref:`here <common_return_values>`, the following are the fields unique to this module:
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns2/col/foo_become.rst

@@ -90,12 +90,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

tests/functional/baseline-default/collections/ns2/col/foo_cache.rst

@@ -81,12 +81,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

tests/functional/baseline-default/collections/ns2/col/foo_callback.rst

@@ -87,12 +87,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

tests/functional/baseline-default/collections/ns2/col/foo_connection.rst

@@ -81,12 +81,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments

tests/functional/baseline-default/collections/ns2/col/foo_filter.rst

@@ -82,12 +82,13 @@ Input
 
 This describes the input of the filter, the value before ``| ns2.col.foo``.
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -140,12 +141,13 @@ Keyword parameters
 This describes keyword parameters of the filter. These are the values ``key1=value1``, ``key2=value2`` and so on in the following
 example: ``input | ns2.col.foo(key1=value1, key2=value2, ...)``
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments
@@ -255,12 +257,13 @@ Examples
 Return Value
 ------------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Key
     - Description

tests/functional/baseline-default/collections/ns2/col/foo_inventory.rst

@@ -81,12 +81,13 @@ Synopsis
 Parameters
 ----------
 
-.. rst-class:: ansible-option-table
+.. tabularcolumns:: \X{1}{3}\X{2}{3}
 
 .. list-table::
   :width: 100%
   :widths: auto
   :header-rows: 1
+  :class: longtable ansible-option-table
 
   * - Parameter
     - Comments