Preface containing meta info.

Doc/Makefile

@@ -56,6 +56,7 @@ videoformats:$(mp4Set)
 
 all: ${BUILDROOT}/stage1
 	cd ${BUILDROOT}; tar c- ${DOCMODULES} | tar -x -C webhelp
+	cd ${BUILDROOT};zip -r webhelp/webhelp.zip webhelp -x webhelp/webhelp.zip
 #	cd ${BUILDROOT}; tar c- ${DOCMODULES} | tar -x -C ${BUILDNAVI} 
 
 ${BUILDROOT}/${SCRIPTBASENAME}_print.xml \

Doc/lectures.xml

@@ -37,6 +37,8 @@
     </abstract>
   </info>
 
+  <xi:include href="preface.xml" xpointer="element(/1)"/>
+
   <part xml:id="sd1">
     <title>Software development 1</title>
 

Doc/preface.xml

+<?xml version="1.0" encoding="UTF-8"?>
+<preface version="5.0" xml:id="preface" xmlns="http://docbook.org/ns/docbook"
+         xmlns:xlink="http://www.w3.org/1999/xlink"
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         xmlns:svg="http://www.w3.org/2000/svg"
+         xmlns:m="http://www.w3.org/1998/Math/MathML"
+         xmlns:html="http://www.w3.org/1999/xhtml"
+         xmlns:db="http://docbook.org/ns/docbook">
+  <title>Preface</title>
+
+  <para>This document is available in the following formats:</para>
+
+  <glosslist>
+    <glossentry>
+      <glossterm><uri
+      xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp">https://freedocs.mi.hdm-stuttgart.de/webhelp</uri></glossterm>
+
+      <glossdef>
+        <para>Online <productname
+        xlink:href="http://docbook.sourceforge.net/release/xsl/current/webhelp/docs">Web
+        help</productname> documentation.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm><uri
+      xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp">https://freedocs.mi.hdm-stuttgart.de/mobil</uri></glossterm>
+
+      <glossdef>
+        <para>Online documentation providing simplified navigation suitable
+        for (some) tablet readers.</para>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm><filename
+      xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/lectures.epub">lectures.epub</filename></glossterm>
+
+      <glossdef>
+        <para><productname
+        xlink:href="https://en.wikipedia.org/wiki/EPUB">Epub</productname>
+        containing <xref linkend="glo_SVG"/> images and MathML formulas based
+        on <link xlink:href="https://www.mathjax.org">MathJax
+        JavaScript</link> rendering.</para>
+
+        <caution>
+          <para>Some older <productname
+          xlink:href="https://en.wikipedia.org/wiki/EPUB">Epub</productname>
+          readers may not support current standards. <productname
+          xlink:href="http://calibre-ebook.com">Calibre</productname> is known
+          to work.</para>
+        </caution>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm><filename
+      xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/printversion.pdf">printversion.pdf</filename></glossterm>
+
+      <glossdef>
+        <para><productname
+        xlink:href="https://en.wikipedia.org/wiki/Portable_Document_Format">PDF</productname>
+        document providing sophisticated printout typography
+        (hopefully!).</para>
+
+        <caution>
+          <para>These lecture notes are heavily based both on external links
+          and video resources. Using <productname
+          xlink:href="https://en.wikipedia.org/wiki/Portable_Document_Format">PDF</productname>
+          thus imposes media related limitations.</para>
+        </caution>
+      </glossdef>
+    </glossentry>
+
+    <glossentry>
+      <glossterm><productname
+      xlink:href="http://docbook.sourceforge.net/release/xsl/current/webhelp/docs">Web
+      help</productname> zip archive</glossterm>
+
+      <glossdef>
+        <para><link
+        xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/lectures.zip">Zipped
+        archive</link> of all previously mentioned resources for offline
+        usage. Does contain the following offline versions:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para><filename
+            xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/printversion.pdf">printversion.pdf</filename></para>
+          </listitem>
+
+          <listitem>
+            <para><filename
+            xlink:href="lectures.epub">lectures.epub</filename></para>
+          </listitem>
+        </itemizedlist>
+      </glossdef>
+    </glossentry>
+  </glosslist>
+</preface>

ws/Docbook/Extensions/Tdata/fig.xml

@@ -7,7 +7,7 @@
       xmlns:html="http://www.w3.org/1999/xhtml"
       xmlns:db="http://docbook.org/ns/docbook">
   <info>
-    <title>Test img and mathml</title>
+    <title>Test images and <acronym>Mathml</acronym></title>
 
     <author>
       <personname><firstname/><surname/></personname>
@@ -20,6 +20,20 @@
     <pubdate/>
   </info>
 
+  <preface>
+    <title>Preface</title>
+
+    <itemizedlist>
+      <listitem>
+        <para>One</para>
+      </listitem>
+
+      <listitem>
+        <para>Two</para>
+      </listitem>
+    </itemizedlist>
+  </preface>
+
   <chapter xml:id="intro">
     <title>Introduction</title>