diff --git a/Doc/lectures.xml b/Doc/lectures.xml index eabc0ae164885afce1eb6a8561898faaed9877dc..257c78d3e0b5758b2567f75a6b101aebc70ab91f 100644 --- a/Doc/lectures.xml +++ b/Doc/lectures.xml @@ -38,7 +38,99 @@ </abstract> </info> - <xi:include href="preface.xml" xpointer="element(/1)"/> + <preface version="5.0" xml:id="preface"> + <title>Preface</title> + + <para>This document is available in the following formats:</para> + + <glosslist xml:id="availableFormats"> + <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/mobil">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><xref linkend="glo_EPUB"/> 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><xref linkend="glo_PDF"/> 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><link + xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/lectures.zip">lectures.zip</link></glossterm> + + <glossdef> + <para>Self contained zip archive of previously mentioned resources + for offline usage. Does contain the following offline links:</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> + + <mediaobject> + <imageobject> + <imagedata fileref="Sd1/Ref/Svg/freedocs.svg" scale="50"/> + </imageobject> + </mediaobject> + </preface> <part xml:id="sd1"> <title>Software development 1</title> diff --git a/Doc/preface.xml b/Doc/preface.xml deleted file mode 100644 index ae54dcc8b560d82403c45383d0e98de6f8853321..0000000000000000000000000000000000000000 --- a/Doc/preface.xml +++ /dev/null @@ -1,101 +0,0 @@ -<?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:xila="http://www.w3.org/2001/XInclude/local-attributes" - 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 xml:id="availableFormats"> - <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/mobil">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> <xref linkend="glo_EPUB"/> 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> <xref linkend="glo_PDF"/> 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><link - xlink:href="https://freedocs.mi.hdm-stuttgart.de/webhelp/lectures.zip">lectures.zip</link></glossterm> - - <glossdef> - <para>Self contained zip archive of previously mentioned resources for - offline usage. Does contain the following offline links:</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> - - <mediaobject> - <imageobject> - <imagedata fileref="Sd1/Ref/Svg/freedocs.svg" scale="50"/> - </imageobject> - </mediaobject> -</preface>