From e8d7c808919ca6a8546832e260d4449b77909317 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Marek=20St=C4=99pniowski?= <marek@stepniowski.com>
Date: Fri, 5 Sep 2008 17:37:49 +0200
Subject: [PATCH 1/1] Added comments to book2html.xslt stylesheet.

---
 lib/librarian/book2html.xslt | 202 +++++++++++++++++++++--------------
 1 file changed, 120 insertions(+), 82 deletions(-)
diff --git a/lib/librarian/book2html.xslt b/lib/librarian/book2html.xslt
index a83cc0c06..f7bb9a225 100644
--- a/lib/librarian/book2html.xslt
+++ b/lib/librarian/book2html.xslt
@@ -3,13 +3,6 @@
 
 <xsl:output method="xml" encoding="utf-8" doctype-public="-//W3C//DTD XHTML 1.1//EN" doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" indent="yes" />
 
-<xsl:template match="text()" />
-<xsl:template match="text()" mode="inline">
-    <xsl:value-of select="wl:substitute_entities(.)" />
-</xsl:template>
-
-<xsl:template match="extra|uwaga" />
-<xsl:template match="extra|uwaga" mode="inline" />
 
 <xsl:template match="utwor">
     <html>
@@ -44,6 +37,10 @@
 </xsl:template>
 
 
+<!-- ============================================================================== -->
+<!-- = MASTER TAG                                                                 = -->
+<!-- = (can contain block tags, paragraph tags, standalone tags and special tags) = -->
+<!-- ============================================================================== -->
 <xsl:template match="powiesc|opowiadanie|liryka_l|liryka_lp|dramat_wierszowany_l|dramat_wierszowany_lp|dramat_wspolczesny">
     <xsl:if test="nazwa_utworu">
         <h1>
@@ -53,9 +50,48 @@
     <xsl:apply-templates />
 </xsl:template>
 
-<!-- ======================= -->
-<!-- = Header (title page) = -->
-<!-- ======================= -->
+
+<!-- ==================================================================================== -->
+<!-- = BLOCK TAGS                                                                       = -->
+<!-- = (can contain other block tags, paragraph tags, standalone tags and special tags) = -->
+<!-- ==================================================================================== -->
+<xsl:template match="nota">
+    <div class="note"><xsl:apply-templates /></div>
+</xsl:template>
+
+<xsl:template match="lista_osob">
+    <div class="person-list">
+        <h3><xsl:value-of select="naglowek_listy" /></h3>
+        <ol>
+            <xsl:apply-templates select="lista_osoba" />
+        </ol>
+    </div>
+</xsl:template>
+
+<xsl:template match="dedykacja">
+    <div class="dedication"><xsl:apply-templates /></div>
+</xsl:template>
+
+<xsl:template match="kwestia">
+    <div class="kwestia">
+        <xsl:apply-templates select="strofa|akap" />
+    </div>
+</xsl:template>
+
+<xsl:template match="dlugi_cytat">
+    <blockquote><xsl:apply-templates /></blockquote>
+</xsl:template>
+
+<xsl:template match="motto">
+    <div class="motto"><xsl:apply-templates mode="inline" /></div>
+</xsl:template>
+
+
+<!-- ========================================== -->
+<!-- = PARAGRAPH TAGS                         = -->
+<!-- = (can contain inline and special tags)  = -->
+<!-- ========================================== -->
+<!-- Title page -->
 <xsl:template match="autor_utworu" mode="header">
     <span class="author"><xsl:apply-templates mode="inline" /></span>
 </xsl:template>
@@ -72,17 +108,7 @@
     <span class="subtitle"><xsl:apply-templates mode="inline" /></span>
 </xsl:template>
 
-<xsl:template match="nota">
-    <div class="note"><xsl:apply-templates /></div>
-</xsl:template>
-
-<xsl:template match="dedykacja">
-    <div class="dedication"><xsl:apply-templates /></div>
-</xsl:template>
-
-<!-- =================== -->
-<!-- = Section headers = -->
-<!-- =================== -->
+<!-- Section headers -->
 <xsl:template match="naglowek_akt|naglowek_czesc|srodtytul">
     <h2><xsl:apply-templates mode="inline" /></h2>
 </xsl:template>
@@ -95,67 +121,21 @@
     <h4><xsl:apply-templates mode="inline" /></h4>
 </xsl:template>
 
+<!-- Other paragraph tags -->
 <xsl:template match="miejsce_czas">
     <p class="place-and-time"><xsl:apply-templates mode="inline" /></p>
 </xsl:template>
 
-<xsl:template match="kwestia">
-    <div class="kwestia">
-        <xsl:apply-templates select="strofa|akap" />
-    </div>
-</xsl:template>
-
 <xsl:template match="didaskalia">
     <div class="didaskalia"><xsl:apply-templates mode="inline" /></div>
 </xsl:template>
 
-<xsl:template match="lista_osob">
-    <div class="person-list">
-        <h3><xsl:value-of select="naglowek_listy" /></h3>
-        <ol>
-            <xsl:apply-templates select="lista_osoba" />
-        </ol>
-    </div>
-</xsl:template>
-
 <xsl:template match="lista_osoba">
     <li><xsl:apply-templates mode="inline" /></li>
 </xsl:template>
 
