Fix HTML validation errors - remove h7 tag, document the rule in FDP
""Listening Side"" and ""Initiating Side"" in the Developers Handbook
used level 5 headings, which render as <h7> in single-page HTML
output for books and fail W3C validation.
Replace them with a bold phrase, and add a WARNING to the
Asciidoctor chapter of the FDP Primer that level 5 headings are
unusable in books.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60070
PR: 297509
Fix HTML validation errors in docs - on main page
Card titles on the documentation homepage were rendered as <h5>
right after the <h2> from global-search.html, skipping two
heading levels. The page also had no <h1>.
Add a visually hidden <h1>{{ .Title }}</h1> before the search
partial, render card titles as <h3 class=""card-title"">, and
rename the .card a h5 selector to .card a .card-title with
padding-top and padding-bottom set, so the look stays
the same. Add a .visually-hidden helper to global.scss.
Differential Revision: https://reviews.freebsd.org/D60069
PR: 297509
Fix HTML validation errors in docs site header - menu ids
Same fix as 10633eb for the website header, applied to the
documentation header.
Ids like about, download, documentation and community in the
documentation top menu collide with the same ids inside documents,
breaking validation and <label for=...>. Prefix them with the
section name (e.g. header-community-title).
Differential Revision: https://reviews.freebsd.org/D60059
PR: 297509
Fix HTML validation errors in docs - articles title section
article: render subtitle as <p> instead of <h3>
The subtitle is part of the title block, not a section heading.
Rendering it as <h3> right after <h1> broke W3C validation and
caused screen readers to announce it as a level-3 heading.
Move the visual styling from the <h3> tag to a `.subtitle` class
in documentation.scss to keep the appearance unchanged.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60058
PR: 297509
Fix HTML validation errors in doc site footer
Replace the <h3> column titles with <p class=""column-title""> to stop
validation errors about skipped heading levels on every page, and add
aria-labelledby on each section so the titles are still exposed as
accessible names.
Restore the styling h3 previously received from the browser
(font-weight, line-height, padding) on .column-title so the footer
looks unchanged.
Mirrors the website fix in c33d966fc2.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60040
PR: 297509
Website: Fix HTML validation errors
Remove the <a> wrapper around each <label> in the top-level menu,
which triggered HTML validation error on every documentation page.
Extend the .menu-item a rules to .menu-item-description so the label
keeps the same appearance and the sub-menu hover trigger still works.
Mirrors the website fix in a8654f311.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60039
PR: 297509
doc: fix HTML validation errors
Fix duplicate id and invalid heading levels in TOC
Replace h3 with p.toc-title to fix heading-level validation errors,
rename mobile TOC id to TableOfContentsMobile to avoid duplicate ids,
and restore original h3 sizing via --size-550.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D60037
PR: 297509
ports.cgi: enable new responsive design
Implement and enable new design for ports.cgi, based on c9c518d9db
Also, move the submit button next to the input field and the select boxes
a row below. Looks better for some mobile devices (e.g. Android) which
cannot detect a submit by the enter key.
Reviewed by: ziaee
Website: Fix HTML validation errors
Ids like documentation, download, support, about, community in the
top menu collide with the same ids inside documents, breaking
validation and <label for=...>. Match footer.html and prefix them
with the section name (e.g. header-community-title).
Note: id=""name"" is left as is, so [[name]] anchors are implicitly
unavailable on the site.
Reviewed by: carlavilla
Approved by: carlavilla
Differential Revision: https://reviews.freebsd.org/D59857
PR: 297509
