John Snow <js...@redhat.com> writes:
> Improve the general look and feel of generated QAPI docs.
>
> Attempt to limit line lengths to offer a more comfortable measure on
> maximized windows, and improve some margin and spacing for field lists.
>
> Signed-off-by: Harmonie Snow <harmo...@gmail.com>
> Signed-off-by: John Snow <js...@redhat.com>
> ---
> docs/sphinx-static/theme_overrides.css | 56 +++++++++++++++++++++++++-
> 1 file changed, 54 insertions(+), 2 deletions(-)
>
> diff --git a/docs/sphinx-static/theme_overrides.css
> b/docs/sphinx-static/theme_overrides.css
> index 3fd326613d9..92f395054a8 100644
> --- a/docs/sphinx-static/theme_overrides.css
> +++ b/docs/sphinx-static/theme_overrides.css
> @@ -18,8 +18,8 @@ h1, h2, .rst-content .toctree-wrapper p.caption, h3, h4,
> h5, h6, legend {
>
> .rst-content dl:not(.docutils) dt {
> border-top: none;
> - border-left: solid 3px #ccc;
> - background-color: #f0f0f0;
> + border-left: solid 5px #bcc6d2;
> + background-color: #eaedf1;
> color: black;
> }
>
> @@ -211,6 +211,18 @@ div[class^="highlight"] pre {
>
> /* QAPI domain theming */
>
> +/* most content in a qapi object definition should not eclipse about
QAPI unless there's a reason for lower case.
> + 80ch, but nested field lists are explicitly exempt due to their
> + two-column nature */
> +.qapi dd *:not(dl) {
> + max-width: 80ch;
> +}
> +
> +/* but the content column itself should still be less than ~80ch. */
> +.qapi .field-list dd {
> + max-width: 80ch;
> +}
> +
> .qapi-infopips {
> margin-bottom: 1em;
> }
[...]
