doc/xslt/manpages/info.xsl

   1 <?xml version='1.0'?>
   2 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   3                 xmlns:date="http://exslt.org/dates-and-times"
   4                 xmlns:exsl="http://exslt.org/common"
   5                 exclude-result-prefixes="date exsl"
   6                 version='1.0'>
   7
   8 <!-- ********************************************************************
   9      $Id: info.xsl 7883 2008-03-08 17:59:39Z xmldoc $
  10      ********************************************************************
  11
  12      This file is part of the XSL DocBook Stylesheet distribution.
  13      See ../README or http://docbook.sf.net/release/xsl/current/ for
  14      copyright and other information.
  15
  16      ******************************************************************** -->
  17
  18   <xsl:variable name="blurb-indent">
  19     <xsl:choose>
  20       <xsl:when test="not($man.indent.blurbs = 0)">
  21         <xsl:value-of select="$man.indent.width"/>
  22       </xsl:when>
  23       <xsl:when test="not($man.indent.refsect = 0)">
  24         <!-- * "zq" is the name of a register we set for -->
  25         <!-- * preserving the original default indent value -->
  26         <!-- * when $man.indent.refsect is non-zero; -->
  27         <!-- * "u" is a roff unit specifier -->
  28         <xsl:text>\n(zqu</xsl:text>
  29       </xsl:when>
  30       <xsl:otherwise/> <!-- * otherwise, just leave it empty -->
  31     </xsl:choose>
  32   </xsl:variable>
  33
  34   <!-- ================================================================== -->
  35   <!-- * About the $info param used in this stylesheet -->
  36   <!-- * -->
  37   <!-- * The $info param is a "master info" node set that contains -->
  38   <!-- * the entire contents of the *info child of the current -->
  39   <!-- * Refentry, plus the entire contents of the *info children of -->
  40   <!-- * all ancestors of the current Refentry, in document order. -->
  41   <!-- * -->
  42   <!-- * We try to find a "best match" for selecting content from -->
  43   <!-- * $infor; we look through it in reverse document order until we -->
  44   <!-- * can find something usable. -->
  45   <!-- * -->
  46   <!-- * Specifically what the basic metadata-gathering XPath expression -->
  47   <!-- * in this stylesheet does is: -->
  48   <!-- * -->
  49   <!-- *   1. Look through the entire "master info" node set.-->
  50   <!-- *   2. Get the last node in the set that contains, for -->
  51   <!-- *      example, an Author element. That amounts to being the -->
  52   <!-- *      closest *info node to the Refentry - either its *info -->
  53   <!-- *      child, or the *info node of its closest ancestor that -->
  54   <!-- *      contains an Author. -->
  55
  56   <!-- ================================================================== -->
  57   <!-- * Get user "refentry metadata" preferences -->
  58   <!-- ================================================================== -->
  59   <!-- * The DocBook XSL stylesheets include several user-configurable -->
  60   <!-- * global stylesheet parameters for controlling refentry metadata -->
  61   <!-- * gathering. Those parameters are not read directly by the other -->
  62   <!-- * refentry metadata-gathering templates. Instead, they are read -->
  63   <!-- * only by the get.refentry.metadata.prefs template, which -->
  64   <!-- * assembles them into a structure that is then passed to the -->
  65   <!-- * other refentry metadata-gathering template. -->
  66
  67   <xsl:variable name="get.refentry.metadata.prefs">
  68     <!-- * get.refentry.metadata.prefs is in common/refentry.xsl -->
  69     <xsl:call-template name="get.refentry.metadata.prefs"/>
  70   </xsl:variable>
  71
  72   <xsl:variable name="refentry.metadata.prefs"
  73                 select="exsl:node-set($get.refentry.metadata.prefs)"/>
  74
  75   <!-- * ============================================================== -->
  76   <!-- *    Get content for Author metadata field. -->
  77   <!-- * ============================================================== -->
  78
  79   <!-- * The make.roff.metatada.author template and metadata.author -->
  80   <!-- * mode are used only for populating the Author field in the -->
  81   <!-- * metadata "top comment" we embed in roff source of each page. -->
  82   <xsl:template name="make.roff.metadata.author">
  83     <xsl:param name="info"/>
  84     <xsl:param name="refname"/>
  85     <xsl:choose>
  86       <xsl:when test="$info//author">
  87         <xsl:apply-templates
  88             select="(($info[//author])[last()]//author)[1]"
  89             mode="metadata.author"/>
  90       </xsl:when>
  91       <xsl:when test="$info//corpauthor">
  92         <xsl:apply-templates
  93             select="(($info[//corpauthor])[last()]//corpauthor)[1]"
  94             mode="metadata.author"/>
  95       </xsl:when>
  96       <xsl:when test="$info//editor">
  97         <xsl:apply-templates
  98             select="(($info[//editor])[last()]//editor)[1]"
  99             mode="metadata.author"/>
 100       </xsl:when>
 101       <xsl:when test="$info//corpcredit">
 102         <xsl:apply-templates
 103             select="(($info[//corpcredit])[last()]//corpcredit)[1]"
 104             mode="metadata.author"/>
 105       </xsl:when>
 106       <xsl:when test="$info//othercredit">
 107         <xsl:apply-templates
 108             select="(($info[//othercredit])[last()]//othercredit)[1]"
 109             mode="metadata.author"/>
 110       </xsl:when>
 111       <xsl:when test="$info//collab">
 112         <xsl:apply-templates
 113             select="(($info[//collab])[last()]//collab)[1]"
 114             mode="metadata.author"/>
 115       </xsl:when>
 116       <xsl:when test="$info//orgname">
 117         <xsl:apply-templates
 118             select="(($info[//orgname])[last()]//orgname)[1]"
 119             mode="metadata.author"/>
 120       </xsl:when>
 121       <xsl:when test="$info//publishername">
 122         <xsl:apply-templates
 123             select="(($info[//publishername])[last()]//publishername)[1]"
 124             mode="metadata.author"/>
 125       </xsl:when>
 126       <xsl:otherwise>
 127         <!-- * otherwise, we need to check to see if we have an "Author" -->
 128         <!-- * or "Authors" section in the refentry -->
 129         <xsl:variable name="gentext.author">
 130           <xsl:text>"</xsl:text>
 131           <xsl:call-template name="gentext">
 132             <xsl:with-param name="key" select="'Author'"/>
 133           </xsl:call-template>
 134           <xsl:text>"</xsl:text>
 135         </xsl:variable>
 136         <xsl:variable name="gentext.AUTHOR">
 137           <xsl:if test="not($gentext.author = '')">
 138             <xsl:call-template name="string.upper">
 139               <xsl:with-param name="string" select="$gentext.author"/>
 140             </xsl:call-template>
 141           </xsl:if>
 142         </xsl:variable>
 143         <xsl:variable name="gentext.authors">
 144           <xsl:text>"</xsl:text>
 145           <xsl:call-template name="gentext">
 146             <xsl:with-param name="key" select="'Authors'"/>
 147           </xsl:call-template>
 148           <xsl:text>"</xsl:text>
 149         </xsl:variable>
 150         <xsl:variable name="gentext.AUTHORS">
 151           <xsl:if test="not($gentext.authors = '')">
 152             <xsl:call-template name="string.upper">
 153               <xsl:with-param name="string" select="$gentext.authors"/>
 154             </xsl:call-template>
 155           </xsl:if>
 156         </xsl:variable>
 157         <!-- * get all refentry/refsect1/title & refentry/refsection/title -->
 158         <!-- * instances, delimit each with double quotes, and put them -->
 159         <!-- * into a single refsect1.titles string -->
 160         <xsl:variable name="refsect1.titles">
 161           <xsl:for-each select="refsect1/title">
 162             <xsl:text>"</xsl:text>
 163             <xsl:value-of select="normalize-space(.)"/>
 164             <xsl:text>"</xsl:text>
 165             <xsl:text> </xsl:text>
 166           </xsl:for-each>
 167           <xsl:for-each select="refsection/title">
 168             <xsl:text>"</xsl:text>
 169             <xsl:value-of select="normalize-space(.)"/>
 170             <xsl:text>"</xsl:text>
 171             <xsl:text> </xsl:text>
 172           </xsl:for-each>
 173         </xsl:variable>
 174         <xsl:variable name="author.section.title">
 175           <xsl:choose>
 176             <xsl:when test="not($gentext.authors = '') and
 177               contains($refsect1.titles,$gentext.authors)">
 178               <xsl:value-of select="$gentext.authors"/>
 179             </xsl:when>
 180             <xsl:when test="not($gentext.AUTHORS = '') and
 181               contains($refsect1.titles,$gentext.AUTHORS)">
 182               <xsl:value-of select="$gentext.AUTHORS"/>
 183             </xsl:when>
 184             <xsl:when test="not($gentext.author = '') and
 185               contains($refsect1.titles,$gentext.author)">
 186               <xsl:value-of select="$gentext.author"/>
 187             </xsl:when>
 188             <xsl:when test="not($gentext.AUTHOR = '') and
 189               contains($refsect1.titles,$gentext.AUTHOR)">
 190               <xsl:value-of select="$gentext.AUTHOR"/>
 191             </xsl:when>
 192             <!-- * git docs (for one) use "DOCUMENTATION" for their authors section -->
 193             <xsl:when test="contains($refsect1.titles,'Documentation')">
 194               <xsl:text>Documentation</xsl:text>
 195             </xsl:when>
 196             <xsl:when test="contains($refsect1.titles,'DOCUMENTATION')">
 197               <xsl:text>DOCUMENTATION</xsl:text>
 198             </xsl:when>
 199             <xsl:otherwise/> <!-- * otherwise, leave empty -->
 200           </xsl:choose>
 201         </xsl:variable>
 202         <xsl:choose>
 203           <xsl:when test="not($author.section.title = '')">
 204             <!-- * if we have a non-empty $author.section.title value, -->
 205             <!-- * then reference that title (instead of putting a -->
 206             <!-- * specific author name) -->
 207             <xsl:text>[see the </xsl:text>
 208             <xsl:value-of select="$author.section.title"/>
 209             <xsl:text> section]</xsl:text>
 210           </xsl:when>
 211           <xsl:otherwise>
 212             <!-- * otherwise we have no info/author content and no Author -->
 213             <!-- * or Authors section, so we insert a fixme and report -->
 214             <!-- * the problem to the user -->
 215             <xsl:text>[FIXME: author] [see http://docbook.sf.net/el/author]</xsl:text>
 216             <xsl:if test="$refentry.meta.get.quietly = 0">
 217               <xsl:call-template name="log.message">
 218                 <xsl:with-param name="level">Warn</xsl:with-param>
 219                 <xsl:with-param name="source" select="$refname"/>
 220                 <xsl:with-param name="context-desc">meta author</xsl:with-param>
 221                 <xsl:with-param name="message">
 222                   <xsl:text>no refentry/info/author</xsl:text>
 223                 </xsl:with-param>
 224               </xsl:call-template>
 225               <xsl:call-template name="log.message">
 226                 <xsl:with-param name="level">Note</xsl:with-param>
 227                 <xsl:with-param name="source" select="$refname"/>
 228                 <xsl:with-param name="context-desc">meta author</xsl:with-param>
 229                 <xsl:with-param name="message">
 230                   <xsl:text>see http://docbook.sf.net/el/author</xsl:text>
 231                 </xsl:with-param>
 232               </xsl:call-template>
 233               <xsl:call-template name="log.message">
 234                 <xsl:with-param name="level">Warn</xsl:with-param>
 235                 <xsl:with-param name="source" select="$refname"/>
 236                 <xsl:with-param name="context-desc">meta author</xsl:with-param>
 237                 <xsl:with-param name="message">
 238                   <xsl:text>no author data, so inserted a fixme</xsl:text>
 239                 </xsl:with-param>
 240               </xsl:call-template>
 241             </xsl:if>
 242           </xsl:otherwise>
 243         </xsl:choose>
 244       </xsl:otherwise>
 245     </xsl:choose>
 246   </xsl:template>
 247
 248   <xsl:template match="author|editor|othercredit|collab" mode="metadata.author">
 249     <xsl:choose>
 250       <xsl:when test="collabname">
 251         <!-- * If this node is a Collab, then it should have a -->
 252         <!-- * Collabname child, so get that. -->
 253         <xsl:variable name="contents">
 254           <xsl:apply-templates select="collabname"/>
 255         </xsl:variable>
 256         <xsl:value-of select="normalize-space($contents)"/>
 257       </xsl:when>
 258       <xsl:otherwise>
 259         <!-- * Otherwise, this node is not a Collab, but instead -->
 260         <!-- * an author|editor|othercredit, which must have a name -->
 261         <!-- * of some kind; so get that name -->
 262         <xsl:call-template name="person.name.normalized"/>
 263       </xsl:otherwise>
 264     </xsl:choose>
 265     <xsl:if test=".//email|address/otheraddr/ulink">
 266       <xsl:text> </xsl:text>
 267       <!-- * For each attribution found, use only the first e-mail -->
 268       <!-- * address or ulink value found -->
 269       <xsl:apply-templates select="(.//email|address/otheraddr/ulink)[1]"
 270                            mode="metadata.author"/>
 271     </xsl:if>
 272   </xsl:template>
 273
 274   <xsl:template match="email|address/otheraddr/ulink" mode="metadata.author">
 275     <xsl:text>&lt;</xsl:text>
 276     <xsl:choose>
 277       <xsl:when test="self::email">
 278         <xsl:variable name="contents">
 279           <xsl:apply-templates/>
 280         </xsl:variable>
 281         <xsl:value-of select="normalize-space($contents)"/>
 282       </xsl:when>
 283       <xsl:when test="self::ulink">
 284         <xsl:variable name="contents">
 285           <xsl:apply-templates select="."/>
 286         </xsl:variable>
 287         <xsl:value-of select="normalize-space($contents)"/>
 288       </xsl:when>
 289     </xsl:choose>
 290     <xsl:text>&gt;</xsl:text>
 291   </xsl:template>
 292
 293   <xsl:template match="corpauthor|corpcredit|orgname|publishername" mode="metadata.author">
 294     <xsl:variable name="contents">
 295       <xsl:apply-templates/>
 296     </xsl:variable>
 297     <xsl:value-of select="normalize-space($contents)"/>
 298   </xsl:template>
 299
 300   <!-- * ============================================================== -->
 301   <!-- *     Assemble the AUTHOR/AUTHORS section -->
 302   <!-- * ============================================================== -->
 303
 304   <xsl:template name="author.section">
 305     <xsl:param name="info"/>
 306     <!-- * The $info param is a "master info" node set that contains -->
 307     <!-- * the entires contents of the *info child of the current -->
 308     <!-- * Refentry, plus the entire contents of the *info children of -->
 309     <!-- * all ancestors of the current Refentry, in document order. -->
 310     <xsl:choose>
 311       <xsl:when test="$info//author|$info//editor|$info//collab|
 312                       $info//corpauthor|$info//corpcredit|
 313                       $info//othercredit|$info/orgname|
 314                       $info/publishername|$info/publisher">
 315         <xsl:variable name="authorcount">
 316           <xsl:value-of
 317               select="count(
 318                       $info//author|$info//editor|$info//collab|
 319                       $info//corpauthor|$info//corpcredit|
 320                       $info//othercredit)">
 321           </xsl:value-of>
 322         </xsl:variable>
 323         <xsl:call-template name="make.subheading">
 324           <xsl:with-param name="title">
 325             <xsl:call-template name="make.authorsecttitle">
 326               <xsl:with-param name="authorcount" select="$authorcount"/>
 327             </xsl:call-template>
 328           </xsl:with-param>
 329         </xsl:call-template>
 330         <!-- * Now output all the actual author, editor, etc. content -->
 331         <xsl:for-each
 332           select="$info//author|$info//editor|$info//collab|
 333           $info//corpauthor|$info//corpcredit|
 334           $info//othercredit|$info/orgname|
 335           $info/publishername|$info/publisher">
 336           <xsl:apply-templates select="." mode="authorsect"/>
 337         </xsl:for-each>
 338       </xsl:when>
 339       <xsl:otherwise/> <!-- * do nothing, no author info found -->
 340     </xsl:choose>
 341   </xsl:template>
 342
 343   <xsl:template name="make.authorsecttitle">
 344     <!-- * If we have exactly one attributable person/entity, then output -->
 345     <!-- * localized gentext for 'Author'; otherwise, output 'Authors'. -->
 346     <xsl:param name="authorcount"/>
 347     <xsl:param name="authorsecttitle">
 348       <xsl:choose>
 349         <xsl:when test="$authorcount = 1">
 350           <xsl:text>Author</xsl:text>
 351         </xsl:when>
 352         <xsl:otherwise>
 353           <xsl:text>Authors</xsl:text>
 354         </xsl:otherwise>
 355       </xsl:choose>
 356     </xsl:param>
 357     <xsl:call-template name="gentext">
 358       <xsl:with-param name="key" select="$authorsecttitle"/>
 359     </xsl:call-template>
 360   </xsl:template>
 361
 362   <xsl:template match="author|editor|othercredit" mode="authorsect">
 363     <xsl:variable name="person-name">
 364       <xsl:call-template name="person.name.normalized"/>
 365     </xsl:variable>
 366     <!-- * If we have a person-name or email or ulink content, then -->
 367     <!-- * output name and email or ulink content on the same line -->
 368     <xsl:choose>
 369       <xsl:when test="not($person-name = '') or .//email or address/otheraddr/ulink">
 370         <xsl:text>.PP&#10;</xsl:text>
 371         <!-- * Display person name in bold -->
 372         <xsl:call-template name="bold">
 373           <xsl:with-param name="node" select="exsl:node-set($person-name)"/>
 374           <xsl:with-param name="context" select="."/>
 375         </xsl:call-template>
 376         <!-- * Display e-mail address(es) and ulink(s) on same line as name -->
 377         <xsl:apply-templates select=".//email|address/otheraddr/ulink" mode="authorsect"/>
 378         <xsl:text>&#10;</xsl:text>
 379       </xsl:when>
 380       <xsl:otherwise>
 381         <xsl:text>.br&#10;</xsl:text>
 382       </xsl:otherwise>
 383     </xsl:choose>
 384     <!-- * Display affiliation(s) on separate lines -->
 385     <xsl:apply-templates select="affiliation" mode="authorsect"/>
 386     <!-- * Display direct-child addresses on separate lines -->
 387     <xsl:apply-templates select="address" mode="authorsect"/>
 388     <!-- * Call template for handling various attribution possibilities -->
 389     <xsl:call-template name="attribution">
 390       <xsl:with-param name="person-name" select="$person-name"/>
 391     </xsl:call-template>
 392   </xsl:template>
 393
 394   <xsl:template match="collab" mode="authorsect">
 395     <xsl:text>.PP&#10;</xsl:text>
 396     <xsl:call-template name="bold">
 397       <xsl:with-param name="node" select="collabname"/>
 398       <xsl:with-param name="context" select="."/>
 399     </xsl:call-template>
 400     <!-- * Display e-mail address(es) and ulink(s) on same line as name -->
 401     <xsl:apply-templates select=".//email|address/otheraddr/ulink" mode="authorsect"/>
 402     <xsl:text>&#10;</xsl:text>
 403     <!-- * Display affilition(s) on separate lines -->
 404     <xsl:apply-templates select="affiliation" mode="authorsect"/>
 405   </xsl:template>
 406
 407   <xsl:template match="corpauthor|corpcredit|orgname|publishername" mode="authorsect">
 408     <xsl:text>.PP&#10;</xsl:text>
 409     <xsl:call-template name="bold">
 410       <xsl:with-param name="node" select="."/>
 411       <xsl:with-param name="context" select="."/>
 412     </xsl:call-template>
 413     <xsl:text>&#10;</xsl:text>
 414     <xsl:if test="self::publishername">
 415       <!-- * Display localized "Publisher" gentext -->
 416       <xsl:call-template name="publisher.attribution"/>
 417     </xsl:if>
 418   </xsl:template>
 419
 420   <xsl:template match="publisher" mode="authorsect">
 421     <xsl:text>.PP&#10;</xsl:text>
 422     <xsl:call-template name="bold">
 423       <xsl:with-param name="node" select="publishername"/>
 424       <xsl:with-param name="context" select="."/>
 425     </xsl:call-template>
 426     <!-- * Display e-mail address(es) and ulink(s) on same line as name -->
 427     <xsl:apply-templates select=".//email|address/otheraddr/ulink" mode="authorsect"/>
 428     <!-- * Display addresses on separate lines -->
 429     <xsl:apply-templates select="address" mode="authorsect"/>
 430     <!-- * Display localized "Publisher" literal -->
 431     <xsl:call-template name="publisher.attribution"/>
 432   </xsl:template>
 433
 434   <xsl:template name="publisher.attribution">
 435     <xsl:text>&#10;</xsl:text>
 436     <xsl:text>.RS</xsl:text>
 437     <xsl:if test="not($blurb-indent = '')">
 438       <xsl:text> </xsl:text>
 439       <xsl:value-of select="$blurb-indent"/>
 440     </xsl:if>
 441     <xsl:text>&#10;</xsl:text>
 442     <xsl:call-template name="gentext">
 443       <xsl:with-param name="key" select="'Publisher'"/>
 444     </xsl:call-template>
 445     <xsl:text>.&#10;</xsl:text>
 446     <xsl:text>.RE&#10;</xsl:text>
 447   </xsl:template>
 448
 449   <xsl:template match="email|address/otheraddr/ulink" mode="authorsect">
 450     <xsl:choose>
 451       <xsl:when test="preceding-sibling::*[descendant-or-self::email]
 452                       or preceding-sibling::address/otheraddr/ulink
 453                       or ancestor::address[preceding-sibling::*[descendant-or-self::email]]
 454                       or ancestor::address[preceding-sibling::address/otheraddr/ulink]">
 455         <!-- * This is not the first instance, so do nothing. -->
 456       </xsl:when>
 457       <xsl:otherwise>
 458         <!-- * This is first instances of an e-mail address or ulink, -->
 459         <!-- * so put a space before it. -->
 460         <xsl:text> </xsl:text>
 461       </xsl:otherwise>
 462     </xsl:choose>
 463     <!-- * Note that the reason for the \& character after the opening -->
 464     <!-- * angle bracket and before the closing angle bracket is to -->
 465     <!-- * prevent groff from inserting a linebreak at those points and -->
 466     <!-- * outputting a hyphen character where the break occurs -->
 467     <xsl:text>&lt;\&amp;</xsl:text>
 468     <xsl:choose>
 469       <xsl:when test="self::email">
 470         <xsl:variable name="contents">
 471           <xsl:apply-templates/>
 472         </xsl:variable>
 473         <xsl:value-of select="normalize-space($contents)"/>
 474       </xsl:when>
 475       <xsl:when test="self::ulink">
 476         <xsl:variable name="contents">
 477           <xsl:apply-templates select="."/>
 478         </xsl:variable>
 479         <xsl:value-of select="normalize-space($contents)"/>
 480       </xsl:when>
 481     </xsl:choose>
 482     <xsl:text>\&amp;&gt;</xsl:text>
 483     <xsl:choose>
 484       <xsl:when test="not(following-sibling::*[descendant-or-self::email]
 485                       or following-sibling::address/otheraddr/ulink
 486                       or ancestor::address[following-sibling::*[descendant-or-self::email]]
 487                       or ancestor::address[following-sibling::address/otheraddr/ulink])">
 488         <!-- * This is the final instance, so do nothing. -->
 489       </xsl:when>
 490       <xsl:otherwise>
 491         <!-- * Separate multiple e-mail addresses or ulinks with a comma -->
 492         <xsl:text>, </xsl:text>
 493       </xsl:otherwise>
 494     </xsl:choose>
 495   </xsl:template>
 496
 497   <xsl:template match="affiliation" mode="authorsect">
 498     <!-- * Get the string value of the contents of this Affiliation. If the -->
 499     <!-- * affiliation only contains an Address child whose only content is -->
 500     <!-- * an email address or ulink, then these contents will end up empty. -->
 501     <xsl:variable name="contents">
 502       <xsl:apply-templates mode="authorsect"/>
 503     </xsl:variable>
 504     <!-- * If contents are actually empty except for an email address -->
 505     <!-- * or ulink, then output nothing. -->
 506     <xsl:if test="$contents != ''">
 507       <xsl:text>.br&#10;</xsl:text>
 508       <xsl:for-each select="shortaffil|jobtitle|orgname|orgdiv|address">
 509         <!-- * only display output of nodes other than email or ulink -->
 510         <xsl:apply-templates select="node()[not(self::email) and not(self::otheraddr/ulink)]"/>
 511         <xsl:choose>
 512           <xsl:when test="position() = last()"/> <!-- do nothing -->
 513           <xsl:otherwise>
 514             <!-- * only add comma if the node has a child node other than -->
 515             <!-- * an email address or ulink -->
 516             <xsl:if test="child::node()[not(self::email) and not(self::otheraddr/ulink)]">
 517               <xsl:text>, </xsl:text>
 518             </xsl:if>
 519           </xsl:otherwise>
 520         </xsl:choose>
 521       </xsl:for-each>
 522       <xsl:text>&#10;</xsl:text>
 523       <xsl:choose>
 524         <xsl:when test="position() = last()"/> <!-- do nothing -->
 525         <xsl:otherwise>
 526           <!-- * put a line break after every Affiliation instance except -->
 527           <!-- * the last one in the set -->
 528           <xsl:text>.br&#10;</xsl:text>
 529         </xsl:otherwise>
 530       </xsl:choose>
 531     </xsl:if>
 532   </xsl:template>
 533
 534   <xsl:template match="address" mode="authorsect">
 535     <xsl:variable name="contents"
 536                   select="normalize-space(node()[not(self::email)
 537                           and not(self::otheraddr/ulink)])"/>
 538     <!-- * If this contents of this Address do not contain anything except -->
 539     <!-- * an email address or ulink, then output nothing. -->
 540     <xsl:if test="$contents != ''">
 541       <xsl:text>&#10;</xsl:text>
 542       <xsl:text>.br&#10;</xsl:text>
 543       <!--* Skip email and ulink descendants of Address (rendered elsewhere) -->
 544       <xsl:apply-templates select="node()[not(self::email) and not(self::otheraddr/ulink)]"/>
 545     </xsl:if>
 546   </xsl:template>
 547
 548   <xsl:template name="attribution">
 549     <xsl:param name="person-name"/>
 550     <xsl:param name="refname" select="ancestor::refentry/refnamediv[1]/refname[1]"/>
 551     <!-- * Determine appropriate attribution for a particular person's role. -->
 552     <xsl:choose>
 553       <!-- * if we have a *blurb or contrib, just use that -->
 554       <xsl:when test="contrib|personblurb|authorblurb">
 555         <xsl:apply-templates select="contrib|personblurb|authorblurb" mode="authorsect"/>
 556         <xsl:text>&#10;</xsl:text>
 557       </xsl:when>
 558       <xsl:otherwise>
 559         <!-- * otherwise we have no attribution information to use... -->
 560         <xsl:if test="not($person-name = '')">
 561           <!-- * if we have a person name or organization name -->
 562           <!-- * ($person-name can actually be an orgname, not just a -->
 563           <!-- * person name), then report to the user that we are -->
 564           <!-- * lacking attribution information for that person -->
 565           <xsl:if test="$refentry.meta.get.quietly = 0">
 566             <xsl:call-template name="log.message">
 567               <xsl:with-param name="level">Warn</xsl:with-param>
 568               <xsl:with-param name="source" select="$refname"/>
 569               <xsl:with-param name="context-desc">AUTHOR sect.</xsl:with-param>
 570               <xsl:with-param name="message">
 571                 <xsl:text>no personblurb|contrib for </xsl:text>
 572                 <xsl:value-of select="$person-name"/>
 573               </xsl:with-param>
 574             </xsl:call-template>
 575             <xsl:call-template name="log.message">
 576               <xsl:with-param name="level">Note</xsl:with-param>
 577               <xsl:with-param name="source" select="$refname"/>
 578               <xsl:with-param name="context-desc">AUTHOR sect.</xsl:with-param>
 579               <xsl:with-param name="message">
 580                 <xsl:text>see see http://docbook.sf.net/el/contrib</xsl:text>
 581               </xsl:with-param>
 582             </xsl:call-template>
 583             <xsl:call-template name="log.message">
 584               <xsl:with-param name="level">Note</xsl:with-param>
 585               <xsl:with-param name="source" select="$refname"/>
 586               <xsl:with-param name="context-desc">AUTHOR sect.</xsl:with-param>
 587               <xsl:with-param name="message">
 588                 <xsl:text>see see http://docbook.sf.net/el/personblurb</xsl:text>
 589               </xsl:with-param>
 590             </xsl:call-template>
 591           </xsl:if>
 592         </xsl:if>
 593         <xsl:choose>
 594           <!-- * If we have no *blurb or contrib, but this is an Author or -->
 595           <!-- * Editor, then render the corresponding localized gentext -->
 596           <xsl:when test="self::author">
 597             <xsl:text>&#10;</xsl:text>
 598             <xsl:text>.RS</xsl:text>
 599             <xsl:if test="not($blurb-indent = '')">
 600               <xsl:text> </xsl:text>
 601               <xsl:value-of select="$blurb-indent"/>
 602             </xsl:if>
 603             <xsl:text>&#10;</xsl:text>
 604             <xsl:call-template name="gentext">
 605               <xsl:with-param name="key" select="'Author'"/>
 606             </xsl:call-template>
 607             <xsl:text>.&#10;</xsl:text>
 608             <xsl:text>.RE&#10;</xsl:text>
 609           </xsl:when>
 610           <xsl:when test="self::editor">
 611             <xsl:text>&#10;</xsl:text>
 612             <xsl:text>.RS</xsl:text>
 613             <xsl:if test="not($blurb-indent = '')">
 614               <xsl:text> </xsl:text>
 615               <xsl:value-of select="$blurb-indent"/>
 616             </xsl:if>
 617             <xsl:text>&#10;</xsl:text>
 618             <xsl:call-template name="gentext">
 619               <xsl:with-param name="key" select="'Editor'"/>
 620             </xsl:call-template>
 621             <xsl:text>.&#10;</xsl:text>
 622             <xsl:text>.RE&#10;</xsl:text>
 623           </xsl:when>
 624           <!-- * If we have no *blurb or contrib, but this is an Othercredit, -->
 625           <!-- * check value of Class attribute and use corresponding gentext. -->
 626           <xsl:when test="self::othercredit">
 627             <xsl:choose>
 628               <xsl:when test="@class and @class != 'other'">
 629                 <xsl:text>&#10;</xsl:text>
 630                 <xsl:text>.RS</xsl:text>
 631                 <xsl:if test="not($blurb-indent = '')">
 632                   <xsl:text> </xsl:text>
 633                   <xsl:value-of select="$blurb-indent"/>
 634                 </xsl:if>
 635                 <xsl:text>&#10;</xsl:text>
 636                 <xsl:call-template name="gentext">
 637                   <xsl:with-param name="key" select="@class"/>
 638                 </xsl:call-template>
 639                 <xsl:text>.&#10;</xsl:text>
 640                 <xsl:text>.RE&#10;</xsl:text>
 641               </xsl:when>
 642               <xsl:otherwise>
 643                 <!-- * We have an Othercredit, but no usable value for the Class -->
 644                 <!-- * attribute, so nothing to show, do nothing -->
 645               </xsl:otherwise>
 646             </xsl:choose>
 647           </xsl:when>
 648           <xsl:otherwise>
 649             <!-- * We have no *blurb or contrib or anything else we can use to -->
 650             <!-- * display appropriate attribution for this person, so do nothing -->
 651           </xsl:otherwise>
 652         </xsl:choose>
 653       </xsl:otherwise>
 654     </xsl:choose>
 655   </xsl:template>
 656
 657   <xsl:template match="personblurb|authorblurb" mode="authorsect">
 658     <xsl:call-template name="mark.up.blurb.or.contrib"/>
 659     <!-- * yeah, it's possible for a *blurb to have a "title" -->
 660     <xsl:apply-templates select="title"/>
 661     <xsl:apply-templates select="*[not(self::title)]"/>
 662     <!-- * If this *blurb has a sibling "name" element of some kind, then -->
 663     <!-- * the mark.up.blurb.or.contrib template will generated an "RS" -->
 664     <!-- * call that will cause it to be indented; so we need to call -->
 665     <!-- * "RE" to restore the previous indent level -->
 666     <xsl:if test="../personname|../surname|../firstname
 667       |../othername|../lineage|../honorific
 668       |../affiliation|../email|../address">
 669       <xsl:text>.RE&#10;</xsl:text>
 670     </xsl:if>
 671   </xsl:template>
 672
 673   <xsl:template match="personblurb/title|authorblurb/title">
 674     <!-- * always render period after title -->
 675     <xsl:variable name="contents">
 676       <xsl:apply-templates/>
 677     </xsl:variable>
 678     <xsl:value-of select="normalize-space($contents)"/>
 679     <xsl:text>.</xsl:text>
 680     <!-- * render space after Title+period if the title is followed -->
 681     <!-- * by something element content -->
 682     <xsl:if test="following-sibling::*[name() != '']">
 683       <xsl:text> </xsl:text>
 684     </xsl:if>
 685   </xsl:template>
 686
 687   <xsl:template match="contrib" mode="authorsect">
 688     <xsl:call-template name="mark.up.blurb.or.contrib"/>
 689     <xsl:variable name="contents">
 690       <xsl:apply-templates/>
 691     </xsl:variable>
 692     <xsl:value-of select="normalize-space($contents)"/>
 693     <xsl:text>&#10;</xsl:text>
 694     <xsl:if test="../personname|../surname|../firstname
 695       |../othername|../lineage|../honorific
 696       |../affiliation|../email|../address">
 697       <xsl:text>.RE&#10;</xsl:text>
 698     </xsl:if>
 699   </xsl:template>
 700
 701   <xsl:template name="mark.up.blurb.or.contrib">
 702     <xsl:choose>
 703       <!-- * If this *blurb has a sibling "name" element of some kind, then -->
 704       <!-- * we are already outputting the name content, and we need to -->
 705       <!-- * indent the *blurb content after that. -->
 706       <xsl:when
 707           test="../personname|../surname|../firstname
 708                 |../othername|../lineage|../honorific
 709                 |../affiliation|../email|../address">
 710         <xsl:text>&#10;</xsl:text>
 711         <xsl:text>.RS</xsl:text>
 712         <xsl:if test="not($blurb-indent = '')">
 713           <xsl:text> </xsl:text>
 714           <xsl:value-of select="$blurb-indent"/>
 715         </xsl:if>
 716       </xsl:when>
 717       <xsl:otherwise>
 718         <!-- * otherwise, we have no "name" content, so don't indent; -->
 719         <!-- * instead, decide if we need a .PP or just a .br -->
 720         <xsl:choose>
 721           <xsl:when test="not(preceding-sibling::*)">
 722             <!-- * if this *blurb or contrib has no preceding -->
 723             <!-- * siblings, then we need to start a new paragraph -->
 724             <xsl:text>.PP</xsl:text>
 725           </xsl:when>
 726           <xsl:otherwise>
 727             <!-- * otherwise, this has no preceding siblings, so -->
 728             <!-- * just put a linebreak -->
 729             <xsl:text>.br</xsl:text>
 730           </xsl:otherwise>
 731         </xsl:choose>
 732       </xsl:otherwise>
 733     </xsl:choose>
 734     <xsl:text>&#10;</xsl:text>
 735   </xsl:template>
 736
 737   <!-- * ============================================================== -->
 738   <!-- *     Assemble the COPYRIGHT section -->
 739   <!-- * ============================================================== -->
 740   <!-- * The COPYRIGHT section is output only if a copyright or -->
 741   <!-- * legalnotice is found. It contains the copyright contents -->
 742   <!-- * followed by the legalnotice contents. -->
 743   <xsl:template name="copyright.section">
 744     <xsl:param name="info"/>
 745     <xsl:choose>
 746       <xsl:when test="$info//copyright|$info//legalnotice">
 747         <xsl:call-template name="make.subheading">
 748           <xsl:with-param name="title">
 749             <xsl:call-template name="gentext">
 750               <xsl:with-param name="key">Copyright</xsl:with-param>
 751             </xsl:call-template>
 752           </xsl:with-param>
 753         </xsl:call-template>
 754         <xsl:text>.br&#10;</xsl:text>
 755         <!-- * the copyright mode="titlepage.mode" template is -->
 756         <!-- * imported from the HTML stylesheets -->
 757         <xsl:for-each select="
 758           (($info[//copyright])[last()]//copyright)
 759           | (($info[//legalnotice])[last()]//legalnotice)">
 760           <xsl:choose>
 761             <xsl:when test="local-name(.) = 'copyright'">
 762               <xsl:variable name="contents">
 763                 <xsl:apply-templates select="." mode="titlepage.mode"/>
 764               </xsl:variable>
 765               <xsl:value-of select="normalize-space($contents)"/>
 766               <xsl:text>&#10;</xsl:text>
 767               <xsl:text>.br&#10;</xsl:text>
 768             </xsl:when>
 769             <xsl:otherwise>
 770               <xsl:apply-templates select="." mode="titlepage.mode"/>
 771               <xsl:text>&#10;</xsl:text>
 772               <xsl:text>.sp&#10;</xsl:text>
 773             </xsl:otherwise>
 774           </xsl:choose>
 775         </xsl:for-each>
 776       </xsl:when>
 777       <xsl:otherwise/> <!-- * do nothing, no copyright or legalnotice found -->
 778     </xsl:choose>
 779   </xsl:template>
 780
 781   <xsl:template match="legalnotice">
 782     <xsl:apply-templates/>
 783   </xsl:template>
 784
 785   <!-- * ============================================================== -->
 786
 787   <!-- * suppress refmeta and all *info (we grab what we need from them -->
 788   <!-- * elsewhere) -->
 789
 790   <xsl:template match="refmeta"/>
 791
 792   <xsl:template match="info|refentryinfo|referenceinfo|refsynopsisdivinfo
 793                        |refsectioninfo|refsect1info|refsect2info|refsect3info
 794                        |setinfo|bookinfo|articleinfo|chapterinfo|sectioninfo
 795                        |sect1info|sect2info|sect3info|sect4info|sect5info
 796                        |partinfo|prefaceinfo|appendixinfo|docinfo"/>
 797
 798   <!-- ============================================================== -->
 799
 800 </xsl:stylesheet>