fix(docs): too much whitespace around <pre> blocks #24151

Problem:
In the generated docs HTML there is too much whitespace before/after `<pre>`
blocks.
- In the old layout (fixed-width), all text in `.old-help-para` is formatted as
  `white-space:pre`.
- In the new layout, when `<pre>` is at the end of a `<div>`, the margins of
  both are redundant, causing too much space.

Solution:
- In the old layout, always remove `<pre>` margin.
- In the new layout, disable `<pre>` margin if it is the last child.
This commit is contained in:
Justin M. Keyes 2023-06-25 12:29:56 -07:00 committed by GitHub
parent 5ceb2238d3
commit 957d05d16b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 11 additions and 1 deletions

View File

@ -2015,7 +2015,7 @@ Buffer Functions *api-buffer*
For more information on buffers, see |buffers|.
Unloaded Buffers:~
Unloaded Buffers: ~
Buffers may be unloaded by the |:bunload| command or the buffer's
|'bufhidden'| option. When a buffer is unloaded its file contents are

View File

@ -944,6 +944,7 @@ local function gen_css(fname)
padding-top: 10px;
padding-bottom: 10px;
}
.old-help-para {
padding-top: 10px;
padding-bottom: 10px;
@ -953,6 +954,12 @@ local function gen_css(fname)
font-size: 16px;
font-family: ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace;
}
.old-help-para pre {
/* All text in .old-help-para is formatted as "white-space:pre" so text following <pre> is
already visually separated by the linebreak. */
margin-bottom: 0;
}
a.help-tag, a.help-tag:focus, a.help-tag:hover {
color: inherit;
text-decoration: none;
@ -1006,6 +1013,9 @@ local function gen_css(fname)
font-size: 16px;
margin-top: 10px;
}
pre:last-child {
margin-bottom: 0;
}
pre:hover,
.help-heading:hover {
overflow: visible;