From 1569a6694d2d7ead94ce1bf5335a4cd862fce9d3 Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Fri, 15 Jan 2016 13:08:27 +0100
Subject: [PATCH] Preface containing meta info.
---
Doc/Makefile | 1 +
Doc/lectures.xml | 2 +
Doc/preface.xml | 100 ++++++++++++++++++++++++++++
ws/Docbook/Extensions/Tdata/fig.xml | 16 ++++-
4 files changed, 118 insertions(+), 1 deletion(-)
create mode 100644 Doc/preface.xml
diff --git a/Doc/Makefile b/Doc/Makefile
index 716d6b820..8560dca35 100644
--- a/Doc/Makefile
+++ b/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 \
diff --git a/Doc/lectures.xml b/Doc/lectures.xml
index 3f149122e..51c827cbd 100644
--- a/Doc/lectures.xml
+++ b/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>
diff --git a/Doc/preface.xml b/Doc/preface.xml
new file mode 100644
index 000000000..3fd14eefd
--- /dev/null
+++ b/Doc/preface.xml
@@ -0,0 +1,100 @@
+<?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>
diff --git a/ws/Docbook/Extensions/Tdata/fig.xml b/ws/Docbook/Extensions/Tdata/fig.xml
index 259568fcc..e813a06c9 100644
--- a/ws/Docbook/Extensions/Tdata/fig.xml
+++ b/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>
--
GitLab