From 1b930fa26dd955398fed2f4c239c2f62080cda61 Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Sat, 8 Sep 2018 12:12:47 +0200
Subject: [PATCH] preface.xml module / master TOC approach
---
Doc/lectures.xml | 76 ++-------------------------------------------
Doc/preface.xml | 81 ++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 83 insertions(+), 74 deletions(-)
create mode 100644 Doc/preface.xml
diff --git a/Doc/lectures.xml b/Doc/lectures.xml
index 7d01cea4f..496936f3d 100644
--- a/Doc/lectures.xml
+++ b/Doc/lectures.xml
@@ -64,80 +64,8 @@
</legalnotice>
</info>
- <preface xml:id="preface">
- <title>Preface</title>
-
- <para>This document is available in the following formats:</para>
-
- <itemizedlist>
- <listitem xml:id="prefaceFormatHtmlWebhelp">
- <para><link xlink:href="https://freedocs.mi.hdm-stuttgart.de">Online
- documentation</link> based on the <productname
- xlink:href="http://docbook.sourceforge.net/release/xsl/current/webhelp/docs">Web
- help</productname> format.</para>
- </listitem>
-
- <listitem xml:id="prefaceFormatEpub">
- <para><filename
- xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.epub">lectures.epub</filename>
- featuring the <xref linkend="glo_EPUB"/> 3 format 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><productname
- xlink:href="https://en.wikipedia.org/wiki/EPUB">Epub</productname>
- reader applications do vary supporting <xref linkend="glo_EPUB"/>
- 3.0 (<abbrev>e.g.</abbrev> formulas and <xref linkend="glo_SVG"/>
- images).</para>
- </caution>
-
- <para>Reader apps known to work well:</para>
-
- <itemizedlist>
- <listitem>
- <para><link xlink:href="http://gitden.com">Gitden
- reader</link></para>
- </listitem>
-
- <listitem>
- <para><link
- xlink:href="https://www.calibre-ebook.com">Calibre</link></para>
- </listitem>
-
- <listitem>
- <para>The author very much welcomes hints to appropriate <xref
- linkend="glo_EPUB"/> reader software accessing these pages.</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem xml:id="prefaceFormatPdf">
- <para><filename
- xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.pdf">lectures.pdf</filename>
- featuring the <xref linkend="glo_PDF"/> format (hopefully) providing
- improved printout typography.</para>
-
- <caution>
- <para>These lecture notes are heavily based both on external links
- and video resources. Using <xref linkend="glo_PDF"/> thus imposes
- media related limitations.</para>
- </caution>
- </listitem>
-
- <listitem xml:id="prefaceFormatZip">
- <para>Self contained zip archive <link
- xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.zip">lectures.zip</link>
- of above resources for offline usage excluding <filename
- xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.pdf">lectures.pdf</filename>
- and <filename
- xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.epub">lectures.epub</filename>
- .</para>
- </listitem>
- </itemizedlist>
- </preface>
-
+ <xi:include href="preface.xml" xpointer="element(/1)"/>
+
<part annotations="forumId=5;" xml:id="sd1">
<title>Software development 1</title>
diff --git a/Doc/preface.xml b/Doc/preface.xml
new file mode 100644
index 000000000..9b6fb4474
--- /dev/null
+++ b/Doc/preface.xml
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<preface version="5.1" 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:ns="http://docbook.org/ns/transclusion"
+ 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>
+
+ <itemizedlist>
+ <listitem xml:id="prefaceFormatHtmlWebhelp">
+ <para><link xlink:href="https://freedocs.mi.hdm-stuttgart.de">Online
+ documentation</link> based on the <productname
+ xlink:href="http://docbook.sourceforge.net/release/xsl/current/webhelp/docs">Web
+ help</productname> format.</para>
+ </listitem>
+
+ <listitem xml:id="prefaceFormatEpub">
+ <para><filename
+ xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.epub">lectures.epub</filename>
+ featuring the <xref linkend="glo_EPUB"/> 3 format 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><productname
+ xlink:href="https://en.wikipedia.org/wiki/EPUB">Epub</productname>
+ reader applications do vary supporting <xref linkend="glo_EPUB"/> 3.0
+ (<abbrev>e.g.</abbrev> formulas and <xref linkend="glo_SVG"/>
+ images).</para>
+ </caution>
+
+ <para>Reader apps known to work well:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para><link xlink:href="http://gitden.com">Gitden
+ reader</link></para>
+ </listitem>
+
+ <listitem>
+ <para><link
+ xlink:href="https://www.calibre-ebook.com">Calibre</link></para>
+ </listitem>
+
+ <listitem>
+ <para>The author very much welcomes hints to appropriate <xref
+ linkend="glo_EPUB"/> reader software accessing these pages.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem xml:id="prefaceFormatPdf">
+ <para><filename
+ xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.pdf">lectures.pdf</filename>
+ featuring the <xref linkend="glo_PDF"/> format (hopefully) providing
+ improved printout typography.</para>
+
+ <caution>
+ <para>These lecture notes are heavily based both on external links and
+ video resources. Using <xref linkend="glo_PDF"/> thus imposes media
+ related limitations.</para>
+ </caution>
+ </listitem>
+
+ <listitem xml:id="prefaceFormatZip">
+ <para>Self contained zip archive <link
+ xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.zip">lectures.zip</link>
+ of above resources for offline usage excluding <filename
+ xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.pdf">lectures.pdf</filename>
+ and <filename
+ xlink:href="https://freedocs.mi.hdm-stuttgart.de/lectures.epub">lectures.epub</filename>
+ .</para>
+ </listitem>
+ </itemizedlist>
+</preface>
--
GitLab