diff options
Diffstat (limited to 'src/documentation/resources/stylesheets/changes2document.xsl')
| -rw-r--r-- | src/documentation/resources/stylesheets/changes2document.xsl | 210 |
1 files changed, 210 insertions, 0 deletions
diff --git a/src/documentation/resources/stylesheets/changes2document.xsl b/src/documentation/resources/stylesheets/changes2document.xsl new file mode 100644 index 0000000000..6cf0a13b4a --- /dev/null +++ b/src/documentation/resources/stylesheets/changes2document.xsl @@ -0,0 +1,210 @@ +<?xml version="1.0"?> +<!-- + ==================================================================== + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + ==================================================================== +--> + +<xsl:stylesheet + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + + <xsl:param name="bugtracking-url">https://bz.apache.org/bugzilla/</xsl:param> + <!-- FIXME : Get the Github URL from properties --> + <xsl:variable name="github-url">https://github.com/apache/poi</xsl:variable> + + <xsl:variable name="bugdetails" select="concat($bugtracking-url, 'show_bug.cgi?id=')"/> + <xsl:variable name="buglist" select="concat($bugtracking-url, 'buglist.cgi?bug_id=')"/> + + <xsl:template match="a"> + <!-- FIXME! This doesn't work for href or name. Use the externally defined link->a transform if possible --> + <a href="{@href}"> + <xsl:apply-templates/> + </a> + </xsl:template> + + <!-- usage: <bug num="12345"/> or <bug num="12345,12346"/> or <bug num="github-12"/> --> + <xsl:template match="bug"> + <xsl:choose> + <xsl:when test="contains(@num, ',')"> + <a href="{$buglist}{translate(normalize-space(@num),' ','')}"> + <xsl:text></xsl:text><xsl:value-of select="normalize-space( translate(@num, ',', ' ') )"/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="contains(@num, 'github-')"> + <a href="{$github-url}/pull/{translate(@num,'github-','')}"> + <xsl:text></xsl:text><xsl:value-of select="@num"/> + </a> + </xsl:when> + <xsl:otherwise> + <a href="{$bugdetails}{@num}"> + <xsl:text></xsl:text><xsl:value-of select="@num"/> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + <xsl:template match="devs"/> + + <xsl:template match="changes"> + <document> + <header> + <title>History of Changes</title> + </header> + <body> + <xsl:apply-templates/> + </body> + </document> + </xsl:template> + + <xsl:template match="section"> + <xsl:copy-of select="." /> + </xsl:template> + + <xsl:template match="release"> + <section id="{@version}"> + <title>Version + <xsl:value-of select="@version"/> (<xsl:value-of select="@date"/>) + </title> + <xsl:apply-templates/> + </section> + </xsl:template> + + <xsl:template match="summary"> + <section> + <title>Summary</title> + <ul> <!-- create a new list for each noteable change in the summary --> + <xsl:apply-templates/> <!-- summary-item's --> + </ul> + </section> + </xsl:template> + + <xsl:template match="summary-item"> + <li> + <xsl:apply-templates/> + </li> + </xsl:template> + + <xsl:template match="actions"> + <section> + <title>Changes</title> + <table class="POITable"> + <colgroup> + <col width="100" /> + <col width="200" /> + <col width="150" /> + <col/> + </colgroup> + <thead> + <tr> + <th>Type</th> + <th>Bug</th> + <th>Module</th> + <th>Description</th> + </tr> + </thead> + + <tbody> + <!-- TODO: sort actions by type --> + <xsl:apply-templates/> <!-- action's --> + </tbody> + + </table> + </section> + </xsl:template> + + <xsl:template match="action"> + <tr class="action"> + + <td> + <icon src="images/{@type}.png" alt="{@type}" title="{@type}"/> + </td> + + <td> + <!-- TODO: duplicate code. replace with the <xsl:template match="bug"/> defined above --> + <xsl:if test="@fixes-bug"> + <xsl:choose> + <xsl:when test="contains(@fixes-bug, ',')"> + <a href="{$buglist}{translate(normalize-space(@fixes-bug),' ','')}"> + <xsl:text></xsl:text><xsl:value-of + select="normalize-space( translate(@fixes-bug, ',', ' ') )"/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="contains(@fixes-bug, 'github-')"> + <a href="{$github-url}/pull/{translate(@fixes-bug,'github-','')}"> + <xsl:text></xsl:text><xsl:value-of select="@fixes-bug"/> + </a> + </xsl:when> + <xsl:otherwise> + <a href="{$bugdetails}{@fixes-bug}"> + <xsl:text></xsl:text><xsl:value-of select="@fixes-bug"/> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </td> + + <td> + <!-- FIXME: is there any way that the module can be fetched from bugzilla using each bug's component? --> + <xsl:if test="@context"> + <xsl:value-of select="@context"/> + </xsl:if> + </td> + + <td> + + <!-- description: bold any backwards-breaking changes --> + <xsl:choose> + <xsl:when test="@breaks-compatibility"> + <b> + <xsl:apply-templates/> + <xsl:text> (breaks backwards compatibility)</xsl:text> + </b> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + + <!-- thanks --> + <xsl:if test="@due-to and @due-to!=''"> + <xsl:text> Thanks to </xsl:text> + <xsl:choose> + <xsl:when test="@due-to-email and @due-to-email!=''"> + <a href="mailto:{@due-to-email}"> + <xsl:value-of select="@due-to"/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@due-to"/> + </xsl:otherwise> + </xsl:choose> + <xsl:text>.</xsl:text> + </xsl:if> + </td> + + </tr> + </xsl:template> + +</xsl:stylesheet> |