summaryrefslogtreecommitdiff
path: root/util/tagfile-to-devhelp2.xsl
blob: 267f04984c00050a557d10f5ad2217a3b61307e2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns="http://www.devhelp.net/book"
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <!--
  Copyright (c) 2009  Daniel Elstner <daniel.kitta@gmail.com>

  XSL transformation from a Doxygen tag file to DevHelp 2 format.

  This script is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published
  by the Free Software Foundation, either version 2 of the License,
  or (at your option) any later version.

  This script is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this script.  If not, see <http://www.gnu.org/licenses/>.
  -->
  <xsl:output method="xml" version="1.0" indent="yes" encoding="UTF-8"/>

  <xsl:param name="book_title"/>
  <xsl:param name="book_name"/>
  <xsl:param name="book_base"/>

  <xsl:template match="/">
    <book title="{$book_title}" name="{$book_name}" base="{$book_base}"
          link="index.html" version="2" language="c++">
      <chapters>
        <sub name="Classes" link="classes.html">
          <xsl:apply-templates select="tagfile/compound[@kind='class' or @kind='struct']" mode="sub">
            <xsl:sort lang="en" case-order="upper-first" select="name"/>
          </xsl:apply-templates>
        </sub>
        <sub name="Namespaces" link="namespaces.html">
          <xsl:apply-templates select="tagfile/compound[@kind='namespace']" mode="sub">
            <xsl:sort lang="en" case-order="upper-first" select="name"/>
          </xsl:apply-templates>
        </sub>
      </chapters>
      <functions>
        <xsl:apply-templates select="tagfile/compound[@kind='namespace' or @kind='class' or @kind='struct']" mode="compound">
          <xsl:sort lang="en" select="name"/>
        </xsl:apply-templates>
      </functions>
    </book>
  </xsl:template>

  <xsl:template match="compound" mode="sub">
    <sub name="{name}" link="{filename}"/>
  </xsl:template>

  <xsl:template match="compound[@kind='namespace']" mode="compound">
    <xsl:apply-templates select="member" mode="keyword">
      <xsl:sort lang="en" select="name"/>
    </xsl:apply-templates>
  </xsl:template>
  <xsl:template match="compound[@kind='class' or @kind='struct']" mode="compound">
    <keyword type="struct" name="{name}" link="{filename}"/>
    <xsl:apply-templates select="member" mode="keyword">
      <xsl:sort lang="en" select="name"/>
    </xsl:apply-templates>
  </xsl:template>

  <xsl:template match="member[@kind='function' or @kind='typedef']" mode="keyword">
    <keyword type="{@kind}" xsl:use-attribute-sets="keyword-member"/>
  </xsl:template>
  <xsl:template match="member[@kind='enumeration']" mode="keyword">
    <keyword type="enum" xsl:use-attribute-sets="keyword-member"/>
  </xsl:template>
  <xsl:template match="member[@kind='enumvalue' or @kind='define']" mode="keyword">
    <keyword type="macro" xsl:use-attribute-sets="keyword-member"/>
  </xsl:template>
  <!-- Ignore keywords of unknown type -->
  <xsl:template match="*" mode="keyword"/>

  <xsl:attribute-set name="keyword-member">
    <xsl:attribute name="name">
      <xsl:value-of select="concat(../name, '::', name)"/>
    </xsl:attribute>
    <xsl:attribute name="link">
      <xsl:value-of select="concat(anchorfile, '#', anchor)"/>
    </xsl:attribute>
  </xsl:attribute-set>

</xsl:stylesheet>