mirror of
https://github.com/boostorg/docca.git
synced 2026-01-19 04:12:08 +00:00
Evan Lenz
@@ -99,25 +99,13 @@ make common.xsl : $(docca)/include/docca/common.xsl
|
||||
make stage1.xsl : $(docca)/include/docca/stage1.xsl : @copy_script ;
|
||||
make base-stage1.xsl : $(docca)/include/docca/base-stage1.xsl : @copy_script ;
|
||||
make stage2.xsl : $(docca)/include/docca/stage2.xsl : @copy_script ;
|
||||
make base-stage2.xsl : $(docca)/include/docca/base-stage2.xsl : @copy_script ;
|
||||
make assemble-quickbook.xsl : $(docca)/include/docca/assemble-quickbook.xsl : @copy_script ;
|
||||
make emphasized-types.xsl : $(docca)/include/docca/emphasized-types.xsl : @copy_script ;
|
||||
make base-config.xsl : $(docca)/include/docca/base-config.xsl : @copy_script ;
|
||||
|
||||
make config.xsl
|
||||
:
|
||||
$(docca)/include/docca/config.xsl
|
||||
xsl/config.xsl
|
||||
xsl/class_detail.xsl
|
||||
xsl/includes.xsl
|
||||
:
|
||||
@make_config
|
||||
;
|
||||
|
||||
actions make_config
|
||||
{
|
||||
cp $(2[1]) $(1)
|
||||
sed -i -e "/<!-- CONFIG_TEMPLATE -->/{r $(2[2])" -e "d}" $(1)
|
||||
sed -i -e "/<!-- INCLUDES_FOOT_TEMPLATE -->/{r $(2[4])" -e "d}" $(1)
|
||||
}
|
||||
# Copy the project-specific config XSLT
|
||||
make custom-overrides.xsl : xsl/custom-overrides.xsl : @copy_script ;
|
||||
|
||||
# Make a copy of the given file.
|
||||
#
|
||||
@@ -142,7 +130,8 @@ make xml-pages.xml
|
||||
|
||||
# Make bjam aware of additional dependencies
|
||||
base-extract-xml-pages.xsl
|
||||
config.xsl
|
||||
base-config.xsl
|
||||
custom-overrides.xsl
|
||||
common.xsl
|
||||
:
|
||||
saxonhe.saxonhe
|
||||
@@ -173,7 +162,8 @@ make stage1/results
|
||||
# additional dependencies
|
||||
xml-pages.xml
|
||||
base-stage1.xsl
|
||||
config.xsl
|
||||
base-config.xsl
|
||||
custom-overrides.xsl
|
||||
common.xsl
|
||||
:
|
||||
saxonhe.saxonhe_dir
|
||||
@@ -186,6 +176,10 @@ make stage2/results
|
||||
|
||||
# additional dependencies
|
||||
emphasized-types.xsl
|
||||
base-stage2.xsl
|
||||
base-config.xsl
|
||||
custom-overrides.xsl
|
||||
common.xsl
|
||||
:
|
||||
saxonhe.saxonhe_dir
|
||||
;
|
||||
@@ -308,4 +302,4 @@ alias boostdoc ;
|
||||
explicit boostdoc ;
|
||||
|
||||
alias boostrelease : json ;
|
||||
explicit boostrelease ;
|
||||
explicit boostrelease ;
|
||||
|
||||
@@ -1,6 +0,0 @@
|
||||
<!-- CLASS_DETAIL_TEMPLATE BEGIN -->
|
||||
<xsl:when test="$normal-tparam = 'Allocator'"><xsl:text>__Allocator__</xsl:text></xsl:when>
|
||||
<xsl:when test="$normal-tparam = 'InputIterator'"><xsl:text>__InputIterator__</xsl:text></xsl:when>
|
||||
<xsl:when test="$normal-tparam = 'ConstBufferSequence'"><xsl:text>__ConstBufferSequence__</xsl:text></xsl:when>
|
||||
<xsl:when test="$normal-tparam = 'MutableBufferSequence'"><xsl:text>__MutableBufferSequence__</xsl:text></xsl:when>
|
||||
<!-- CLASS_DETAIL_TEMPLATE END -->
|
||||
@@ -1,6 +0,0 @@
|
||||
<!-- Variables (Edit for your project) -->
|
||||
<xsl:variable name="doc-ref" select="'docca.ref'"/>
|
||||
<xsl:variable name="doc-ns" select="'example'"/>
|
||||
<xsl:variable name="debug" select="0"/>
|
||||
<xsl:variable name="include-private-members" select="false()"/>
|
||||
<!-- End Variables -->
|
||||
@@ -1,4 +1,13 @@
|
||||
<!-- INCLUDES_FOOT_TEMPLATE BEGIN -->
|
||||
<xsl:stylesheet version="3.0"
|
||||
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
exclude-result-prefixes="xs"
|
||||
expand-text="yes">
|
||||
|
||||
<xsl:variable name="doc-ref" select="'docca.ref'"/>
|
||||
<xsl:variable name="doc-ns" select="'example'"/>
|
||||
<xsl:variable name="include-private-members" select="false()"/>
|
||||
|
||||
<xsl:template mode="includes-template-footer" match="location">
|
||||
<xsl:variable name="convenience-header" as="xs:string?">
|
||||
<xsl:apply-templates mode="convenience-header" select="@file"/>
|
||||
@@ -12,4 +21,5 @@
|
||||
|
||||
<xsl:template mode="convenience-header" match="@file[contains(., 'boost/json')]">json.hpp</xsl:template>
|
||||
<xsl:template mode="convenience-header" match="@file"/>
|
||||
<!-- INCLUDES_FOOT_TEMPLATE END -->
|
||||
|
||||
</xsl:stylesheet>
|
||||
@@ -5,7 +5,11 @@
|
||||
exclude-result-prefixes="xs d"
|
||||
expand-text="yes">
|
||||
|
||||
<!-- CONFIG_TEMPLATE -->
|
||||
<!-- Projects should override these default values using a project-specific custom-overrides.xsl module -->
|
||||
<xsl:variable name="doc-ref" select="'docca.ref'"/>
|
||||
<xsl:variable name="doc-ns" select="'example'"/>
|
||||
|
||||
<xsl:variable name="include-private-members" select="false()"/>
|
||||
|
||||
<xsl:variable name="additional-id-replacements" as="element(replace)*">
|
||||
<replace pattern="boost::asio::error" with=""/>
|
||||
@@ -20,8 +24,6 @@
|
||||
>Defined in header [include_file {substring-after(@file, 'include/')}]
|
||||
</xsl:template>
|
||||
|
||||
<!-- INCLUDES_FOOT_TEMPLATE -->
|
||||
|
||||
<xsl:function name="d:should-ignore-compound">
|
||||
<xsl:param name="element" as="element(compound)"/>
|
||||
<xsl:sequence select="contains($element/name, '::detail')"/> <!-- TODO: Confirm this should be custom and not built-in behavior -->
|
||||
236
include/docca/base-stage2.xsl
Normal file
236
include/docca/base-stage2.xsl
Normal file
@@ -0,0 +1,236 @@
|
||||
<!DOCTYPE xsl:stylesheet [
|
||||
<!ENTITY SYNTAX_BLOCK "*[ self::compound
|
||||
| self::function
|
||||
| self::typedef
|
||||
| self::enum
|
||||
| self::variable
|
||||
| self::overloaded-member
|
||||
]">
|
||||
]>
|
||||
<xsl:stylesheet version="3.0"
|
||||
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xmlns:d="http://github.com/vinniefalco/docca"
|
||||
expand-text="yes">
|
||||
|
||||
<xsl:import href="common.xsl"/>
|
||||
|
||||
<xsl:output method="text"/>
|
||||
|
||||
<xsl:include href="emphasized-types.xsl"/>
|
||||
|
||||
<xsl:param name="DEBUG" select="false()"/>
|
||||
|
||||
<xsl:variable name="list-indent-width" select="4"/>
|
||||
|
||||
<xsl:template mode="before" match="/page">
|
||||
<xsl:text>{$nl}</xsl:text>
|
||||
<xsl:text>[section:{tokenize(@id,'\.')[last()]} {d:qb-escape(title)}]</xsl:text>
|
||||
<xsl:apply-templates mode="indexterm" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="indexterm" match="page"/>
|
||||
<xsl:template mode="indexterm" match="page[@primary-index-term]"
|
||||
>{$nl}[indexterm1 {d:qb-escape(@primary-index-term)}]{$nl}</xsl:template>
|
||||
<xsl:template mode="indexterm" match="page[@secondary-index-term]" priority="1"
|
||||
>{$nl}[indexterm2 {d:qb-escape(@primary-index-term)}..{
|
||||
d:qb-escape(@secondary-index-term)}]{$nl}</xsl:template>
|
||||
|
||||
<!-- Title is already included in section header -->
|
||||
<xsl:template match="/page/title"/>
|
||||
|
||||
<xsl:template match="heading">{$nl}[heading {.}]</xsl:template>
|
||||
|
||||
<xsl:template match="location">
|
||||
<xsl:apply-templates mode="includes-template" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="footer/location">
|
||||
<xsl:apply-templates mode="includes-template-footer" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="&SYNTAX_BLOCK;">{$nl}```{$nl}</xsl:template>
|
||||
<xsl:template mode="after" match="&SYNTAX_BLOCK;">{$nl}```{$nl}</xsl:template>
|
||||
|
||||
<!-- Merge adjacent overloaded-members into one syntax block, separated by one blank line -->
|
||||
<xsl:template mode="after" match="overloaded-member[following-sibling::*[1]/self::overloaded-member]" priority="1"/>
|
||||
<xsl:template mode="before" match="overloaded-member[preceding-sibling::*[1]/self::overloaded-member]" priority="1"
|
||||
>{$nl}{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="overloaded-member/type[normalize-space(.)]
|
||||
| function/type[normalize-space(.)]">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="function">;</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="overloaded-member">
|
||||
<xsl:text>;{$nl}</xsl:text>
|
||||
<xsl:variable name="more-link" as="element()">
|
||||
<emphasis>'''&raquo;''' <ref d:refid="{ref/@d:refid}">more...</ref></emphasis>
|
||||
</xsl:variable>
|
||||
<xsl:text> ``</xsl:text>
|
||||
<xsl:apply-templates select="$more-link"/>
|
||||
<xsl:text>``</xsl:text>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template priority="1"
|
||||
match="&SYNTAX_BLOCK;//ref">``[link {$doc-ref}.{@d:refid} {d:qb-escape(.)}]``</xsl:template>
|
||||
<xsl:template match="td[1]//ref" >[link {$doc-ref}.{@d:refid} {d:qb-escape(.)}]</xsl:template>
|
||||
<xsl:template match="ref" >[link {$doc-ref}.{@d:refid} `{d:qb-escape(.)}`]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="computeroutput[not(ref)] | code">`</xsl:template>
|
||||
<xsl:template mode="after" match="computeroutput[not(ref)] | code">`</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="enum/name">enum </xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="typedef/name">using </xsl:template>
|
||||
<xsl:template mode="after" match="typedef/name"> = </xsl:template>
|
||||
<xsl:template mode="after" match="typedef/type">;</xsl:template>
|
||||
|
||||
<xsl:template match="type[. eq '__implementation_defined__' ]">``['implementation-defined]``</xsl:template>
|
||||
<xsl:template match="type[. eq '__see_below__' ]">``['see-below]``</xsl:template>
|
||||
<xsl:template match="type[. = ('__deduced__','void_or_deduced')]">``__deduced__``</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="variable/name | variable/initializer">{' '}</xsl:template>
|
||||
<xsl:template mode="append" match="variable">;</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="compound/kind">{' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="base[1]"> :{$nl} </xsl:template>
|
||||
<xsl:template mode="before" match="base" >{$nl} </xsl:template>
|
||||
<xsl:template mode="after" match="base[position() ne last()]">,</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="base/prot">{' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="templateparamlist">template<</xsl:template>
|
||||
<xsl:template mode="after" match="templateparamlist">>{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="param">{$nl} </xsl:template>
|
||||
<xsl:template mode="after" match="param[position() ne last()]">,</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="param[declname]/type">{' '}</xsl:template>
|
||||
|
||||
|
||||
<xsl:template mode="before" match="params">(</xsl:template>
|
||||
<xsl:template mode="after" match="params">)</xsl:template>
|
||||
|
||||
<xsl:template match="templateparamlist/param/declname[. = $emphasized-template-parameter-types]"
|
||||
>__{translate(.,'_','')}__</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="defval"> = </xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="modifier[. eq 'const']">{' '}</xsl:template>
|
||||
<xsl:template mode="after" match="modifier[. eq 'const']"/>
|
||||
|
||||
<xsl:template mode="after" match="modifier">{$nl}</xsl:template>
|
||||
|
||||
|
||||
<xsl:template mode="#all" match="ERROR">[role red error.{@message}]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="table">{$nl}[table </xsl:template>
|
||||
<xsl:template mode="after" match="table">{$nl}]</xsl:template>
|
||||
|
||||
<!-- ASSUMPTION: table rows have either <th> or <td>, not both -->
|
||||
<xsl:template mode="before" match="tr[th] | th">[</xsl:template>
|
||||
<xsl:template mode="after" match="tr[th] | th">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="tr">{$nl} [</xsl:template>
|
||||
<xsl:template mode="after" match="tr">{$nl} ]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="td">{$nl} [</xsl:template>
|
||||
<xsl:template mode="after" match="td">{$nl} ]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="bold">[*</xsl:template>
|
||||
<xsl:template mode="after" match="bold">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="emphasis">['</xsl:template>
|
||||
<xsl:template mode="after" match="emphasis">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="role">[role {@class} </xsl:template>
|
||||
<xsl:template mode="after" match="role">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="ulink">[@{@url} </xsl:template>
|
||||
<xsl:template mode="after" match="ulink">]</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="itemizedlist | orderedlist">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="listitem">
|
||||
<xsl:text>{$nl}</xsl:text>
|
||||
<xsl:apply-templates mode="list-item-indent" select="."/>
|
||||
<xsl:apply-templates mode="list-item-label" select=".."/>
|
||||
<xsl:text> </xsl:text>
|
||||
<!-- ASSUMPTION: <para> always appears as a child of list items -->
|
||||
<xsl:apply-templates select="para/node()"/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- TODO: verify this works as expected (find an example of a nested list) -->
|
||||
<xsl:template mode="list-item-indent"
|
||||
match="listitem">{ancestor::listitem ! (1 to $list-indent-width) ! ' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="list-item-label" match="itemizedlist">*</xsl:template>
|
||||
<xsl:template mode="list-item-label" match="orderedlist" >#</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="/page/div[1]">
|
||||
<xsl:if test="$DEBUG">
|
||||
<xsl:text>['</xsl:text>
|
||||
<xsl:text>[role red \[Page type: [*{/*/@type}]\]] </xsl:text>
|
||||
<xsl:text>[role green \[[@../../doc/html/{translate($doc-ref,'.','/')}/{
|
||||
translate(/page/@id,'.','/')}.html [role green doc_build_html]]\]] </xsl:text>
|
||||
<xsl:text>[@../build/xml-pages/{/page/@id}.xml [role blue [*\[doxygen_page_xml\]]]]</xsl:text>
|
||||
<xsl:text>[@../build/stage1_visualized/visualized/{/page/@id}.html [role magenta ---stage1_visualized-->]]</xsl:text>
|
||||
<xsl:text>[@../build/stage1_visualized/results/{ /page/@id}.xml [role blue [*\[docca_page_xml\]]]]</xsl:text>
|
||||
<xsl:text>[@../build/stage2_visualized/visualized/{/page/@id}.html [role magenta ---stage2_visualized-->]]</xsl:text>
|
||||
<xsl:text>[@../build/stage2_visualized/results/{ /page/@id}.txt [role blue [*\[quickbook_result\]]]]</xsl:text>
|
||||
<xsl:text>]</xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="para | div">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="sp">{' '}</xsl:template>
|
||||
|
||||
<xsl:template match="linebreak">{$nl}{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="br">[br]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="programlisting">{$nl}```{$nl}</xsl:template>
|
||||
<xsl:template mode="after" match="programlisting" >```{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="codeline">{$nl}</xsl:template>
|
||||
|
||||
<!-- Ignore whitespace-only text nodes -->
|
||||
<xsl:template match="text()[not(normalize-space())]"/>
|
||||
|
||||
<xsl:template match="text()">
|
||||
<xsl:sequence select="d:qb-escape(.)"/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- Boilerplate default rules for elements -->
|
||||
<!-- Convention of this stylesheet is to favor use of just "before" and "after"
|
||||
and to utilize "append" (and maybe "insert") only when a distinction is needed -->
|
||||
<xsl:template match="*" priority="10">
|
||||
<xsl:apply-templates mode="before" select="."/>
|
||||
<!-- enable if needed/desired
|
||||
<xsl:apply-templates mode="insert" select="."/> -->
|
||||
<xsl:next-match/>
|
||||
<xsl:apply-templates mode="append" select="."/>
|
||||
<xsl:apply-templates mode="after" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- Default before/after/insert/append rules are to do nothing -->
|
||||
<xsl:template mode="before" match="*"/>
|
||||
<!-- enable if needed/desired
|
||||
<xsl:template mode="insert" match="*"/> -->
|
||||
<xsl:template mode="append" match="*"/>
|
||||
<xsl:template mode="after" match="*"/>
|
||||
|
||||
|
||||
<xsl:function name="d:qb-escape">
|
||||
<xsl:param name="string"/>
|
||||
<xsl:sequence select="replace(
|
||||
replace($string, '\[', '\\['),
|
||||
'\]',
|
||||
'\\]'
|
||||
)"/>
|
||||
</xsl:function>
|
||||
|
||||
</xsl:stylesheet>
|
||||
@@ -5,8 +5,9 @@
|
||||
exclude-result-prefixes="xs d">
|
||||
|
||||
<xsl:import href="base-extract-xml-pages.xsl"/>
|
||||
<xsl:import href="base-config.xsl"/>
|
||||
|
||||
<!-- TODO: consider refactoring to stage-specific configurations -->
|
||||
<xsl:include href="config.xsl"/>
|
||||
<!-- Custom config module copied from project-specific directory -->
|
||||
<xsl:include href="custom-overrides.xsl"/>
|
||||
|
||||
</xsl:stylesheet>
|
||||
|
||||
@@ -5,7 +5,9 @@
|
||||
expand-text="yes">
|
||||
|
||||
<xsl:import href="base-stage1.xsl"/>
|
||||
<xsl:import href="base-config.xsl"/>
|
||||
|
||||
<xsl:include href="config.xsl"/>
|
||||
<!-- Custom config module copied from project-specific directory -->
|
||||
<xsl:include href="custom-overrides.xsl"/>
|
||||
|
||||
</xsl:stylesheet>
|
||||
|
||||
@@ -1,237 +1,12 @@
|
||||
<!DOCTYPE xsl:stylesheet [
|
||||
<!ENTITY SYNTAX_BLOCK "*[ self::compound
|
||||
| self::function
|
||||
| self::typedef
|
||||
| self::enum
|
||||
| self::variable
|
||||
| self::overloaded-member
|
||||
]">
|
||||
]>
|
||||
<xsl:stylesheet version="3.0"
|
||||
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xmlns:d="http://github.com/vinniefalco/docca"
|
||||
expand-text="yes">
|
||||
exclude-result-prefixes="xs">
|
||||
|
||||
<xsl:output method="text"/>
|
||||
<xsl:import href="base-stage2.xsl"/>
|
||||
<xsl:import href="base-config.xsl"/>
|
||||
|
||||
<xsl:import href="common.xsl"/>
|
||||
|
||||
<xsl:include href="config.xsl"/>
|
||||
<xsl:include href="emphasized-types.xsl"/>
|
||||
|
||||
<xsl:param name="DEBUG" select="false()"/>
|
||||
|
||||
<xsl:variable name="list-indent-width" select="4"/>
|
||||
|
||||
<xsl:template mode="before" match="/page">
|
||||
<xsl:text>{$nl}</xsl:text>
|
||||
<xsl:text>[section:{tokenize(@id,'\.')[last()]} {d:qb-escape(title)}]</xsl:text>
|
||||
<xsl:apply-templates mode="indexterm" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="indexterm" match="page"/>
|
||||
<xsl:template mode="indexterm" match="page[@primary-index-term]"
|
||||
>{$nl}[indexterm1 {d:qb-escape(@primary-index-term)}]{$nl}</xsl:template>
|
||||
<xsl:template mode="indexterm" match="page[@secondary-index-term]" priority="1"
|
||||
>{$nl}[indexterm2 {d:qb-escape(@primary-index-term)}..{
|
||||
d:qb-escape(@secondary-index-term)}]{$nl}</xsl:template>
|
||||
|
||||
<!-- Title is already included in section header -->
|
||||
<xsl:template match="/page/title"/>
|
||||
|
||||
<xsl:template match="heading">{$nl}[heading {.}]</xsl:template>
|
||||
|
||||
<xsl:template match="location">
|
||||
<xsl:apply-templates mode="includes-template" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template match="footer/location">
|
||||
<xsl:apply-templates mode="includes-template-footer" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="&SYNTAX_BLOCK;">{$nl}```{$nl}</xsl:template>
|
||||
<xsl:template mode="after" match="&SYNTAX_BLOCK;">{$nl}```{$nl}</xsl:template>
|
||||
|
||||
<!-- Merge adjacent overloaded-members into one syntax block, separated by one blank line -->
|
||||
<xsl:template mode="after" match="overloaded-member[following-sibling::*[1]/self::overloaded-member]" priority="1"/>
|
||||
<xsl:template mode="before" match="overloaded-member[preceding-sibling::*[1]/self::overloaded-member]" priority="1"
|
||||
>{$nl}{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="overloaded-member/type[normalize-space(.)]
|
||||
| function/type[normalize-space(.)]">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="function">;</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="overloaded-member">
|
||||
<xsl:text>;{$nl}</xsl:text>
|
||||
<xsl:variable name="more-link" as="element()">
|
||||
<emphasis>'''&raquo;''' <ref d:refid="{ref/@d:refid}">more...</ref></emphasis>
|
||||
</xsl:variable>
|
||||
<xsl:text> ``</xsl:text>
|
||||
<xsl:apply-templates select="$more-link"/>
|
||||
<xsl:text>``</xsl:text>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template priority="1"
|
||||
match="&SYNTAX_BLOCK;//ref">``[link {$doc-ref}.{@d:refid} {d:qb-escape(.)}]``</xsl:template>
|
||||
<xsl:template match="td[1]//ref" >[link {$doc-ref}.{@d:refid} {d:qb-escape(.)}]</xsl:template>
|
||||
<xsl:template match="ref" >[link {$doc-ref}.{@d:refid} `{d:qb-escape(.)}`]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="computeroutput[not(ref)] | code">`</xsl:template>
|
||||
<xsl:template mode="after" match="computeroutput[not(ref)] | code">`</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="enum/name">enum </xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="typedef/name">using </xsl:template>
|
||||
<xsl:template mode="after" match="typedef/name"> = </xsl:template>
|
||||
<xsl:template mode="after" match="typedef/type">;</xsl:template>
|
||||
|
||||
<xsl:template match="type[. eq '__implementation_defined__' ]">``['implementation-defined]``</xsl:template>
|
||||
<xsl:template match="type[. eq '__see_below__' ]">``['see-below]``</xsl:template>
|
||||
<xsl:template match="type[. = ('__deduced__','void_or_deduced')]">``__deduced__``</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="variable/name | variable/initializer">{' '}</xsl:template>
|
||||
<xsl:template mode="append" match="variable">;</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="compound/kind">{' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="base[1]"> :{$nl} </xsl:template>
|
||||
<xsl:template mode="before" match="base" >{$nl} </xsl:template>
|
||||
<xsl:template mode="after" match="base[position() ne last()]">,</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="base/prot">{' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="templateparamlist">template<</xsl:template>
|
||||
<xsl:template mode="after" match="templateparamlist">>{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="param">{$nl} </xsl:template>
|
||||
<xsl:template mode="after" match="param[position() ne last()]">,</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="param[declname]/type">{' '}</xsl:template>
|
||||
|
||||
|
||||
<xsl:template mode="before" match="params">(</xsl:template>
|
||||
<xsl:template mode="after" match="params">)</xsl:template>
|
||||
|
||||
<xsl:template match="templateparamlist/param/declname[. = $emphasized-template-parameter-types]"
|
||||
>__{translate(.,'_','')}__</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="defval"> = </xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="modifier[. eq 'const']">{' '}</xsl:template>
|
||||
<xsl:template mode="after" match="modifier[. eq 'const']"/>
|
||||
|
||||
<xsl:template mode="after" match="modifier">{$nl}</xsl:template>
|
||||
|
||||
|
||||
<xsl:template mode="#all" match="ERROR">[role red error.{@message}]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="table">{$nl}[table </xsl:template>
|
||||
<xsl:template mode="after" match="table">{$nl}]</xsl:template>
|
||||
|
||||
<!-- ASSUMPTION: table rows have either <th> or <td>, not both -->
|
||||
<xsl:template mode="before" match="tr[th] | th">[</xsl:template>
|
||||
<xsl:template mode="after" match="tr[th] | th">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="tr">{$nl} [</xsl:template>
|
||||
<xsl:template mode="after" match="tr">{$nl} ]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="td">{$nl} [</xsl:template>
|
||||
<xsl:template mode="after" match="td">{$nl} ]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="bold">[*</xsl:template>
|
||||
<xsl:template mode="after" match="bold">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="emphasis">['</xsl:template>
|
||||
<xsl:template mode="after" match="emphasis">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="role">[role {@class} </xsl:template>
|
||||
<xsl:template mode="after" match="role">]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="ulink">[@{@url} </xsl:template>
|
||||
<xsl:template mode="after" match="ulink">]</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="itemizedlist | orderedlist">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="listitem">
|
||||
<xsl:text>{$nl}</xsl:text>
|
||||
<xsl:apply-templates mode="list-item-indent" select="."/>
|
||||
<xsl:apply-templates mode="list-item-label" select=".."/>
|
||||
<xsl:text> </xsl:text>
|
||||
<!-- ASSUMPTION: <para> always appears as a child of list items -->
|
||||
<xsl:apply-templates select="para/node()"/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- TODO: verify this works as expected (find an example of a nested list) -->
|
||||
<xsl:template mode="list-item-indent"
|
||||
match="listitem">{ancestor::listitem ! (1 to $list-indent-width) ! ' '}</xsl:template>
|
||||
|
||||
<xsl:template mode="list-item-label" match="itemizedlist">*</xsl:template>
|
||||
<xsl:template mode="list-item-label" match="orderedlist" >#</xsl:template>
|
||||
|
||||
<xsl:template mode="append" match="/page/div[1]">
|
||||
<xsl:if test="$DEBUG">
|
||||
<xsl:text>['</xsl:text>
|
||||
<xsl:text>[role red \[Page type: [*{/*/@type}]\]] </xsl:text>
|
||||
<xsl:text>[role green \[[@../../doc/html/{translate($doc-ref,'.','/')}/{
|
||||
translate(/page/@id,'.','/')}.html [role green doc_build_html]]\]] </xsl:text>
|
||||
<xsl:text>[@../build/xml-pages/{/page/@id}.xml [role blue [*\[doxygen_page_xml\]]]]</xsl:text>
|
||||
<xsl:text>[@../build/stage1_visualized/visualized/{/page/@id}.html [role magenta ---stage1_visualized-->]]</xsl:text>
|
||||
<xsl:text>[@../build/stage1_visualized/results/{ /page/@id}.xml [role blue [*\[docca_page_xml\]]]]</xsl:text>
|
||||
<xsl:text>[@../build/stage2_visualized/visualized/{/page/@id}.html [role magenta ---stage2_visualized-->]]</xsl:text>
|
||||
<xsl:text>[@../build/stage2_visualized/results/{ /page/@id}.txt [role blue [*\[quickbook_result\]]]]</xsl:text>
|
||||
<xsl:text>]</xsl:text>
|
||||
</xsl:if>
|
||||
</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="para | div">{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="sp">{' '}</xsl:template>
|
||||
|
||||
<xsl:template match="linebreak">{$nl}{$nl}</xsl:template>
|
||||
|
||||
<xsl:template match="br">[br]</xsl:template>
|
||||
|
||||
<xsl:template mode="before" match="programlisting">{$nl}```{$nl}</xsl:template>
|
||||
<xsl:template mode="after" match="programlisting" >```{$nl}</xsl:template>
|
||||
|
||||
<xsl:template mode="after" match="codeline">{$nl}</xsl:template>
|
||||
|
||||
<!-- Ignore whitespace-only text nodes -->
|
||||
<xsl:template match="text()[not(normalize-space())]"/>
|
||||
|
||||
<xsl:template match="text()">
|
||||
<xsl:sequence select="d:qb-escape(.)"/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- Boilerplate default rules for elements -->
|
||||
<!-- Convention of this stylesheet is to favor use of just "before" and "after"
|
||||
and to utilize "append" (and maybe "insert") only when a distinction is needed -->
|
||||
<xsl:template match="*" priority="10">
|
||||
<xsl:apply-templates mode="before" select="."/>
|
||||
<!-- enable if needed/desired
|
||||
<xsl:apply-templates mode="insert" select="."/> -->
|
||||
<xsl:next-match/>
|
||||
<xsl:apply-templates mode="append" select="."/>
|
||||
<xsl:apply-templates mode="after" select="."/>
|
||||
</xsl:template>
|
||||
|
||||
<!-- Default before/after/insert/append rules are to do nothing -->
|
||||
<xsl:template mode="before" match="*"/>
|
||||
<!-- enable if needed/desired
|
||||
<xsl:template mode="insert" match="*"/> -->
|
||||
<xsl:template mode="append" match="*"/>
|
||||
<xsl:template mode="after" match="*"/>
|
||||
|
||||
|
||||
<xsl:function name="d:qb-escape">
|
||||
<xsl:param name="string"/>
|
||||
<xsl:sequence select="replace(
|
||||
replace($string, '\[', '\\['),
|
||||
'\]',
|
||||
'\\]'
|
||||
)"/>
|
||||
</xsl:function>
|
||||
<!-- Custom config module copied from project-specific directory -->
|
||||
<xsl:include href="custom-overrides.xsl"/>
|
||||
|
||||
</xsl:stylesheet>
|
||||
|
||||
Reference in New Issue
Block a user