-<xsl:template match="begin" mode="inline">
-    <xsl:variable name="mnum" select="concat('m', substring(@id, 2))" />
-    <span class="theme-begin" fid="{substring(@id, 2)}">
-        <xsl:value-of select="string(following::motyw[@id=$mnum]/text())" />
-    </span>
-</xsl:template>
-
-<xsl:template match="end" mode="inline">
-    <span class="theme-end" fid="{substring(@id, 2)}"> </span>
-</xsl:template>
-
-<xsl:template match="begin|end">
-    <xsl:apply-templates select='.' mode="inline" />
-</xsl:template>
-
-<xsl:template name="verse">
-    <xsl:param name="line-content" />
-    <xsl:param name="line-number" />
-    <p>
-        <xsl:choose>
-            <xsl:when test="name($line-content) = 'wers_akap'">
-                <xsl:attribute name="style">indent: 1em</xsl:attribute>
-            </xsl:when>
-            <xsl:when test="name($line-content) = 'wers_wciety'">
-                <xsl:attribute name="style">indent: 2em</xsl:attribute>
-            </xsl:when>
-        </xsl:choose>
-        <xsl:apply-templates select="$line-content" mode="inline" />
-    </p>
-</xsl:template>
-
-<xsl:template match="pa|pe|pr|pt" mode="inline">
-    <a name="{concat('anchor-', generate-id(.))}" />
-    <a href="{concat('#footnote-', generate-id(.))}" class="annotation">[<xsl:number value="count(preceding::*[self::pa or self::pe or self::pr or self::pt]) + 1" />]</a>
+<xsl:template match="akap|akap_dialog|akap_cd">
+    <p class="paragraph"><xsl:apply-templates mode="inline" /></p>
 </xsl:template>
 
 <xsl:template match="strofa">
@@ -167,7 +147,7 @@
                     <xsl:with-param name="line-number" select="1" />
                 </xsl:call-template>    
                 <xsl:for-each select="br">		
-        			<!-- KaÅ¼dy BR "zjada" to co jest za nim -->
+        			<!-- Each BR tag "consumes" text after it -->
                     <xsl:variable name="lnum" select="count(preceding-sibling::br)" />
                     <xsl:call-template name="verse">
                         <xsl:with-param name="line-number" select="$lnum+2" />
@@ -186,26 +166,84 @@
     </div>
 </xsl:template>
 
-<xsl:template match="akap|akap_dialog|akap_cd">
-    <p class="paragraph"><xsl:apply-templates mode="inline" /></p>
+<xsl:template name="verse">
+    <xsl:param name="line-content" />
+    <xsl:param name="line-number" />
+    <p>
+        <xsl:choose>
+            <xsl:when test="name($line-content) = 'wers_akap'">
+                <xsl:attribute name="style">indent: 1em</xsl:attribute>
+            </xsl:when>
+            <xsl:when test="name($line-content) = 'wers_wciety'">
+                <xsl:attribute name="style">indent: 2em</xsl:attribute>
+            </xsl:when>
+        </xsl:choose>
+        <xsl:apply-templates select="$line-content" mode="inline" />
+    </p>
 </xsl:template>
 
-<xsl:template match="motyw" mode="inline" />
-
-<xsl:template match="dlugi_cytat">
-    <blockquote><xsl:apply-templates /></blockquote>
+<xsl:template match="motto_podpis">
+    <p class="motto_podpis"><xsl:apply-templates mode="inline" /></p>
 </xsl:template>
 
-<xsl:template match="motto">
-    <p class="motto"><xsl:apply-templates mode="inline" /></p>
-</xsl:template>
 
-<xsl:template match="motto_podpis">
-    <p class="motto_podpis"><xsl:apply-templates mode="inline" /></p>
+<!-- ================================================ -->
+<!-- = INLINE TAGS                                  = -->
+<!-- = (contain other inline tags and special tags) = -->
+<!-- ================================================ -->
+<!-- Annotations -->
+<xsl:template match="pa|pe|pr|pt" mode="inline">
+    <a name="{concat('anchor-', generate-id(.))}" />
+    <a href="{concat('#footnote-', generate-id(.))}" class="annotation">[<xsl:number value="count(preceding::*[self::pa or self::pe or self::pr or self::pt]) + 1" />]</a>
 </xsl:template>
 
+
+<!-- ============================================== -->
+<!-- = STANDALONE TAGS                            = -->
+<!-- = (cannot contain any other tags)            = -->
+<!-- ============================================== -->
 <xsl:template match="sekcja_swiatlo">
     <hr class="spacer" />
 </xsl:template>
 
+
+<!-- ================ -->
+<!-- = SPECIAL TAGS = -->
+<!-- ================ -->
+<!-- Themes -->
+<xsl:template match="begin" mode="inline">
+    <xsl:variable name="mnum" select="concat('m', substring(@id, 2))" />
+    <span class="theme-begin" fid="{substring(@id, 2)}">
+        <xsl:value-of select="string(following::motyw[@id=$mnum]/text())" />
+    </span>
+</xsl:template>
+
+<xsl:template match="end" mode="inline">
+    <span class="theme-end" fid="{substring(@id, 2)}"> </span>
+</xsl:template>
+
+<xsl:template match="begin|end">
+    <xsl:apply-templates select='.' mode="inline" />
+</xsl:template>
+
+<xsl:template match="motyw" mode="inline" />
+
+
+<!-- ================ -->
+<!-- = IGNORED TAGS = -->
+<!-- ================ -->
+<xsl:template match="extra|uwaga" />
+<xsl:template match="extra|uwaga" mode="inline" />
+
+
+<!-- ======== -->
+<!-- = TEXT = -->
+<!-- ======== -->
+<xsl:template match="text()" />
+<xsl:template match="text()" mode="inline">
+    <xsl:value-of select="wl:substitute_entities(.)" />
+</xsl:template>
+
+
 </xsl:stylesheet>
+
-- 
2.20.1

