mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2026-01-05 07:35:31 +00:00
doc: use DX-friendly names in configuration option documentation
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
committed by
David Kinder
David Kinder
parent
f8f1689a88
commit
f71c7a8032
@@ -1,165 +1,226 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
|
||||
<xsl:stylesheet
|
||||
version="1.0"
|
||||
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema">
|
||||
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:acrn="https://projectacrn.org" version="1.0">
|
||||
<xsl:output method="text"/>
|
||||
|
||||
<xsl:variable name="newline" select="'
'"/>
|
||||
<xsl:variable name="newline" select="' '"/>
|
||||
<xsl:variable name="section_adornment" select="'#*=-%+@`'"/>
|
||||
|
||||
<xsl:variable name="vLower" select= "'abcdefghijklmnopqrstuvwxyz'"/>
|
||||
<xsl:variable name="vUpper" select= "'ABCDEFGHIJKLMNOPQRSTUVWXYZ'"/>
|
||||
|
||||
<!--
|
||||
Visitors of XSD elements
|
||||
-->
|
||||
|
||||
<xsl:variable name="vLower" select="'abcdefghijklmnopqrstuvwxyz'"/>
|
||||
<xsl:variable name="vUpper" select="'ABCDEFGHIJKLMNOPQRSTUVWXYZ'"/>
|
||||
<!-- xslt script to autogenerate config option documentation -->
|
||||
<!-- Get things started with the ACRNConfigType element -->
|
||||
<xsl:template match="/xs:schema">
|
||||
|
||||
<xsl:apply-templates select="xs:complexType[@name='ACRNConfigType']">
|
||||
<xsl:with-param name="level" select="2"/>
|
||||
<xsl:with-param name="prefix" select="''"/>
|
||||
<xsl:with-param name="parent" select="."/>
|
||||
</xsl:apply-templates>
|
||||
|
||||
</xsl:template>
|
||||
|
||||
<!-- Walk through all the ACRNConfigType element's children -->
|
||||
<xsl:template match="xs:complexType[@name='ACRNConfigType']">
|
||||
<xsl:param name="level"/>
|
||||
<xsl:param name="prefix"/>
|
||||
|
||||
<xsl:apply-templates select="descendant::xs:element">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="prefix" select="$prefix"/>
|
||||
<xsl:with-param name="parent" select="."/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:template>
|
||||
|
||||
<!-- ... and process all the child elements -->
|
||||
<xsl:template match="xs:element">
|
||||
<xsl:param name="level"/>
|
||||
<xsl:param name="prefix"/>
|
||||
|
||||
<xsl:param name="parent"/>
|
||||
<xsl:variable name="ty">
|
||||
<xsl:choose>
|
||||
<xsl:when test="@type">
|
||||
<xsl:value-of select="@type" />
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select=".//xs:alternative[1]/@type" />
|
||||
</xsl:otherwise>
|
||||
<xsl:when test="@type">
|
||||
<xsl:value-of select="@type"/>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select=".//xs:alternative[1]/@type"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
|
||||
<!-- dxnamePure and dxname hold the element name with and without spaces converted to underscores -->
|
||||
<xsl:variable name="dxnamePure">
|
||||
<xsl:choose>
|
||||
<xsl:when test=".//descendant::xs:annotation/@acrn:title">
|
||||
<xsl:value-of select=".//descendant::xs:annotation/@acrn:title"/>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select="@name"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
<xsl:variable name="dxname">
|
||||
<xsl:value-of select="translate($dxnamePure,' ','_')"/>
|
||||
</xsl:variable>
|
||||
<!-- Only visit elements having complex types. Those having simple types are
|
||||
described as an option.. -->
|
||||
described as an option -->
|
||||
<xsl:choose>
|
||||
<xsl:when test="//xs:complexType[@name=$ty]">
|
||||
<!-- for top level sections (level 2) put a begin/end comment for
|
||||
potential use in rst include directives -->
|
||||
<xsl:if test="$level = 2">
|
||||
<xsl:value-of select="concat('.. section-start ', $prefix, @name, $newline)"/>
|
||||
</xsl:if>
|
||||
<!-- The section header -->
|
||||
<xsl:if test="$level <= 4">
|
||||
<xsl:call-template name="section-header">
|
||||
<xsl:with-param name="title" select="concat($prefix, @name)"/>
|
||||
<xsl:with-param name="label" select="concat($prefix, @name)"/>
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
</xsl:call-template>
|
||||
|
||||
<!-- Description of this menu / entry -->
|
||||
<xsl:call-template name="print-annotation" >
|
||||
<!-- The section header -->
|
||||
<xsl:if test="$level <= 4">
|
||||
<xsl:call-template name="section-header">
|
||||
<xsl:with-param name="title" select="$dxnamePure"/>
|
||||
<xsl:with-param name="label" select="concat($prefix, $dxname)"/>
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
</xsl:call-template>
|
||||
<!-- Description of this menu / entry -->
|
||||
<xsl:call-template name="print-annotation">
|
||||
<xsl:with-param name="indent" select="''"/>
|
||||
</xsl:call-template>
|
||||
|
||||
<xsl:value-of select="$newline"/>
|
||||
<!-- Occurence requirements (removed, but save just in case)
|
||||
<xsl:call-template name="print-occurs">
|
||||
<xsl:with-param name="name" select="@name"/>
|
||||
</xsl:call-template>
|
||||
-->
|
||||
</xsl:call-template>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:if>
|
||||
|
||||
<!-- Visit the complex type to generate menus and/or entries -->
|
||||
<xsl:apply-templates select="//xs:complexType[@name=$ty]">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="name" select="concat($prefix, @name)"/>
|
||||
</xsl:apply-templates>
|
||||
<!-- for top level sections (level 2) put a begin/end comment for
|
||||
potential use in rst include directives -->
|
||||
<xsl:if test="$level = 2">
|
||||
<xsl:value-of select="concat('.. section-end ', $prefix, @name, $newline)"/>
|
||||
</xsl:if>
|
||||
<!-- use a sorted glossary to show a sorted list of config options in this section -->
|
||||
<xsl:value-of select="concat('.. glossary::',$newline,' :sorted:',$newline,$newline)"/>
|
||||
</xsl:if>
|
||||
<!-- Visit the complex type to generate menus and/or entries -->
|
||||
<xsl:apply-templates select="//xs:complexType[@name=$ty]">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="name" select="concat($prefix, $dxname)"/>
|
||||
<xsl:with-param name="parent" select="."/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:when>
|
||||
<xsl:when test="xs:annotation/@acrn:views=''">
|
||||
<!-- don't document elements if not viewable -->
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<!-- Write a section header for elements with a simple type -->
|
||||
<!-- No longer writing a section header for elements with a simple type
|
||||
<xsl:if test="$level = 3">
|
||||
<xsl:call-template name="section-header">
|
||||
<xsl:with-param name="title" select="concat($prefix, @name)"/>
|
||||
<xsl:with-param name="label" select="concat($prefix, @name)"/>
|
||||
<xsl:with-param name="title" select="$dxnamePure"/>
|
||||
<xsl:with-param name="label" select="concat($prefix, $dxname)"/>
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
</xsl:call-template>
|
||||
</xsl:if>
|
||||
|
||||
<xsl:call-template name="option-header">
|
||||
<xsl:with-param name="label" select="concat($prefix, @name)"/>
|
||||
</xsl:call-template>
|
||||
<xsl:value-of select="$newline"/>
|
||||
<!-- Print the description, type, and occurrence requirements -->
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:call-template name="print-annotation" >
|
||||
<xsl:with-param name="indent" select="' '"/>
|
||||
</xsl:call-template>
|
||||
<xsl:choose>
|
||||
<xsl:when test="//xs:simpleType[@name=$ty]">
|
||||
<xsl:apply-templates select="//xs:simpleType[@name=$ty]"/>
|
||||
</xsl:when>
|
||||
<xsl:when test="starts-with($ty, 'xs:')">
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:value-of select="concat(translate(substring($ty, 4,1), $vLower, $vUpper), substring($ty,5))"/>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<!-- element doesn't have a named type, check for an unnamed simpleType child -->
|
||||
<xsl:apply-templates select="descendant::xs:simpleType">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="prefix" select="''"/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<!-- removing occurs info for now
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:call-template name="print-occurs" >
|
||||
<xsl:with-param name="name" select="@name"/>
|
||||
</xsl:call-template>
|
||||
</xsl:if> -->
|
||||
<!-- print option as a glossary item -->
|
||||
<!-- put a sortable character in front of options not available in UI -->
|
||||
<!-- <xsl:if test="xs:annotation/@acrn:views=''">
|
||||
<xsl:text> ~</xsl:text>
|
||||
</xsl:if> -->
|
||||
<xsl:value-of select="concat(' ',$dxnamePure,$newline)"/>
|
||||
<!-- print icons for basic/advanced, hypervisor/VM applicability -->
|
||||
<xsl:variable name="option-icons">
|
||||
<!-- acrn:views describes if this option appears on a "basic" or "advanced" tab, or not at all
|
||||
when the value is "". If the acrn:views attribute is missing, then the containing parent's
|
||||
acrn:views value is used instead. Similarly for the acrn:applicable-vms attribute. -->
|
||||
<xsl:choose>
|
||||
<xsl:when test="contains($prefix,'Hypervisor')">
|
||||
<xsl:text>|icon-hypervisor| </xsl:text>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:choose>
|
||||
<xsl:when test="count(xs:annotation/@acrn:applicable-vms)=0">
|
||||
<xsl:if test="contains($parent/xs:annotation/@acrn:applicable-vms,'pre-launched') or contains($parent/../xs:annotation/@acrn:applicable-vms,'pre-launched') or contains($parent/../../xs:annotation/@acrn:applicable-vms,'pre-launched')">
|
||||
<xsl:text>|icon-pre-launched-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains($parent/xs:annotation/@acrn:applicable-vms,'post-launched') or contains($parent/../xs:annotation/@acrn:applicable-vms,'post-launched') or contains($parent/../../xs:annotation/@acrn:applicable-vms,'post-launched')">
|
||||
<xsl:text>|icon-post-launched-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains($parent/xs:annotation/@acrn:applicable-vms,'service-vm') or contains($parent/../xs:annotation/@acrn:applicable-vms,'service-vm') or contains($parent/../../xs:annotation/@acrn:applicable-vms,'service-vm')">
|
||||
<xsl:text>|icon-service-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:if test="contains(xs:annotation/@acrn:applicable-vms,'pre-launched')">
|
||||
<xsl:text>|icon-pre-launched-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains(xs:annotation/@acrn:applicable-vms,'post-launched')">
|
||||
<xsl:text>|icon-post-launched-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains(xs:annotation/@acrn:applicable-vms,'service-vm')">
|
||||
<xsl:text>|icon-service-vm| </xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<xsl:text>/ </xsl:text>
|
||||
<xsl:if test="xs:annotation/@acrn:views=''">
|
||||
<xsl:text>|icon-not-available| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="count(xs:annotation/@acrn:views)=0">
|
||||
<xsl:if test="contains($parent/xs:annotation/@acrn:views,'basic') or contains($parent/../xs:annotation/@acrn:views,'basic') or contains($parent/../../xs:annotation/@acrn:views,'basic')">
|
||||
<xsl:text>|icon-basic| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains($parent/xs:annotation/@acrn:views,'advanced') or contains($parent/../xs:annotation/@acrn:views,'advanced') or contains($parent/../../xs:annotation/@acrn:views,'advanced')">
|
||||
<xsl:text>|icon-advanced| </xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains(xs:annotation/@acrn:views,'basic')">
|
||||
<xsl:text>|icon-basic| </xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="contains(xs:annotation/@acrn:views,'advanced')">
|
||||
<xsl:text>|icon-advanced| </xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:variable>
|
||||
<xsl:if test="$option-icons!=''">
|
||||
<xsl:value-of select="concat(' ',$option-icons,$newline)"/>
|
||||
</xsl:if>
|
||||
<xsl:value-of select="$newline"/>
|
||||
<!-- Print the description, type, and occurrence requirements -->
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:call-template name="print-annotation">
|
||||
<xsl:with-param name="indent" select="' '"/>
|
||||
</xsl:call-template>
|
||||
<xsl:choose>
|
||||
<xsl:when test="//xs:simpleType[@name=$ty]">
|
||||
<xsl:apply-templates select="//xs:simpleType[@name=$ty]">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="prefix" select="''"/>
|
||||
<xsl:with-param name="parent" select="$parent"/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:when>
|
||||
<xsl:when test="starts-with($ty, 'xs:')">
|
||||
<xsl:text> - </xsl:text>
|
||||
<!-- if unnamed type such as xs:string or xs:integer, print that simple type name with an uppercase first letter -->
|
||||
<xsl:value-of select="concat(translate(substring($ty, 4,1), $vLower, $vUpper), substring($ty,5),' value')"/>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<!-- element doesn't have a named type, check for an unnamed simpleType child -->
|
||||
<xsl:apply-templates select="descendant::xs:simpleType">
|
||||
<xsl:with-param name="level" select="$level"/>
|
||||
<xsl:with-param name="prefix" select="''"/>
|
||||
<xsl:with-param name="parent" select="$parent"/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<!-- Removed printing occurrance information
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:call-template name="print-occurs">
|
||||
<xsl:with-param name="name" select="$dxnamePure"/>
|
||||
</xsl:call-template> -->
|
||||
<xsl:value-of select="$newline"/>
|
||||
-->
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="xs:complexType">
|
||||
<xsl:param name="level"/>
|
||||
<xsl:param name="name"/>
|
||||
|
||||
<xsl:param name="parent"/>
|
||||
<!-- Visit the sub-menus -->
|
||||
<xsl:apply-templates select="descendant::xs:element">
|
||||
<xsl:with-param name="level" select="$level + 1"/>
|
||||
<xsl:with-param name="prefix" select="concat($name, '.')"/>
|
||||
<xsl:with-param name="parent" select="$parent"/>
|
||||
</xsl:apply-templates>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="xs:simpleType">
|
||||
<xsl:text> - </xsl:text>
|
||||
<xsl:call-template name="print-annotation" >
|
||||
<xsl:with-param name="indent" select="' '"/>
|
||||
</xsl:call-template>
|
||||
<xsl:choose>
|
||||
<xsl:when test="xs:annotation/xs:documentation">
|
||||
<xsl:call-template name="print-annotation">
|
||||
<xsl:with-param name="indent" select="' '"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:text>No type annotation found</xsl:text>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template name="print-occurs">
|
||||
<xsl:param name="name"/>
|
||||
<!-- use the min/maxOccurs data to figure out if this is an optional
|
||||
<!-- use the min/maxOccurs data to figure out if this is an optional
|
||||
item, and how many occurrences are allowed -->
|
||||
<xsl:variable name="min">
|
||||
<xsl:choose>
|
||||
@@ -169,7 +230,6 @@
|
||||
<xsl:otherwise>1</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
|
||||
<xsl:variable name="max">
|
||||
<xsl:choose>
|
||||
<xsl:when test="@maxOccurs">
|
||||
@@ -178,10 +238,9 @@
|
||||
<xsl:otherwise>1</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
|
||||
<xsl:text>The **</xsl:text>
|
||||
<xsl:text>The ``</xsl:text>
|
||||
<xsl:value-of select="$name"/>
|
||||
<xsl:text>** option is </xsl:text>
|
||||
<xsl:text>`` option is </xsl:text>
|
||||
<xsl:choose>
|
||||
<xsl:when test="$min = 0">
|
||||
<xsl:text>optional</xsl:text>
|
||||
@@ -190,13 +249,12 @@
|
||||
<xsl:text>required</xsl:text>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<xsl:text> and with </xsl:text>
|
||||
|
||||
<xsl:text> (</xsl:text>
|
||||
<xsl:choose>
|
||||
<xsl:when test="($min = $max) or ($min = 0)">
|
||||
<xsl:value-of select="$max"/>
|
||||
<xsl:text> occurrence</xsl:text>
|
||||
<xsl:if test="$max > 1">
|
||||
<xsl:if test="$max > 1 or $max='unbounded'">
|
||||
<xsl:text>s</xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:when>
|
||||
@@ -207,10 +265,9 @@
|
||||
<xsl:text> occurrences</xsl:text>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<xsl:text>.</xsl:text>
|
||||
<xsl:text>).</xsl:text>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template name="print-annotation">
|
||||
<xsl:param name="indent"/>
|
||||
<!-- append an (Optional) annotation if minOccurs=0) -->
|
||||
@@ -218,11 +275,16 @@
|
||||
<xsl:choose>
|
||||
<xsl:when test="@minOccurs">
|
||||
<xsl:if test="@minOccurs = 0">
|
||||
<xsl:text> *(Optional)*</xsl:text>
|
||||
<xsl:text> *(Optional)*</xsl:text>
|
||||
</xsl:if>
|
||||
<xsl:if test="@minOccurs != 0">
|
||||
<xsl:text> *(Required)**</xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:when>
|
||||
<!-- could show (Required) here instead, but it seemed too noisy -->
|
||||
<xsl:otherwise><xsl:text></xsl:text></xsl:otherwise>
|
||||
<xsl:otherwise>
|
||||
<xsl:text/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
<!-- append a default value annotation if default was defined -->
|
||||
@@ -231,16 +293,23 @@
|
||||
<xsl:when test="@default">
|
||||
<xsl:value-of select="concat(' (Default value is ``', @default, '``)')"/>
|
||||
</xsl:when>
|
||||
<xsl:otherwise><xsl:text></xsl:text></xsl:otherwise>
|
||||
<xsl:otherwise>
|
||||
<xsl:text/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:variable>
|
||||
|
||||
<xsl:choose>
|
||||
<xsl:when test="xs:annotation">
|
||||
<xsl:call-template name="printIndented">
|
||||
<xsl:with-param name="text" select="concat(xs:annotation/xs:documentation, $optional, $default)"/>
|
||||
<xsl:with-param name="indent" select="$indent"/>
|
||||
</xsl:call-template>
|
||||
<xsl:call-template name="printIndented">
|
||||
<xsl:with-param name="text" select="concat(xs:annotation/xs:documentation[1], $default)"/>
|
||||
<xsl:with-param name="indent" select="$indent"/>
|
||||
</xsl:call-template>
|
||||
<!-- append a second xs:annotation if found. This allows more content for the documentation that
|
||||
won't be included in the Configurator tooltip -->
|
||||
<xsl:call-template name="printIndented">
|
||||
<xsl:with-param name="text" select="concat($newline, xs:annotation/xs:documentation[2])"/>
|
||||
<xsl:with-param name="indent" select="$indent"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<!-- <xsl:text><description is missing ></xsl:text> -->
|
||||
@@ -248,23 +317,20 @@
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:template>
|
||||
|
||||
<!--
|
||||
Library Routines
|
||||
-->
|
||||
|
||||
<xsl:template name="repeat">
|
||||
<xsl:param name="string"/>
|
||||
<xsl:param name="times"/>
|
||||
<xsl:if test="$times > 0">
|
||||
<xsl:if test="$times > 0">
|
||||
<xsl:value-of select="$string"/>
|
||||
<xsl:call-template name="repeat">
|
||||
<xsl:with-param name="string" select="$string"/>
|
||||
<xsl:with-param name="times" select="$times - 1"/>
|
||||
<xsl:with-param name="string" select="$string"/>
|
||||
<xsl:with-param name="times" select="$times - 1"/>
|
||||
</xsl:call-template>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template name="section-header">
|
||||
<xsl:param name="title"/>
|
||||
<xsl:param name="label"/>
|
||||
@@ -275,51 +341,39 @@
|
||||
<xsl:value-of select="concat($title, $newline)"/>
|
||||
<xsl:call-template name="repeat">
|
||||
<xsl:with-param name="string">
|
||||
<xsl:value-of select="substring($section_adornment, $level, 1)"/>
|
||||
<xsl:value-of select="substring($section_adornment, $level, 1)"/>
|
||||
</xsl:with-param>
|
||||
<xsl:with-param name="times" select="string-length($title)"/>
|
||||
</xsl:call-template>
|
||||
<xsl:value-of select="concat($newline, $newline)"/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template name="option-header">
|
||||
<xsl:param name="label"/>
|
||||
<!-- we're using the reST option directive for creating linkable
|
||||
config option sections using the :option: role. This also
|
||||
gives us the option directive HTML formatting. -->
|
||||
<xsl:value-of select="$newline"/>
|
||||
<xsl:text>.. option:: </xsl:text>
|
||||
<xsl:value-of select="$label"/>
|
||||
<xsl:value-of select="$newline"/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template name="printIndented">
|
||||
<xsl:param name="text"/>
|
||||
<xsl:param name="indent"/>
|
||||
<!-- Handle multi-line documentation text and indent it properly for
|
||||
<xsl:template name="printIndented">
|
||||
<xsl:param name="text"/>
|
||||
<xsl:param name="indent"/>
|
||||
<!-- Handle multi-line documentation text and indent it properly for
|
||||
the bullet list display we're using for node descriptions (but not for
|
||||
heading descriptions -->
|
||||
<xsl:if test="$text">
|
||||
<xsl:variable name="thisLine" select="substring-before($text, $newline)"/>
|
||||
<xsl:variable name="nextLine" select="substring-after($text, $newline)"/>
|
||||
<xsl:choose>
|
||||
<xsl:when test="$thisLine or $nextLine">
|
||||
<!-- $text contains at least one newline, and there's more coming so print it -->
|
||||
<xsl:value-of select="concat($thisLine, $newline)"/>
|
||||
<!-- watch for two newlines in a row and avoid writing the indent -->
|
||||
<xsl:if test="substring-before(concat($nextLine, $newline), $newline)" >
|
||||
<xsl:value-of select="$indent"/>
|
||||
</xsl:if>
|
||||
<!-- and recurse to process the rest -->
|
||||
<xsl:call-template name="printIndented">
|
||||
<xsl:with-param name="text" select="$nextLine"/>
|
||||
<xsl:with-param name="indent" select="$indent"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select="concat($text, $newline)"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
<xsl:if test="$text">
|
||||
<xsl:variable name="thisLine" select="substring-before($text, $newline)"/>
|
||||
<xsl:variable name="nextLine" select="substring-after($text, $newline)"/>
|
||||
<xsl:choose>
|
||||
<xsl:when test="$thisLine or $nextLine">
|
||||
<!-- $text contains at least one newline, and there's more coming so print it -->
|
||||
<xsl:value-of select="concat($thisLine, $newline)"/>
|
||||
<!-- watch for two newlines in a row and avoid writing the indent -->
|
||||
<xsl:if test="substring-before(concat($nextLine, $newline), $newline)">
|
||||
<xsl:value-of select="$indent"/>
|
||||
</xsl:if>
|
||||
<!-- and recurse to process the rest -->
|
||||
<xsl:call-template name="printIndented">
|
||||
<xsl:with-param name="text" select="$nextLine"/>
|
||||
<xsl:with-param name="indent" select="$indent"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select="concat($text, $newline)"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
</xsl:stylesheet>
|
||||
|
||||
Reference in New Issue
Block a user