summaryrefslogtreecommitdiff
path: root/lib/lufa/LUFA/StudioIntegration/Docbook
diff options
context:
space:
mode:
authorJack Humbert <jack.humb@gmail.com>2017-07-07 11:55:23 -0400
committerJack Humbert <jack.humb@gmail.com>2017-07-07 11:55:23 -0400
commit8655d4f4948b2deef7844503c8d690f23ac1a062 (patch)
treeb2c6effc9d6cd5b5b43933a1e53b8bf17e9e82cf /lib/lufa/LUFA/StudioIntegration/Docbook
parent1896c76a2928c96f9ab7947bec2ef8dd37623cff (diff)
parent60b30c036397cb5627fa374bb930794b225daa29 (diff)
Merge commit '60b30c036397cb5627fa374bb930794b225daa29' as 'lib/lufa'
Diffstat (limited to 'lib/lufa/LUFA/StudioIntegration/Docbook')
-rw-r--r--lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/README.txt13
-rw-r--r--lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/docbook.xsl58
-rw-r--r--lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/hv1-common.xsl664
-rw-r--r--lib/lufa/LUFA/StudioIntegration/Docbook/placeholder.txt1
4 files changed, 736 insertions, 0 deletions
diff --git a/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/README.txt b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/README.txt
new file mode 100644
index 0000000000..4f251cc0b8
--- /dev/null
+++ b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/README.txt
@@ -0,0 +1,13 @@
+This is a modified/updated version of the Microsoft HV1 Docbook transform, written by Morten Engelhardt Olsen,
+
+Originally posted at http://sourceforge.net/p/docbook/feature-requests/461/, this has been further updated by Morten to make it compatible with more recent DocBook versions.
+
+ ---------------------------
+/ This documentation system \
+\ is udderly ridiculous! /
+ ---------------------------
+ \ ^__^
+ \ (oo)\_______
+ (__)\ )\/\
+ ||----w |
+ || ||
diff --git a/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/docbook.xsl b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/docbook.xsl
new file mode 100644
index 0000000000..03b81feafc
--- /dev/null
+++ b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/docbook.xsl
@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:d="http://docbook.org/ns/docbook"
+ xmlns="http://www.w3.org/1999/xhtml"
+ exclude-result-prefixes="xsl d"
+ version="1.0">
+
+ <xsl:import href="../xhtml/chunk.xsl"/>
+ <xsl:import href="../xhtml/highlight.xsl"/>
+
+ <!--
+ Based on the normal xhtml templates, all overrides applicable to
+ xhtml is applicable to HV1.
+ -->
+
+ <xsl:import href="hv1-common.xsl"/>
+
+ <!--
+ Choose if links should be generated using ms-xhelp (default) or
+ the more verbose ms.help type. The latter requires product.name,
+ product.version and product.locale to be set
+ -->
+ <xsl:param name="use.mshelp.links" select="0"/>
+
+ <!--
+ Name of target product. If specified then each page is
+ marked with this product. This is usualy set during
+ install time.
+ -->
+ <xsl:param name="product.name" select="''" />
+
+ <!--
+ Name of target version. If specified then each page is
+ marked with this version. This is usualy set during
+ install time.
+ -->
+ <xsl:param name="product.version" select="''" />
+
+ <!--
+ Locale for the help. Should always be set
+ -->
+ <xsl:param name="product.locale" select="'en-US'" />
+
+ <!--
+ Self branding. Gives access for chunks to load
+ it's own branding package during runtime
+ -->
+ <xsl:param name="topic.selfbrand" select="1"/>
+
+
+ <!-- Use doctitle for olinks -->
+ <xsl:param name="olink.doctitle" select="'yes'" />
+
+ <!-- Enable source code highlighting-->
+ <xsl:param name="highlight.source" select="1"/>
+
+</xsl:stylesheet>
diff --git a/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/hv1-common.xsl b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/hv1-common.xsl
new file mode 100644
index 0000000000..b6f2610680
--- /dev/null
+++ b/lib/lufa/LUFA/StudioIntegration/Docbook/mshelp/hv1-common.xsl
@@ -0,0 +1,664 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:d="http://docbook.org/ns/docbook"
+ xmlns="http://www.w3.org/1999/xhtml"
+ exclude-result-prefixes="d"
+ version="1.0">
+
+
+ <!-- no separate HTML page with index as this is binary in hv1 -->
+ <xsl:param name="generate.index" select="0"/>
+
+
+ <!-- Generate help tags in header -->
+ <xsl:template name="user.head.content">
+ <xsl:param name="node" select="''" />
+ <xsl:variable name="up" select="parent::*"/>
+
+ <!-- Locale should be first Help tag-->
+ <meta name="Microsoft.Help.Locale">
+ <xsl:attribute name="content">
+ <xsl:choose>
+ <xsl:when test="$product.locale and product.locale != ''">
+ <xsl:value-of select="$product.locale"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>en-US</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ </meta>
+
+ <!-- Specify locale for this chunk. Should probably query xml:lang -->
+ <meta name="Microsoft.Help.TopicLocale">
+ <xsl:attribute name="content">
+ <xsl:choose>
+ <xsl:when test="@xml:lang">
+ <xsl:value-of select="@xml:lang"/>
+ </xsl:when>
+ <xsl:when test="$product.locale and product.locale != ''">
+ <xsl:value-of select="$product.locale"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>en-US</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ </meta>
+
+ <!-- This is the unique ID for this page -->
+ <meta name="Microsoft.Help.Id">
+ <xsl:attribute name="content">
+ <xsl:call-template name="hv1.toc.id"/>
+ </xsl:attribute>
+ </meta>
+
+ <!-- The ID of the parent TOC node (-1 is root) -->
+ <meta name="Microsoft.Help.TocParent">
+ <xsl:attribute name="content">
+ <xsl:call-template name="hv1.toc.parent.id">
+ <xsl:with-param name="up" select="$up"/>
+ </xsl:call-template>
+ </xsl:attribute>
+ </meta>
+
+ <!-- For all pages with the same parent, the order is set by TocOrder -->
+ <meta name="Microsoft.Help.TocOrder">
+ <xsl:attribute name="content">
+ <xsl:value-of select="1+count(preceding-sibling::chapter|preceding-sibling::section)"/>
+ </xsl:attribute>
+ </meta>
+
+ <!-- boolean to indicate if this page is allowed to load custom branding -->
+ <meta name="Microsoft.Help.SelfBranded">
+ <xsl:attribute name="content">
+ <xsl:choose>
+ <xsl:when test="$topic.selfbrand">
+ <xsl:text>true</xsl:text>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>false</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ </meta>
+
+ <!--
+ Insert description meta element. This is shown in searches and indexes
+ -->
+
+ <xsl:variable name="description">
+ <xsl:call-template name="hv1.description"/>
+ </xsl:variable>
+ <xsl:if test="$description != ''">
+ <meta name="Description">
+ <xsl:attribute name="content">
+ <xsl:call-template name="hv1.description"/>
+ </xsl:attribute>
+ </meta>
+ </xsl:if>
+
+ <!-- Display version of page -->
+ <xsl:variable name="display.version">
+ <xsl:call-template name="hv1.display.version"/>
+ </xsl:variable>
+ <xsl:if test="$display.version != ''">
+ <meta name="Microsoft.Help.DisplayVersion">
+ <xsl:attribute name="content">
+ <xsl:value-of select="$display.version"/>
+ </xsl:attribute>
+ </meta>
+ </xsl:if>
+
+ <!--
+ Content type is used to distinguish between multiple topics with same id.
+ Usualy to have multiple versions available
+ -->
+ <!--
+ <meta name="Microsoft.Help.ContentType">
+ <xsl:attribute name="content">
+ TODO: implement
+ </xsl:attribute>
+ </meta>
+ -->
+
+
+ <!-- If a product name is given, then mark each header with this name-->
+ <xsl:if test="$product.name and $product.name != ''">
+ <meta name="Microsoft.Help.Product">
+ <xsl:attribute name="content">
+ <xsl:value-of select="$product.name"/>
+ </xsl:attribute>
+ </meta>
+ </xsl:if>
+
+ <!-- If a version is given, then mark each header with version-->
+ <xsl:if test="$product.version and $product.version != ''">
+ <meta name="Microsoft.Help.ProductVersion">
+ <xsl:attribute name="content">
+ <xsl:value-of select="$product.version"/>
+ </xsl:attribute>
+ </meta>
+ </xsl:if>
+
+ <!--
+ Insert all keywords for this chunk. These are used
+ by the help runtime to generate indexes and refine search
+ -->
+ <xsl:call-template name="hv1.keywords" />
+
+ <!--
+ Insert all F1 ids for this chunk. This is used
+ by the help runtime to resolve F1 queries
+ -->
+ <xsl:call-template name="hv1.f1" />
+ </xsl:template>
+
+
+ <!-- There are links from ToC pane to bibliodivs, so there must be anchor -->
+ <xsl:template match="bibliodiv/title">
+ <h3 class="{name(.)}">
+ <xsl:call-template name="anchor">
+ <xsl:with-param name="node" select=".."/>
+ <xsl:with-param name="conditional" select="0"/>
+ </xsl:call-template>
+ <xsl:apply-templates/>
+ </h3>
+ </xsl:template>
+
+ <!--
+ Template to get a page id.
+
+ Needs to be unique in the target help system; microsoft uses UUIDs for this.
+ To avoid UUIDs and generate-id (only unique in current xml fragment),
+ we do
+ <root.filename> +
+ <last ancestor title> +
+ <second last ancestor title> +
+ ....
+ <self title>, where different types of sections/fragments
+ may be prefixed with a type identifier.
+
+ This should generate a fairly specific/unique ID.
+ -->
+ <xsl:template name="get.id.from.pagename">
+ <xsl:param name="target" />
+ <xsl:value-of select="$root.filename"/>
+ <xsl:variable name="id.of.document">
+ <xsl:apply-templates select="$target" mode="recursive-chunk-id"/>
+ </xsl:variable>
+ <xsl:variable name="titleWithSpace">
+ <xsl:value-of select="key('id',$id.of.document)/title"/>
+ </xsl:variable>
+ <xsl:value-of select="translate($id.of.document,' ','')" />
+ </xsl:template>
+
+ <!-- template that returns the page id used above -->
+ <xsl:template match="*" mode="recursive-chunk-id">
+ <xsl:param name="recursive" select="false()"/>
+
+ <!-- returns the filename of a chunk -->
+ <xsl:variable name="ischunk">
+ <xsl:call-template name="chunk"/>
+ </xsl:variable>
+
+ <xsl:variable name="dbhtml-filename">
+ <xsl:call-template name="pi.dbhtml_filename"/>
+ </xsl:variable>
+
+ <xsl:variable name="filename">
+ <xsl:choose>
+ <xsl:when test="$dbhtml-filename != ''">
+ <xsl:value-of select="$dbhtml-filename"/>
+ </xsl:when>
+ <!-- if this is the root element, use the root.filename -->
+ <xsl:when test="not(parent::*) and $root.filename != ''">
+ <xsl:value-of select="$root.filename"/>
+ <!-- <xsl:value-of select="$html.ext"/> -->
+ </xsl:when>
+ <!-- Special case -->
+ <xsl:when test="self::legalnotice and not($generate.legalnotice.link = 0)">
+ <xsl:choose>
+ <xsl:when test="(@id or @xml:id) and not($use.id.as.filename = 0)">
+ <!-- * if this legalnotice has an ID, then go ahead and use -->
+ <!-- * just the value of that ID as the basename for the file -->
+ <!-- * (that is, without prepending an "ln-" too it) -->
+ <xsl:value-of select="(@id|@xml:id)[1]"/>
+ <!-- <xsl:value-of select="$html.ext"/>-->
+ </xsl:when>
+ <xsl:otherwise>
+ <!-- * otherwise, if this legalnotice does not have an ID, -->
+ <!-- * then we generate an ID... -->
+ <xsl:variable name="id">
+ <xsl:call-template name="object.id"/>
+ </xsl:variable>
+ <!-- * ...and then we take that generated ID, prepend an -->
+ <!-- * "ln-" to it, and use that as the basename for the file -->
+ <!-- <xsl:value-of select="concat('ln-',$id,$html.ext)"/>-->
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:when>
+ <!-- if there's no dbhtml filename, and if we're to use IDs as -->
+ <!-- filenames, then use the ID to generate the filename. -->
+ <xsl:when test="(@id or @xml:id) and $use.id.as.filename != 0">
+ <xsl:value-of select="(@id|@xml:id)[1]"/>
+ <!-- <xsl:value-of select="$html.ext"/>-->
+ </xsl:when>
+ <xsl:otherwise/>
+ </xsl:choose>
+ </xsl:variable>
+
+ <xsl:choose>
+ <xsl:when test="$ischunk='0'">
+ <!-- if called on something that isn't a chunk, walk up... -->
+ <xsl:choose>
+ <xsl:when test="count(parent::*)&gt;0">
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="$recursive"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <!-- unless there is no up, in which case return "" -->
+ <xsl:otherwise/>
+ </xsl:choose>
+ </xsl:when>
+
+ <xsl:when test="not($recursive) and $filename != ''">
+ <!-- if this chunk has an explicit name, use it -->
+ <xsl:value-of select="$filename"/>
+ </xsl:when>
+
+ <xsl:when test="self::set">
+ <xsl:value-of select="$root.filename"/>
+ </xsl:when>
+
+ <xsl:when test="self::book">
+ <xsl:text>bk</xsl:text>
+ <xsl:number level="any" format="01"/>
+ </xsl:when>
+
+ <xsl:when test="self::article">
+ <xsl:if test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:if>
+
+ <xsl:text>ar</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::preface">
+ <xsl:if test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:if>
+
+ <xsl:text>pr</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::chapter">
+ <xsl:if test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:if>
+
+ <xsl:text>ch</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::appendix">
+ <xsl:if test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:if>
+
+ <xsl:text>ap</xsl:text>
+ <xsl:number level="any" format="a" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::part">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>pt</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::reference">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>rn</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::refentry">
+ <xsl:choose>
+ <xsl:when test="parent::reference">
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>re</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::colophon">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>co</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::sect1
+ or self::sect2
+ or self::sect3
+ or self::sect4
+ or self::sect5
+ or self::section">
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ <xsl:text>s</xsl:text>
+ <xsl:number format="01"/>
+ </xsl:when>
+
+ <xsl:when test="self::bibliography">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>bi</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::glossary">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>go</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::index">
+ <xsl:choose>
+ <xsl:when test="/set">
+ <!-- in a set, make sure we inherit the right book info... -->
+ <xsl:apply-templates mode="recursive-chunk-id" select="parent::*">
+ <xsl:with-param name="recursive" select="true()"/>
+ </xsl:apply-templates>
+ </xsl:when>
+ <xsl:otherwise>
+ </xsl:otherwise>
+ </xsl:choose>
+
+ <xsl:text>ix</xsl:text>
+ <xsl:number level="any" format="01" from="book"/>
+ </xsl:when>
+
+ <xsl:when test="self::setindex">
+ <xsl:text>si</xsl:text>
+ <xsl:number level="any" format="01" from="set"/>
+ </xsl:when>
+
+ <xsl:otherwise>
+ <xsl:text>chunk-filename-error-</xsl:text>
+ <xsl:value-of select="name(.)"/>
+ <xsl:number level="any" format="01" from="set"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:template>
+
+ <!-- Main template that generates internal links -->
+ <xsl:template name="href.target">
+ <xsl:param name="context" select="."/>
+ <xsl:param name="object" select="."/>
+ <xsl:param name="toc-context" select="."/>
+
+ <xsl:variable name="id">
+ <xsl:call-template name="get.id.from.pagename">
+ <xsl:with-param name="target" select="$object"/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:variable name="href">
+ <xsl:choose>
+ <xsl:when test="$use.mshelp.links">
+ <!-- Generate a ms.help type link-->
+ <xsl:if test="$product.name = ''">
+ <xsl:message terminate="yes">
+ $product.name needs to be set to generate ms.help style links
+ </xsl:message>
+ </xsl:if>
+ <xsl:if test="$product.version = ''">
+ <xsl:message terminate="yes">
+ $product.version needs to be set to generate ms.help style links
+ </xsl:message>
+ </xsl:if>
+ <xsl:if test="$product.locale = ''">
+ <xsl:message terminate="yes">
+ $product.locale needs to be set to generate ms.help style links
+ </xsl:message>
+ </xsl:if>
+
+ <xsl:text>ms.help?method=page&amp;id=</xsl:text>
+ <xsl:value-of select="$id"/>
+ <xsl:text>&amp;product=</xsl:text>
+ <xsl:value-of select="$product.name"/>
+ <xsl:text>&amp;productVersion=</xsl:text>
+ <xsl:value-of select="$product.version"/>
+ <xsl:text>&amp;locale=</xsl:text>
+ <xsl:value-of select="$product.locale"/>
+ <!-- Append the jump id if the current object has an id-->
+ <xsl:if test="$object[@id or @xml:id]">
+ <xsl:text>#</xsl:text>
+ <xsl:value-of select="$object/@id|$object/@xml:id"/>
+ </xsl:if>
+ </xsl:when>
+ <xsl:otherwise>
+ <!-- Generate ms-xhelp type links. Default-->
+ <xsl:text>ms-xhelp:///?Id=</xsl:text>
+ <xsl:value-of select="$id"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:value-of select="$href"/>
+ </xsl:template>
+
+ <xsl:template match="*" mode="common.html.attributes">
+ <xsl:param name="class" select="local-name(.)"/>
+ <xsl:param name="inherit" select="0"/>
+
+ <!--
+ Workaround for known issue with HelpLibAgent
+ Comment from Bruce Belson:
+ <pre> tags get their whitespace mangled by the Help Library Agent,
+ unless the non-standard attribute xml:space="preserve" is added to the pre element.
+ -->
+ <xsl:if test="$class = 'programlisting' or $class = 'verbatim' or $class = 'litterallayout' or $class = 'screen'">
+ <xsl:attribute name="xml:space">preserve</xsl:attribute>
+ </xsl:if>
+
+ <xsl:call-template name="generate.html.lang"/>
+ <xsl:call-template name="dir">
+ <xsl:with-param name="inherit" select="$inherit"/>
+ </xsl:call-template>
+ <xsl:apply-templates select="." mode="class.attribute">
+ <xsl:with-param name="class" select="$class"/>
+ </xsl:apply-templates>
+ </xsl:template>
+
+
+ <xsl:template name="hv1.display.version">
+ <xsl:apply-templates mode="title.markup" select="ancestor-or-self::book"/>
+ <xsl:if test="ancestor-or-self::chapter">
+ <xsl:text> - </xsl:text>
+ <xsl:apply-templates mode="title.markup" select="ancestor-or-self::chapter"/>
+ </xsl:if>
+ </xsl:template>
+
+
+ <!-- Generate a meta element for each keyword in chunk -->
+ <xsl:template name="hv1.keywords">
+ <xsl:variable name="is.chunk">
+ <xsl:call-template name="chunk">
+ <xsl:with-param name="node" select="."/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:for-each select=".//indexterm[$is.chunk = '0'] |
+ (./indexterm | *[not(self::section or self::preface or self::book or self::chapter)]//indexterm)[$is.chunk = '1']">
+ <xsl:choose>
+ <xsl:when test="primary != ''">
+ <meta name="Microsoft.Help.Keywords">
+ <xsl:attribute name="content">
+ <xsl:choose>
+ <!-- This concats the primary and secondary togheter, separated by colon if there exists
+ a tertiary element -->
+ <xsl:when test="tertiary">
+ <xsl:value-of select="primary/text()" />
+ <xsl:text>: </xsl:text>
+ <xsl:value-of select="secondary/text()" />
+ <xsl:text>, </xsl:text>
+ <xsl:value-of select="tertiary/text()" />
+ </xsl:when>
+
+ <xsl:otherwise>
+ <xsl:for-each select="primary/text() | secondary/text()">
+ <xsl:value-of select="." />
+ <xsl:if test="not(position() = last())">, </xsl:if>
+ </xsl:for-each>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:attribute>
+ </meta>
+ </xsl:when>
+ <xsl:otherwise/>
+ </xsl:choose>
+ </xsl:for-each>
+ </xsl:template>
+
+ <!-- Generate a F1 meta element for each indexterm with an ID (used as F1 id) -->
+ <xsl:template name="hv1.f1">
+ <xsl:variable name="is.chunk">
+ <xsl:call-template name="chunk">
+ <xsl:with-param name="node" select="."/>
+ </xsl:call-template>
+ </xsl:variable>
+
+ <xsl:variable name="id">
+ <xsl:call-template name="hv1.toc.id"/>
+ </xsl:variable>
+
+ <xsl:for-each select=".//indexterm[$is.chunk = '0'] |
+ (./indexterm | *[not(self::section or self::preface or self::book or self::chapter)]//indexterm)[$is.chunk = '1']">
+ <xsl:if test="@id|@xml:id">
+ <meta name="Microsoft.Help.F1">
+ <xsl:attribute name="content">
+ <xsl:value-of select="(@id|@xml:id)[1]" />
+ </xsl:attribute>
+ </meta>
+ </xsl:if>
+ </xsl:for-each>
+ </xsl:template>
+
+ <!-- ID used for to resolution. Using default ID -->
+ <xsl:template name="hv1.toc.id">
+ <xsl:variable name="href">
+ <xsl:call-template name="get.id.from.pagename">
+ <xsl:with-param name="target" select="."/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:value-of select="$href"/>
+ </xsl:template>
+
+ <!-- Determine parent id (if top level -> -1) -->
+ <xsl:template name="hv1.toc.parent.id">
+ <xsl:param name="up" select="''"/>
+ <xsl:variable name="href">
+ <xsl:choose>
+ <xsl:when test="$up">
+ <!-- I have a parent -->
+ <xsl:call-template name="get.id.from.pagename">
+ <xsl:with-param name="target" select="$up"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:text>-1</xsl:text>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:value-of select="$href"/>
+ </xsl:template>
+
+ <xsl:template name="hv1.description">
+ <xsl:variable name="content">
+ <xsl:choose>
+ <xsl:when test="abstract|d:abstract|d:info/d:abstract|bookinfo/abstract|sectioninfo/abstract|articleinfo/abstract|partinfo/abstract">
+ <xsl:value-of select="(abstract|d:abstract|d:info/d:abstract|bookinfo/abstract|sectioninfo/abstract|articleinfo/abstract|partinfo/abstract)[1]"/>
+ </xsl:when>
+ <xsl:when test="child::para">
+ <xsl:value-of select="substring(normalize-space(child::para[1]), 0, 150)"/>
+ </xsl:when>
+ <xsl:otherwise/>
+ </xsl:choose>
+ </xsl:variable>
+ <xsl:if test="$content != ''">
+ <xsl:value-of select="concat($content, '...')"/>
+ </xsl:if>
+ </xsl:template>
+
+
+</xsl:stylesheet>
diff --git a/lib/lufa/LUFA/StudioIntegration/Docbook/placeholder.txt b/lib/lufa/LUFA/StudioIntegration/Docbook/placeholder.txt
new file mode 100644
index 0000000000..c017acfd75
--- /dev/null
+++ b/lib/lufa/LUFA/StudioIntegration/Docbook/placeholder.txt
@@ -0,0 +1 @@
+Copy the Docbook XSLT docbook-xsl-1.78.1 release contents into this directory (i.e. with the root Docbook files in the current folder). The Docbook releases can be found at http://sourceforge.net/projects/docbook/files/docbook-xsl/ .