github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-09-09 04:39:34 +00:00
Code Issues Projects Releases Wiki Activity

doc: use DX-friendly names in configuration option documentation

Browse Source 
Change the generated config option documentation to use the DX-friendly
names defined for the configurator UI (instead of the XML element name
hierarchy previously used).

Options are grouped by the top-level section (aka complex type) they
belong to and then sorted alphabetically with these groups.

Use badges to indicate where options can be found in the configurator UI
and whether they're applicable to the Hypervisor or Pre/Post/Service VM.
Add a custom css style for the config-option doc that puts the first
paragraph of a glossary item on the same line as the glossary term so
these badges look pretty.

Added a acrn-custom.js patch that copies the alt text for images into a
title property for images within the config-doc document.  This provides
tooltip text when hovering over the badges.

Don't display options not visible in the configurator UI (elements with
acrn:views="").

A missing acrn:views or acrn:applicable-vm means we look for an
applicable value from an ancestor element.

Add processing of a second xs:documentation element within an
xs:annotation element. This second documentation element's content will
be appended as a new paragraph to the first xs:documentation content in
the generated documentation. Only the first xs:documentation element is
used by the Configurator for its tooltips.

Update documents that were referring to options by their XML names.

Because we're now using a glossary to provide links to config options,
we can't duplicate option names or glosary names anywhere in the doc
set.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder
2022-04-20 14:09:22 -07:00
committed by David Kinder
parent f8f1689a88
commit f71c7a8032
16 changed files with 328 additions and 188 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
doc/static/acrn-custom.css vendored
View File

@@ -389,3 +389,31 @@ html.writer-html5 .rst-content table.docutils td p {
margin-bottom: 0;
font-size: .9rem;
}
/* Simulate look of an option directive on glossary items (particularly used on
* config option listings so we can use a glossary to sort config options within
* a section of options*/
div#scenario-configuration-options dl.glossary dt {
display: table;
margin: 6px 10px;
font-weight: bold;
color: #000;
line-height: normal;
background: #e7f2fa;
color: #2980b9;
border-top: 3px solid #6ab0de;
padding: 6px;
position: relative;
}
div#scenario-configuration-options dl.glossary dt {
float: left;
clear: left;
}
div#scenario-configuration-options dl.glossary dd>p {
padding-top: 12px;
line-height: normal;
clear: right;
}
div#scenario-configuration-options dl.glossary dd ul {
clear: both;
}

5
doc/static/acrn-custom.js vendored
View File

@@ -6,4 +6,9 @@ $(document).ready(function(){
/* open external links in a new tab */
$('a[class*=external]').attr({target: '_blank', rel: 'noopener'});
/* copy image alt tags in config option page as title for hover text tool tip by browser */
$("div#scenario-configuration-options img[alt]").each(function(){
$(this).attr('title', $(this).attr('alt'));
});
});