From 22ed1ee6e63a496f1e56d8bd905542035d88ca2b Mon Sep 17 00:00:00 2001
From: Adrian Kummerlaender
Date: Sun, 12 Oct 2014 12:57:01 +0200
Subject: Extracted generation framework into StaticXSLT module * i.e. the
 `detail` transformations were moved into a BuildXSLT module * modified XML
 Makefile accordingly * removed framework documentation from `README.md` and
 added usage documentation * this was done to make it easier to use the basic
 static site generation framework in other projects ** the detail
 transformations were developed to enable the implementation of this blog but
 are generic enough to be used in other contexts

---
 detail/list.xsl      |  49 ----------
 detail/plan.xsl      |  99 --------------------
 detail/process.xsl   | 250 ---------------------------------------------------
 detail/summarize.xsl |  75 ----------------
 4 files changed, 473 deletions(-)
 delete mode 100644 detail/list.xsl
 delete mode 100644 detail/plan.xsl
 delete mode 100644 detail/process.xsl
 delete mode 100644 detail/summarize.xsl

(limited to 'detail')

diff --git a/detail/list.xsl b/detail/list.xsl
deleted file mode 100644
index c70a6bf..0000000
--- a/detail/list.xsl
+++ /dev/null
@@ -1,49 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet
-	version="1.0"
-	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-	xmlns:InputXSLT="function.inputxslt.application"
-	exclude-result-prefixes="InputXSLT"
->
-
-<xsl:output
-	method="xml"
-	omit-xml-declaration="yes"
-	encoding="UTF-8"
-	indent="no"
-/>
-
-<xsl:include href="../utility/datasource.xsl"/>
-
-<xsl:template name="list">
-	<xsl:param name="base"/>
-
-	<xsl:for-each select="InputXSLT:read-directory($base)/entry">
-		<xsl:choose>
-			<xsl:when test="@type = 'directory'">
-				<directory name="{./name}">
-					<xsl:call-template name="list">
-						<xsl:with-param name="base" select="./full"/>
-					</xsl:call-template>
-				</directory>
-			</xsl:when>
-			<xsl:otherwise>
-				<file name="{./name}" extension="{./extension}">
-					<xsl:copy-of select="full"/>
-				</file>
-			</xsl:otherwise>
-		</xsl:choose>
-	</xsl:for-each>
-</xsl:template>
-
-<xsl:template match="datasource">
-	<xsl:copy-of select="meta"/>
-
-	<source>
-		<xsl:call-template name="list">
-			<xsl:with-param name="base" select="meta/source"/>
-		</xsl:call-template>
-	</source>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/detail/plan.xsl b/detail/plan.xsl
deleted file mode 100644
index 653a9ca..0000000
--- a/detail/plan.xsl
+++ /dev/null
@@ -1,99 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet
-	version="1.0"
-	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-	xmlns:dyn="http://exslt.org/dynamic"
-	xmlns:xalan="http://xml.apache.org/xalan"
-	xmlns:InputXSLT="function.inputxslt.application"
-	exclude-result-prefixes="dyn xalan InputXSLT"
->
-
-<xsl:output
-	method="xml"
-	omit-xml-declaration="yes"
-	encoding="UTF-8"
-	indent="no"
-/>
-
-<xsl:include href="../utility/datasource.xsl"/>
-
-<xsl:template name="traverse">
-	<xsl:param name="source"/>
-	<xsl:param name="target"/>
-	<xsl:param name="path"/>
-	<xsl:param name="node"/>
-
-	<xsl:for-each select="$node/directory">
-		<xsl:choose>
-			<xsl:when test=".//file/@extension = '.xsl'">
-				<xsl:call-template name="traverse">
-					<xsl:with-param name="source" select="$source"/>
-					<xsl:with-param name="target" select="$target"/>
-					<xsl:with-param name="path"   select="concat($path, '/', @name)"/>
-					<xsl:with-param name="node"   select="."/>
-				</xsl:call-template>
-			</xsl:when>
-			<xsl:otherwise>
-				<task type="link">
-					<from>
-						<xsl:value-of select="concat($target, '/', $path, '/', @name)"/>
-					</from>
-					<to>
-						<xsl:value-of select="concat($source, '/', $path, '/', @name)"/>
-					</to>
-				</task>
-			</xsl:otherwise>
-		</xsl:choose>
-	</xsl:for-each>
-
-	<xsl:for-each select="$node/file">
-		<xsl:choose>
-			<xsl:when test="@extension = '.xsl'">
-				<task type="generate">
-					<meta>
-						<datasource_prefix>
-							<xsl:value-of select="$target"/>
-						</datasource_prefix>
-					</meta>
-					<source>
-						<xsl:value-of select="concat($source, '/', $path, '/', @name, @extension)"/>
-					</source>
-					<target>
-						<xsl:value-of select="concat($target, '/', $path)"/>
-					</target>
-				</task>
-			</xsl:when>
-			<xsl:when test="@extension = '.css'">
-				<task type="link">
-					<from>
-						<xsl:value-of select="concat($target, '/', $path, '/', @name, @extension)"/>
-					</from>
-					<to>
-						<xsl:value-of select="concat($source, '/', $path, '/', @name, @extension)"/>
-					</to>
-				</task>
-			</xsl:when>
-		</xsl:choose>
-	</xsl:for-each>
-</xsl:template>
-
-<xsl:template match="datasource">
-	<xsl:copy-of select="source"/>
-	<xsl:copy-of select="meta"/>
-
-	<tasks>
-		<task type="clean">
-			<path>
-				<xsl:value-of select="meta/target"/>
-			</path>
-		</task>
-
-		<xsl:call-template name="traverse">
-			<xsl:with-param name="source" select="$root/meta/source"/>
-			<xsl:with-param name="target" select="$root/meta/target"/>
-			<xsl:with-param name="node"   select="source"/>
-		</xsl:call-template>
-	</tasks>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/detail/process.xsl b/detail/process.xsl
deleted file mode 100644
index 7b596b6..0000000
--- a/detail/process.xsl
+++ /dev/null
@@ -1,250 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet
-	version="1.0"
-	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-	xmlns:dyn="http://exslt.org/dynamic"
-	xmlns:xalan="http://xml.apache.org/xalan"
-	xmlns:InputXSLT="function.inputxslt.application"
-	exclude-result-prefixes="dyn xalan InputXSLT"
->
-
-<xsl:output
-	method="xml"
-	omit-xml-declaration="yes"
-	encoding="UTF-8"
-	indent="no"
-/>
-
-<xsl:include href="../utility/datasource.xsl"/>
-
-<xsl:variable name="source_tree" select="$root/source"/>
-
-<xsl:template name="create_link">
-	<xsl:param name="from"/>
-	<xsl:param name="to"/>
-
-	<xsl:value-of select="InputXSLT:external-command(
-		concat('ln -sr ./', $to, ' ./', $from)
-	)/self::command/@result"/>
-</xsl:template>
-
-<xsl:template name="clean">
-	<xsl:param name="path"/>
-
-	<xsl:value-of select="InputXSLT:external-command(
-		concat('rm -r ./', $path, '; mkdir ./', $path)
-	)/self::command/@result"/>
-</xsl:template>
-
-<xsl:template name="generate">
-	<xsl:param name="input"/>
-	<xsl:param name="transformation"/>
-	<xsl:param name="target"/>
-
-	<xsl:variable name="generation_result" select="InputXSLT:generate(
-		$input,
-		$transformation,
-		$target
-	)/self::generation"/>
-
-	<subtask>
-		<xsl:attribute name="result">
-			<xsl:value-of select="$generation_result/@result"/>
-		</xsl:attribute>
-		<xsl:if test="$generation_result/@result = 'error'">
-			<log>
-				<xsl:copy-of select="$generation_result/error"/>
-			</log>
-		</xsl:if>
-
-		<target>
-			<xsl:value-of select="$target"/>
-		</target>
-	</subtask>
-</xsl:template>
-
-<xsl:template name="merge_datasource">
-	<xsl:param name="main"/>
-	<xsl:param name="support"/>
-
-	<datasource>
-		<xsl:copy-of select="$main"/>
-		<xsl:copy-of select="$support"/>
-	</datasource>
-</xsl:template>
-
-<xsl:template name="resolve_target">
-	<xsl:param name="prefix"/>
-	<xsl:param name="target"/>
-	<xsl:param name="datasource"/>
-
-	<xsl:choose>
-		<xsl:when test="$target/@mode = 'plain'">
-			<xsl:value-of select="concat($prefix, '/', $target/@value)"/>
-		</xsl:when>
-		<xsl:when test="$target/@mode = 'xpath'">
-			<xsl:value-of select="concat($prefix, '/', dyn:evaluate($target/@value))"/>
-		</xsl:when>
-	</xsl:choose>
-</xsl:template>
-
-<xsl:template name="resolve_datasource">
-	<xsl:param name="prefix"/>
-	<xsl:param name="datasource"/>
-
-	<xsl:for-each select="$datasource">
-		<xsl:element name="{@target}">
-			<xsl:choose>
-				<xsl:when test="@mode = 'full'">
-					<xsl:copy-of select="InputXSLT:read-file(
-						concat($prefix, '/', @source)
-					)/self::file/*/*"/>
-				</xsl:when>
-				<xsl:when test="@mode = 'expression'">
-					<xsl:copy-of select="dyn:evaluate(@source)"/>
-				</xsl:when>
-			</xsl:choose>
-		</xsl:element>
-	</xsl:for-each>
-</xsl:template>
-
-<xsl:template name="compile">
-	<xsl:param name="main"/>
-	<xsl:param name="support"/>
-	<xsl:param name="transformation"/>
-	<xsl:param name="datasource_prefix"/>
-	<xsl:param name="target_prefix"/>
-	<xsl:param name="target"/>
-
-	<xsl:variable name="datasource">
-		<xsl:call-template name="merge_datasource">
-			<xsl:with-param name="main" select="$main"/>
-			<xsl:with-param name="support">
-				<xsl:call-template name="resolve_datasource">
-					<xsl:with-param name="prefix"     select="$datasource_prefix"/>
-					<xsl:with-param name="datasource" select="$support"/>
-				</xsl:call-template>
-			</xsl:with-param>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="resolved_target">
-		<xsl:call-template name="resolve_target">
-			<xsl:with-param name="prefix"     select="$target_prefix"/>
-			<xsl:with-param name="target"     select="$target"/>
-			<xsl:with-param name="datasource" select="xalan:nodeset($datasource)/*[1]"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:call-template name="generate">
-		<xsl:with-param name="input"          select="$datasource"/>
-		<xsl:with-param name="transformation" select="$transformation"/>
-		<xsl:with-param name="target"         select="$resolved_target"/>
-	</xsl:call-template>
-</xsl:template>
-
-<xsl:template name="process">
-	<xsl:param name="task"/>
-
-	<xsl:variable name="transformation" select="InputXSLT:read-file($task/source)/self::file/node()"/>
-	<xsl:variable name="meta"           select="$transformation/self::*[name() = 'xsl:stylesheet']/*[name() = 'xsl:variable' and @name = 'meta']"/>
-	<xsl:variable name="main_source"    select="$meta/datasource[@type = 'main']"/>
-	<xsl:variable name="support_source" select="$meta/datasource[@type = 'support']"/>
-
-	<xsl:choose>
-		<xsl:when test="$main_source/@mode = 'iterate'">
-			<xsl:for-each select="InputXSLT:read-file(
-				concat($task/meta/datasource_prefix, '/', $main_source/@source)
-			)/self::file/*/entry">
-				<xsl:call-template name="compile">
-					<xsl:with-param name="main">
-						<xsl:element name="{$main_source/@target}">
-							<xsl:copy-of select="."/>
-						</xsl:element>
-					</xsl:with-param>
-					<xsl:with-param name="support"           select="$support_source"/>
-					<xsl:with-param name="transformation"    select="$transformation"/>
-					<xsl:with-param name="datasource_prefix" select="$task/meta/datasource_prefix"/>
-					<xsl:with-param name="target_prefix"     select="$task/target"/>
-					<xsl:with-param name="target"            select="$meta/target"/>
-				</xsl:call-template>
-			</xsl:for-each>
-		</xsl:when>
-		<xsl:otherwise>
-			<xsl:call-template name="compile">
-				<xsl:with-param name="main">
-					<xsl:choose>
-						<xsl:when test="$main_source/@mode = 'full'">
-							<xsl:element name="{$main_source/@target}">
-								<xsl:copy-of select="InputXSLT:read-file(
-									concat($task/meta/datasource_prefix, '/', $main_source/@source)
-								)/self::file/*/*"/>
-							</xsl:element>
-						</xsl:when>
-						<xsl:when test="$main_source/@mode = 'expression'">
-							<xsl:element name="{$main_source/@target}">
-								<xsl:copy-of select="dyn:evaluate($main_source/@source)"/>
-							</xsl:element>
-						</xsl:when>
-					</xsl:choose>
-				</xsl:with-param>
-				<xsl:with-param name="support"           select="$support_source"/>
-				<xsl:with-param name="transformation"    select="$transformation"/>
-				<xsl:with-param name="datasource_prefix" select="$task/meta/datasource_prefix"/>
-				<xsl:with-param name="target_prefix"     select="$task/target"/>
-				<xsl:with-param name="target"            select="$meta/target"/>
-			</xsl:call-template>
-		</xsl:otherwise>
-	</xsl:choose>
-</xsl:template>
-
-<xsl:template match="task[@type = 'clean']">
-	<xsl:copy>
-		<xsl:attribute name="result">
-			<xsl:call-template name="clean">
-				<xsl:with-param name="path" select="path"/>
-			</xsl:call-template>
-		</xsl:attribute>
-		<xsl:copy-of select="@* | node()"/>
-	</xsl:copy>
-</xsl:template>
-
-<xsl:template match="task[@type = 'generate']">
-	<xsl:variable name="results">
-		<xsl:call-template name="process">
-			<xsl:with-param name="task" select="."/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="total_count"   select="count(xalan:nodeset($results)/subtask)"/>
-	<xsl:variable name="success_count" select="count(xalan:nodeset($results)/subtask[@result = 'success'])"/>
-
-	<xsl:copy>
-		<xsl:attribute name="result">
-			<xsl:choose>
-				<xsl:when test="$success_count = $total_count">
-					<xsl:text>success</xsl:text>
-				</xsl:when>
-				<xsl:otherwise>
-					<xsl:text>error</xsl:text>
-				</xsl:otherwise>
-			</xsl:choose>
-		</xsl:attribute>
-		<xsl:copy-of select="@* | source"/>
-		<xsl:copy-of select="$results"/>
-	</xsl:copy>
-</xsl:template>
-
-<xsl:template match="task[@type = 'link']">
-	<xsl:copy>
-		<xsl:attribute name="result">
-			<xsl:call-template name="create_link">
-				<xsl:with-param name="from" select="from"/>
-				<xsl:with-param name="to"   select="to"/>
-			</xsl:call-template>
-		</xsl:attribute>
-		<xsl:copy-of select="@* | node()"/>
-	</xsl:copy>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/detail/summarize.xsl b/detail/summarize.xsl
deleted file mode 100644
index 0399507..0000000
--- a/detail/summarize.xsl
+++ /dev/null
@@ -1,75 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<xsl:stylesheet
-	version="1.0"
-	xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
->
-
-<xsl:output
-	method="text"
-	omit-xml-declaration="yes"
-	encoding="UTF-8"
-	indent="no"
-/>
-
-<xsl:template match="task[@result = 'error']">
-	<xsl:text>&#xa;Error #</xsl:text>
-	<xsl:value-of select="position()"/>
-	<xsl:text>: </xsl:text>
-
-	<xsl:choose>
-		<xsl:when test="@type = 'generate'">
-			<xsl:for-each select="subtask[@result = 'error']">
-				<xsl:text>Generation of "</xsl:text>
-				<xsl:value-of select="target"/>
-				<xsl:text>" failed.</xsl:text>
-
-				<xsl:for-each select="log/error">
-					<xsl:text>&#xa;</xsl:text>
-					<xsl:value-of select="."/>
-				</xsl:for-each>
-			</xsl:for-each>
-		</xsl:when>
-		<xsl:when test="@type = 'link'">
-			<xsl:text>Link from "</xsl:text>
-			<xsl:value-of select="from"/>
-			<xsl:text>" to "</xsl:text>
-			<xsl:value-of select="to"/>
-			<xsl:text>" failed.</xsl:text>
-		</xsl:when>
-		<xsl:when test="@type = 'clean'">
-			<xsl:text>Cleaning of "</xsl:text>
-			<xsl:value-of select="path"/>
-			<xsl:text>" failed.</xsl:text>
-		</xsl:when>
-		<xsl:otherwise>
-			<xsl:copy-of select="."/>
-		</xsl:otherwise>
-	</xsl:choose>
-</xsl:template>
-
-<xsl:template match="datasource">
-	<xsl:variable name="total_count"   select="count(task)"/>
-	<xsl:variable name="success_count" select="count(task[@result = 'success'])"/>
-
-	<xsl:text>Tasks processed:  </xsl:text>
-	<xsl:value-of select="$total_count"/>
-	<xsl:text>&#xa;</xsl:text>
-	<xsl:text>Tasks successful: </xsl:text>
-	<xsl:value-of select="$success_count"/>
-	<xsl:text>&#xa;</xsl:text>
-
-	<xsl:text>▶ Generation </xsl:text>
-	<xsl:choose>
-		<xsl:when test="$total_count = $success_count">
-			<xsl:text>successful</xsl:text>
-		</xsl:when>
-		<xsl:otherwise>
-			<xsl:text>failed</xsl:text>
-		</xsl:otherwise>
-	</xsl:choose>
-	<xsl:text>.&#xa;</xsl:text>
-
-	<xsl:apply-templates select="task[@result = 'error']"/>
-</xsl:template>
-
-</xsl:stylesheet>
-- 
cgit v1.2.3