diff --git a/XmlCross/xmlcross.xml b/XmlCross/xmlcross.xml index ad342d69f8a0e2a8cb7abc9d9721f29caeed8d9e..61bc3e95d43882b95c5702143e8cacf8340bb1e1 100644 --- a/XmlCross/xmlcross.xml +++ b/XmlCross/xmlcross.xml @@ -1,10 +1,20 @@ <?xml version="1.0" encoding="UTF-8"?> -<book version="5.1" xml:id="xmlc" 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:trans="http://docbook.org/ns/transclusion" 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"> +<book version="5.1" xml:id="xmlc" 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:trans="http://docbook.org/ns/transclusion" + 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"> <info> <title>XML based Cross Media Publishing</title> <author> - <personname xlink:href="https://www.hdm-stuttgart.de/mi/kontakt/dozenten#goik"><firstname>Dr. Martin</firstname> <surname>Goik</surname></personname> + <personname + xlink:href="https://www.hdm-stuttgart.de/mi/kontakt/dozenten#goik"><firstname>Dr. + Martin</firstname> <surname>Goik</surname></personname> <affiliation> <address><link xlink:href="https://www.hdm-stuttgart.de/english">Stuttgart Media University / MI</link></address> @@ -15,6 +25,40 @@ <chapter annotations="slide" xml:id="chap_Overview"> <title>Overview</title> + <figure xml:id="xmlc_fig_author"> + <title>Getting started</title> + + <itemizedlist> + <listitem> + <para>Marting Goik (goik@hdm-stuttgart.de)</para> + </listitem> + + <listitem> + <para>Lecturer at <link + xlink:href="https://www.hdm-stuttgart.de/english">Stuttgart Media + University</link></para> + </listitem> + </itemizedlist> + </figure> + + <figure xml:id="xmlc_fig_install"> + <title>Practical stuff</title> + + <itemizedlist> + <listitem> + <para><link + xlink:href="http://www.xmlmind.com/xmleditor/download.shtml">XMLMind + editor personal edition</link></para> + </listitem> + + <listitem> + <para><link + xlink:href="https://www.oxygenxml.com/xml_editor.html">Oxygen XML + Editor 19</link></para> + </listitem> + </itemizedlist> + </figure> + <figure xml:id="xmlc_fig_whyXmlPublish"> <title>Why XML based publishing?</title> @@ -38,7 +82,8 @@ </listitem> <listitem> - <para>Xml core extensions (linking,...)</para> + <para><xref linkend="glo_XML"/> core extensions + (linking,...)</para> </listitem> </itemizedlist> </listitem> @@ -66,9 +111,12 @@ <figure xml:id="xmlc_fig_notAboutYou"> <title>Editors, compositors, designers ...</title> - <important> - <para>It's Not about You! It <emphasis role="bold">is</emphasis> about publishers.</para> - </important> + <para>Quote from <link + xlink:href="http://www.mulberrytech.com/papers/HowAndWhyXML/HowAndWhyXML.pdf">How + and Why Are Companies Using XML?</link>.</para> + + <para><emphasis role="bold">It's Not about You! It is about + publishers.</emphasis></para> <itemizedlist> <listitem> @@ -93,12 +141,10 @@ </itemizedlist> </listitem> </itemizedlist> - - <para>Quote from <link xlink:href="http://www.mulberrytech.com/papers/HowAndWhyXML/HowAndWhyXML.pdf">How and Why Are Companies Using XML?</link>.</para> </figure> - <figure xml:id="xmlc_fig_promiseContentProvider"> - <title>Promises</title> + <figure xml:id="xmlc_fig_publishPromises"> + <title>Promises in publishing</title> <para><xref linkend="glo_XML"/> for publishing ...</para> @@ -125,7 +171,42 @@ </itemizedlist> </figure> - <para>Single source publishing aims at creating different output formats from a given document source:</para> + <figure xml:id="xmlc_fig_publichReality"> + <title>Publishing reality</title> + + <itemizedlist> + <listitem> + <para>Refrain from fancy catalogs</para> + </listitem> + + <listitem> + <para>Stick to simple layouts</para> + + <itemizedlist> + <listitem> + <para>Technical documentation</para> + </listitem> + + <listitem> + <para>Law publications</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist> + </figure> + + <figure xml:id="xmlc_fig_exampleJavadoc"> + <title><xref linkend="glo_Javadoc"/></title> + + <mediaobject> + <imageobject> + <imagedata fileref="Ref/Intro/javaApi.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Single source publishing aims at creating different output formats + from a given document source:</para> <figure xml:id="xmlc_fig_MultiFormat"> <title>Single source publishing</title> @@ -137,7 +218,10 @@ </mediaobject> </figure> - <para>Conceptionally each format implements a view to our source in question. Separating a document's structure from its derived (visual) presentation greatly facilitates this task. From an abstract perspective we may conceive a document having:</para> + <para>Conceptionally each format implements a view to our source in + question. Separating a document's structure from its derived (visual) + presentation greatly facilitates this task. From an abstract perspective + we may conceive a document having:</para> <figure xml:id="xmlc_fig_DocSeparate"> <title>Separating Structure, content and format</title> @@ -149,7 +233,8 @@ </mediaobject> </figure> - <para>We shed some light on a document's structure and presentation:</para> + <para>We shed some light on a document's structure and + presentation:</para> <figure xml:id="xmlc_fig_StructureHtml"> <title>Example 1: HTML 5, pure structure</title> @@ -207,14 +292,16 @@ <td valign="top"><mediaobject> <imageobject> - <imagedata fileref="Ref/Latex/BaseExample/base.svg" valign="top"/> + <imagedata fileref="Ref/Latex/BaseExample/base.svg" + valign="top"/> </imageobject> </mediaobject></td> </tr> </informaltable> </figure> - <para>Separating a document's structure from its presentation(s) provides a number of benefits:</para> + <para>Separating a document's structure from its presentation(s) provides + a number of benefits:</para> <figure xml:id="xmlc_fig_benefitsBySeparation"> <title>Separating structure and presentation(s)</title> @@ -289,7 +376,8 @@ </listitem> <listitem> - <para>Automated generation supporting multiple output channels</para> + <para>Automated generation supporting multiple output + channels</para> </listitem> </itemizedlist> </figure> @@ -374,7 +462,8 @@ <glossdef> <itemizedlist> <listitem> - <para>Strictly validating, near WYSIWYG, DocBook / DITA / MathML / XHTML editor.</para> + <para>Strictly validating, near WYSIWYG, DocBook / DITA + / MathML / XHTML editor.</para> </listitem> <listitem> @@ -382,7 +471,8 @@ </listitem> <listitem> - <para>Cross-platform <xref linkend="glo_Java"/> based.</para> + <para>Cross-platform <xref linkend="glo_Java"/> + based.</para> </listitem> </itemizedlist> </glossdef> @@ -396,11 +486,13 @@ <glossdef> <itemizedlist> <listitem> - <para>Full-fledged <xref linkend="glo_XML"/> <xref linkend="glo_IDE"/>.</para> + <para>Full-fledged <xref linkend="glo_XML"/> <xref + linkend="glo_IDE"/>.</para> </listitem> <listitem> - <para>Strictly validating, near WYSIWYG, DocBook / DITA / MathML / XHTML ... editor.</para> + <para>Strictly validating, near WYSIWYG, DocBook / DITA + / MathML / XHTML ... editor.</para> </listitem> <listitem> @@ -445,15 +537,19 @@ <td valign="top"><itemizedlist> <listitem> - <para>Modular document <link xlink:href="http://www.sagehill.net/docbookxsl/ModularDoc.html" xlink:show="new">xinclude</link> support</para> + <para>Modular document <link + xlink:href="http://www.sagehill.net/docbookxsl/ModularDoc.html" + xlink:show="new">xinclude</link> support</para> </listitem> <listitem> - <para>Topic support (<link xlink:href="http://tdg.docbook.org/tdg/5.1/ch06.html">Assemblies</link>)</para> + <para>Topic support (<link + xlink:href="http://tdg.docbook.org/tdg/5.1/ch06.html">Assemblies</link>)</para> </listitem> <listitem> - <para><link xlink:href="https://www.w3.org/Math">MathML</link> support:</para> + <para><link xlink:href="https://www.w3.org/Math">MathML</link> + support:</para> <informalequation> <m:math display="block"> @@ -529,11 +625,14 @@ <itemizedlist> <listitem> - <para><link xlink:href="http://relaxng.org">RelaxNG</link> based schema</para> + <para><link xlink:href="http://relaxng.org">RelaxNG</link> + based schema</para> </listitem> <listitem> - <para><link xlink:href="https://en.wikipedia.org/wiki/Schematron">Schematron</link> rules</para> + <para><link + xlink:href="https://en.wikipedia.org/wiki/Schematron">Schematron</link> + rules</para> </listitem> </itemizedlist> </listitem> @@ -545,11 +644,16 @@ <itemizedlist> <listitem> - <para><link xlink:href="https://www.w3schools.com/xml/xsl_intro.asp">XSL</link> style sheets targeting HTML and <link xlink:href="http://w3schools.sinsixx.com/xslfo/default.asp.htm">FO</link></para> + <para><link + xlink:href="https://www.w3schools.com/xml/xsl_intro.asp">XSL</link> + style sheets targeting HTML and <link + xlink:href="http://w3schools.sinsixx.com/xslfo/default.asp.htm">FO</link></para> </listitem> <listitem> - <para><link xlink:href="http://www.sagehill.net/docbookxsl/UsingCSS.html">CSS</link> and JavaScript for generated HTML</para> + <para><link + xlink:href="http://www.sagehill.net/docbookxsl/UsingCSS.html">CSS</link> + and JavaScript for generated HTML</para> </listitem> </itemizedlist> </listitem> @@ -587,7 +691,9 @@ </listitem> <listitem> - <para>Eclipse help, e.g. <link xlink:href="http://help.eclipse.org/oxygen"><quote>Oxygen</quote> documentation</link></para> + <para>Eclipse help, e.g. <link + xlink:href="http://help.eclipse.org/oxygen"><quote>Oxygen</quote> + documentation</link></para> </listitem> </itemizedlist></td> @@ -624,11 +730,15 @@ <glossdef> <itemizedlist> <listitem> - <para><link xlink:href="http://www.xmlmind.com/xmleditor">XMLmind XML Editor</link></para> + <para><link + xlink:href="http://www.xmlmind.com/xmleditor">XMLmind + XML Editor</link></para> </listitem> <listitem> - <para><orgname>Oxygenxml</orgname> <link xlink:href="https://www.oxygenxml.com/xml_author.html">XML Author</link></para> + <para><orgname>Oxygenxml</orgname> <link + xlink:href="https://www.oxygenxml.com/xml_author.html">XML + Author</link></para> </listitem> </itemizedlist> </glossdef> @@ -645,10 +755,15 @@ <td valign="top"><glosslist> <glossentry> - <glossterm>XSLT <link xlink:href="http://www.sagehill.net/docbookxsl/XSLprocessors.html#XSLTprocessors">processors</link></glossterm> + <glossterm>XSLT <link + xlink:href="http://www.sagehill.net/docbookxsl/XSLprocessors.html#XSLTprocessors">processors</link></glossterm> <glossdef> - <para><link xlink:href="http://saxon.sourceforge.net/saxon6.5.5">Saxon 6.5.5</link>, <link xlink:href="http://xml.apache.org/xalan-j">Xalan</link>, ...</para> + <para><link + xlink:href="http://saxon.sourceforge.net/saxon6.5.5">Saxon + 6.5.5</link>, <link + xlink:href="http://xml.apache.org/xalan-j">Xalan</link>, + ...</para> </glossdef> </glossentry> @@ -658,15 +773,19 @@ <glossdef> <itemizedlist> <listitem> - <para>Apache <productname xlink:href="https://xmlgraphics.apache.org/fop">FOP</productname> (Open Source)</para> + <para>Apache <productname + xlink:href="https://xmlgraphics.apache.org/fop">FOP</productname> + (Open Source)</para> </listitem> <listitem> - <para>RenderX <productname xlink:href="http://www.renderx.com/tools/xep.html">xep</productname></para> + <para>RenderX <productname + xlink:href="http://www.renderx.com/tools/xep.html">xep</productname></para> </listitem> <listitem> - <para>Antenna House <productname xlink:href="https://www.antennahouse.com/antenna1/formatter/">formatter</productname></para> + <para>Antenna House <productname + xlink:href="https://www.antennahouse.com/antenna1/formatter/">formatter</productname></para> </listitem> </itemizedlist> </glossdef> @@ -689,7 +808,8 @@ </glossentry> <glossentry> - <glossterm><productname>Docbook</productname> 4.x (old / outdated)</glossterm> + <glossterm><productname>Docbook</productname> 4.x (old / + outdated)</glossterm> <glossdef> <para>Based on <xref linkend="glo_DTD"/> grammar</para> @@ -717,7 +837,9 @@ </listitem> <listitem> - <para><link xlink:href="http://www.sagehill.net/docbookxsl/HtmlOutput.html">Single or chunked</link> output</para> + <para><link + xlink:href="http://www.sagehill.net/docbookxsl/HtmlOutput.html">Single + or chunked</link> output</para> </listitem> <listitem> @@ -735,7 +857,9 @@ </listitem> <listitem> - <para>Client side full text search index by virtue of JavaScript (<link xlink:href="https://lucene.apache.org">Apache Lucene)</link></para> + <para>Client side full text search index by virtue of JavaScript + (<link xlink:href="https://lucene.apache.org">Apache + Lucene)</link></para> </listitem> <listitem> @@ -743,14 +867,16 @@ </listitem> <listitem> - <para>3-rd party tool integration e.g. <link xlink:href="https://www.mathjax.org">MathJax</link></para> + <para>3-rd party tool integration e.g. <link + xlink:href="https://www.mathjax.org">MathJax</link></para> </listitem> </itemizedlist> </figure> </section> <section xml:id="xmlc_sect_targetEclipseHelp"> - <title>Eclipse <link xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help.htm?cp=2_0_19_1">Help</link></title> + <title>Eclipse <link + xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help.htm?cp=2_0_19_1">Help</link></title> <figure xml:id="xmlc_fig_targetEclipsehelp"> <title>Eclipse help</title> @@ -773,11 +899,17 @@ </listitem> <listitem> - <para><link xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_standalone.htm?cp=2_0_19_1_0_1">Standalone</link> or <link xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm?cp=2_0_19_1_0_2">centralized</link></para> + <para><link + xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_standalone.htm?cp=2_0_19_1_0_1">Standalone</link> + or <link + xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_setup_infocenter.htm?cp=2_0_19_1_0_2">centralized</link></para> </listitem> <listitem> - <para><link xlink:href="http://www.wideskills.com/eclipse-plugin-tutorial/eclipse-plugin-help-tutorial">Plugin model</link>, Web App <link xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_war.htm?cp=2_0_19_1_4">deployable</link></para> + <para><link + xlink:href="http://www.wideskills.com/eclipse-plugin-tutorial/eclipse-plugin-help-tutorial">Plugin + model</link>, Web App <link + xlink:href="https://help.eclipse.org/oxygen/topic/org.eclipse.platform.doc.isv/guide/ua_help_war.htm?cp=2_0_19_1_4">deployable</link></para> </listitem> </itemizedlist></td> @@ -799,7 +931,9 @@ <itemizedlist> <listitem> - <para>Focus on <link xlink:href="http://www.cafeconleche.org/books/bible3/chapters/ch16.html">Formatting Objects</link></para> + <para>Focus on <link + xlink:href="http://www.cafeconleche.org/books/bible3/chapters/ch16.html">Formatting + Objects</link></para> </listitem> <listitem> @@ -817,10 +951,13 @@ <section xml:id="xmlc_sect_importantElements"> <title>Selected elements</title> - <para>We start by describing block elements being <xref linkend="glo_Docbook"/>'s building blocks.</para> + <para>We start by describing block elements being <xref + linkend="glo_Docbook"/>'s building blocks.</para> <section xml:id="xmlc_sect_paragraphElements"> - <title><link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.para.blocks">Paragraph elements</link></title> + <title><link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.para.blocks">Paragraph + elements</link></title> <figure xml:id="xmlc_fig_dbookPara"> <title>Paragraph</title> @@ -844,16 +981,21 @@ </tr> </informaltable> - <para>Caution: No style / formatting related parameters in <xref linkend="glo_Docbook"/>.</para> + <para>Caution: No style / formatting related parameters in <xref + linkend="glo_Docbook"/>.</para> <para>This is by design and on purpose.</para> - <para>Reference: See <link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.para.blocks">Paragraph elements</link>.</para> + <para>Reference: See <link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.para.blocks">Paragraph + elements</link>.</para> </figure> </section> <section xml:id="xmlc_sect_listElements"> - <title><link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.list.blocks">List elements</link></title> + <title><link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.list.blocks">List + elements</link></title> <figure xml:id="xmlc_fig_dbookItemizedList"> <title>Itemized list</title> @@ -1069,12 +1211,16 @@ <figure xml:id="xmlc_figure_listElementsReference"> <title>Reference</title> - <para>See <link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.list.blocks">List elements</link>.</para> + <para>See <link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.list.blocks">List + elements</link>.</para> </figure> </section> <section xml:id="xmlc_sect_formalElements"> - <title><link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.formal.blocks">Formal elements</link></title> + <title><link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.formal.blocks">Formal + elements</link></title> <figure xml:id="xmlc_fig_dbookTables"> <title>A table</title> @@ -1230,7 +1376,9 @@ <tr> <td colspan="2" valign="top"><informalequation> - <mathphrase>$ |x| = \left\{ \begin{array}{rl} -x &\mbox{if $x<0$} \\ x &\mbox{otherwise} \end{array} \right.$</mathphrase> + <mathphrase>$ |x| = \left\{ \begin{array}{rl} -x + &\mbox{if $x<0$} \\ x &\mbox{otherwise} + \end{array} \right.$</mathphrase> </informalequation></td> </tr> </informaltable> @@ -1239,12 +1387,16 @@ <figure xml:id="xmlc_figure_formalElementsReference"> <title>Reference</title> - <para>See <link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.formal.blocks">Formal elements</link>.</para> + <para>See <link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.formal.blocks">Formal + elements</link>.</para> </figure> </section> <section xml:id="xmlc_sect_graphicElements"> - <title><link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.graphic.blocks">Graphic elements</link></title> + <title><link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#plh.d3945e322153-db.graphic.blocks">Graphic + elements</link></title> <figure xml:id="xmlc_fig_dbookFigure"> <title>Figure</title> @@ -1257,7 +1409,8 @@ <tr> <td valign="top"><para>Mountain spring</para><mediaobject> <imageobject> - <imagedata fileref="Ref/DbookIntro/mountain.jpg" scale="50"/> + <imagedata fileref="Ref/DbookIntro/mountain.jpg" + scale="50"/> </imageobject> </mediaobject></td> @@ -1286,15 +1439,21 @@ <td valign="top"><para>.</para><mediaobject> <imageobjectco> <areaspec otherunits="imagemap" units="other"> - <area coords="83,16,340,187" linkends="fig_imagemapCallout_calloutSeat" xml:id="fig_imagemapCallout_seat"> + <area coords="83,16,340,187" + linkends="fig_imagemapCallout_calloutSeat" + xml:id="fig_imagemapCallout_seat"> <alt>Seat</alt> </area> - <area coords="112,335,151,370" linkends="fig_imagemapCallout_calloutValve" xml:id="fig_imagemapCallout_valveBack"> + <area coords="112,335,151,370" + linkends="fig_imagemapCallout_calloutValve" + xml:id="fig_imagemapCallout_valveBack"> <alt>Valve</alt> </area> - <area coords="511,345,550,380" linkends="fig_imagemapCallout_calloutValve" xml:id="fig_imagemapCallout_valveFront"> + <area coords="511,345,550,380" + linkends="fig_imagemapCallout_calloutValve" + xml:id="fig_imagemapCallout_valveFront"> <alt>Valve</alt> </area> </areaspec> @@ -1304,11 +1463,13 @@ </imageobject> <calloutlist> - <callout arearefs="fig_imagemapCallout_seat" xml:id="fig_imagemapCallout_calloutSeat"> + <callout arearefs="fig_imagemapCallout_seat" + xml:id="fig_imagemapCallout_calloutSeat"> <para>Seat</para> </callout> - <callout arearefs="fig_imagemapCallout_valveFront fig_imagemapCallout_valveBack" xml:id="fig_imagemapCallout_calloutValve"> + <callout arearefs="fig_imagemapCallout_valveFront fig_imagemapCallout_valveBack" + xml:id="fig_imagemapCallout_calloutValve"> <para>Valves</para> </callout> </calloutlist> @@ -1348,9 +1509,12 @@ <colgroup width="58%"/> <tr> - <td><para>Video courtesy of <link xlink:href="https://www.bigbuckbunny.org">Big Buck Bunny</link>.</para><mediaobject> + <td><para>Video courtesy of <link + xlink:href="https://www.bigbuckbunny.org">Big Buck + Bunny</link>.</para><mediaobject> <videoobject> - <videodata fileref="Ref/DbookIntro/movieBuckBunny.mp4" format="video/mp4"> + <videodata fileref="Ref/DbookIntro/movieBuckBunny.mp4" + format="video/mp4"> <multimediaparam name="controls" value="controls"/> </videodata> </videoobject> @@ -1398,7 +1562,16 @@ <figure xml:id="xmlc_figure_admonitionElementsReference"> <title>Reference</title> - <para>See <link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.admonition.blocks">Admonition elements</link>: <link xlink:href="http://tdg.docbook.org/tdg/5.1/important.html">important</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/note.html">note</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/tip.html">tip</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/warning.html">warning</link>.</para> + <para>See <link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html#d3945e322153-db.admonition.blocks">Admonition + elements</link>: <link + xlink:href="http://tdg.docbook.org/tdg/5.1/important.html">important</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/note.html">note</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/tip.html">tip</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/warning.html">warning</link>.</para> </figure> </section> @@ -1470,7 +1643,27 @@ </tr> </informaltable> - <para>See <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html">chapter</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/section.html">section</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect1.html">sect1</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect2.html">sect2</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect3.html">sect3</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect4.html">sect4</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">5</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">sect5</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/sect6.html">sect6</tag>, <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/simplesect.html">simplesect</tag>, <tag class="starttag" + <para>See <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html">chapter</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/section.html">section</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect1.html">sect1</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect2.html">sect2</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect3.html">sect3</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect4.html">sect4</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">5</tag>, <tag + class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">sect5</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/sect6.html">sect6</tag>, + <tag class="starttag" + xlink:href="http://tdg.docbook.org/tdg/5.1/simplesect.html">simplesect</tag>, + <tag class="starttag" xlink:href="http://tdg.docbook.org/tdg/5.1/refentry.html">refentry</tag>.</para> </figure> </section> @@ -1486,7 +1679,9 @@ <glossterm>Internal document links</glossterm> <glossdef> - <para>Referential integrity by <link xlink:href="http://rom1023.blogspot.de/2010/11/what-are-id-idref-and-idrefs-simple.html">ID / IDREF</link> constraints:</para> + <para>Referential integrity by <link + xlink:href="http://rom1023.blogspot.de/2010/11/what-are-id-idref-and-idrefs-simple.html">ID + / IDREF</link> constraints:</para> <programlisting language="xml"><chapter id="intro"> ... @@ -1522,11 +1717,14 @@ See <xref linkend="intro"/> ...</programlisting> </listitem> <listitem> - <para>Schema based options in <xref linkend="glo_Docbook"/> 5.x (RelaxNG) requiring an <tag class="starttag">info</tag> child in 5.1.</para> + <para>Schema based options in <xref linkend="glo_Docbook"/> 5.x + (RelaxNG) requiring an <tag class="starttag">info</tag> child in + 5.1.</para> </listitem> <listitem> - <para>No limitation in <xref linkend="glo_Docbook"/> 4.x (DTD).</para> + <para>No limitation in <xref linkend="glo_Docbook"/> 4.x + (DTD).</para> </listitem> </itemizedlist> </figure> @@ -1538,24 +1736,50 @@ See <xref linkend="intro"/> ...</programlisting> <tr> <td valign="top"><glosslist> <glossentry> - <glossterm><emphasis role="bold">Structure</emphasis></glossterm> + <glossterm><emphasis + role="bold">Structure</emphasis></glossterm> <glossdef> - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html">chapter</link></para> - - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/section.html">section</link> (recursive), <link xlink:href="http://tdg.docbook.org/tdg/5.1/sect1.html">sect1</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/sect2.html">sect2</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/sect3.html">sect3</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/sect4.html">sect4</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">sect5</link></para> - - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/refsection.html">refsection</link> (recursive), <link xlink:href="http://tdg.docbook.org/tdg/5.1/refsect1.html">refsect1</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/refsect2.html">refsect2</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/refsect3.html">refsect3</link></para> + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/chapter.html">chapter</link></para> + + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/section.html">section</link> + (recursive), <link + xlink:href="http://tdg.docbook.org/tdg/5.1/sect1.html">sect1</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/sect2.html">sect2</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/sect3.html">sect3</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/sect4.html">sect4</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/sect5.html">sect5</link></para> + + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/refsection.html">refsection</link> + (recursive), <link + xlink:href="http://tdg.docbook.org/tdg/5.1/refsect1.html">refsect1</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/refsect2.html">refsect2</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/refsect3.html">refsect3</link></para> </glossdef> </glossentry> </glosslist></td> <td valign="top"><glosslist> <glossentry> - <glossterm><emphasis role="bold">Big</emphasis></glossterm> + <glossterm><emphasis + role="bold">Big</emphasis></glossterm> <glossdef> - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/set.html">set</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/set.html">book</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/part.html">part</link></para> + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/set.html">set</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/set.html">book</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/part.html">part</link></para> </glossdef> </glossentry> </glosslist></td> @@ -1564,21 +1788,48 @@ See <xref linkend="intro"/> ...</programlisting> <tr> <td valign="top"><glosslist> <glossentry> - <glossterm><emphasis role="bold">Component</emphasis></glossterm> + <glossterm><emphasis + role="bold">Component</emphasis></glossterm> <glossdef> - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/acknowledgements.html">acknowledgements</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/appendix.html">appendix</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/bibliography.html">bibliography</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/colophon.html">colophon</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/dedication.html">dedication</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/glossary.html">glossary</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/index.html">index</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/para.html">para</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/preface.html">preface</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/refentry.html">refentry</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/reference.html">reference</link>, <link - xlink:href="http://tdg.docbook.org/tdg/5.1/setindex.html">setindex</link>, <link xlink:href="http://tdg.docbook.org/tdg/5.1/toc.html">toc</link></para> + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/acknowledgements.html">acknowledgements</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/appendix.html">appendix</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/bibliography.html">bibliography</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/colophon.html">colophon</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/dedication.html">dedication</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/glossary.html">glossary</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/index.html">index</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/para.html">para</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/preface.html">preface</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/refentry.html">refentry</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/reference.html">reference</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/setindex.html">setindex</link>, + <link + xlink:href="http://tdg.docbook.org/tdg/5.1/toc.html">toc</link></para> </glossdef> </glossentry> </glosslist></td> <td valign="top"><glosslist> <glossentry> - <glossterm><emphasis role="bold">Medium</emphasis></glossterm> + <glossterm><emphasis + role="bold">Medium</emphasis></glossterm> <glossdef> - <para><link xlink:href="http://tdg.docbook.org/tdg/5.1/article.html">article</link></para> + <para><link + xlink:href="http://tdg.docbook.org/tdg/5.1/article.html">article</link></para> </glossdef> </glossentry> </glosslist></td> @@ -1602,12 +1853,16 @@ See <xref linkend="intro"/> ...</programlisting> </figure> <figure xml:id="xmlc_fig_schematronIdPermalink"> - <title>Example: <code>xml:id</code> and <xref linkend="glo_permalink"/></title> + <title>Example: <code>xml:id</code> and <xref + linkend="glo_permalink"/></title> <informaltable border="1"> <tr> - <td valign="top"><programlisting language="xml"><chapter id="introduction" <co linkends="xmlc_colist_permalink-1" xml:id="xmlc_colist_permalink-1-co"/>> ... - <section xml:id="firstSection" <coref linkend="xmlc_colist_permalink-2-co"/>> + <td valign="top"><programlisting language="xml"><chapter id="introduction" <co + linkends="xmlc_colist_permalink-1" + xml:id="xmlc_colist_permalink-1-co"/>> ... + <section xml:id="firstSection" <coref + linkend="xmlc_colist_permalink-2-co"/>> <title>First section</title> <para>A stable link</para> </section> @@ -1618,40 +1873,56 @@ See <xref linkend="intro"/> ...</programlisting> <td valign="top"><programlisting language="xml"><!-- file introduction.html --> <html> ... -<h2 id="firstSection" <co linkends="xmlc_colist_permalink-2" xml:id="xmlc_colist_permalink-2-co"/>>First section</h2> +<h2 id="firstSection" <co linkends="xmlc_colist_permalink-2" + xml:id="xmlc_colist_permalink-2-co"/>>First section</h2> <p>A stable link</p> -<h2 id="d03213" <co linkends="xmlc_colist_permalink-3" xml:id="xmlc_colist_permalink-3-co"/>>Second section</h2> +<h2 id="d03213" <co linkends="xmlc_colist_permalink-3" + xml:id="xmlc_colist_permalink-3-co"/>>Second section</h2> <p>No stable link</p></programlisting></td> </tr> </informaltable> <calloutlist> - <callout arearefs="xmlc_colist_permalink-1-co" xml:id="xmlc_colist_permalink-1"> - <para>Defining chunk's base name <filename>introduction.html</filename>.</para> + <callout arearefs="xmlc_colist_permalink-1-co" + xml:id="xmlc_colist_permalink-1"> + <para>Defining chunk's base name + <filename>introduction.html</filename>.</para> </callout> - <callout arearefs="xmlc_colist_permalink-2-co" xml:id="xmlc_colist_permalink-2"> - <para>Stable target <uri>http://...introduction.html#firstSection</uri>.</para> + <callout arearefs="xmlc_colist_permalink-2-co" + xml:id="xmlc_colist_permalink-2"> + <para>Stable target + <uri>http://...introduction.html#firstSection</uri>.</para> </callout> - <callout arearefs="xmlc_colist_permalink-3-co" xml:id="xmlc_colist_permalink-3"> - <para>Instable target <uri>http://...introduction.html#d03213</uri>.</para> + <callout arearefs="xmlc_colist_permalink-3-co" + xml:id="xmlc_colist_permalink-3"> + <para>Instable target + <uri>http://...introduction.html#d03213</uri>.</para> </callout> </calloutlist> </figure> <figure xml:id="xmlc_fig_permalinkDisplayScreenshot"> - <title>Using <link xlink:href="https://github.com/Rob--W/display-anchors">Display #Anchors</link></title> + <title>Using <link + xlink:href="https://github.com/Rob--W/display-anchors">Display + #Anchors</link></title> <mediaobject> <imageobjectco> <areaspec otherunits="imagemap" units="other"> - <area coords="357,43,453,90" linkends="xmlc_callout_permalink-id01" xml:id="xmlc_area_permalink-id01"/> + <area coords="357,43,453,90" + linkends="xmlc_callout_permalink-id01" + xml:id="xmlc_area_permalink-id01"/> - <area coords="422,92,575,128" linkends="xmlc_callout_permalink-id02" xml:id="xmlc_area_permalink-id02"/> + <area coords="422,92,575,128" + linkends="xmlc_callout_permalink-id02" + xml:id="xmlc_area_permalink-id02"/> - <area coords="467,170,588,214" linkends="xmlc_callout_permalink-id03" xml:id="xmlc_area_permalink-id03"/> + <area coords="467,170,588,214" + linkends="xmlc_callout_permalink-id03" + xml:id="xmlc_area_permalink-id03"/> </areaspec> <imageobject> @@ -1661,29 +1932,39 @@ See <xref linkend="intro"/> ...</programlisting> </mediaobject> <calloutlist> - <callout arearefs="xmlc_area_permalink-id01" xml:id="xmlc_callout_permalink-id01"> - <para>The page's URI based on <code>xml:id</code> value <code>introduction</code>.</para> + <callout arearefs="xmlc_area_permalink-id01" + xml:id="xmlc_callout_permalink-id01"> + <para>The page's URI based on <code>xml:id</code> value + <code>introduction</code>.</para> </callout> - <callout arearefs="xmlc_area_permalink-id02" xml:id="xmlc_callout_permalink-id02"> - <para>Stable <uri>https://.../introduction.html#firstSection</uri>.</para> + <callout arearefs="xmlc_area_permalink-id02" + xml:id="xmlc_callout_permalink-id02"> + <para>Stable + <uri>https://.../introduction.html#firstSection</uri>.</para> </callout> - <callout arearefs="xmlc_area_permalink-id03" xml:id="xmlc_callout_permalink-id03"> - <para>Unstable <uri>https://.../introduction.html#d03213</uri></para> + <callout arearefs="xmlc_area_permalink-id03" + xml:id="xmlc_callout_permalink-id03"> + <para>Unstable + <uri>https://.../introduction.html#d03213</uri></para> </callout> </calloutlist> </figure> <figure xml:id="xmlc_fig_permalinkConclusion"> - <title>Considerations author based <xref linkend="glo_permalink"/></title> + <title>Considerations author based <xref + linkend="glo_permalink"/></title> <glosslist> <glossentry> <glossterm>Requirement</glossterm> <glossdef> - <para>Important elements (<tag class="starttag">chapter</tag>, <tag class="starttag">section</tag>, <tag class="starttag">table</tag>...) must provide an <property>xml:id</property> value.</para> + <para>Important elements (<tag class="starttag">chapter</tag>, + <tag class="starttag">section</tag>, <tag + class="starttag">table</tag>...) must provide an + <property>xml:id</property> value.</para> </glossdef> </glossentry> @@ -1695,11 +1976,13 @@ See <xref linkend="intro"/> ...</programlisting> <listitem> <para>Modify underlying RelaxNG schema.</para> - <para>Result: Restricted schema (Inheritance relationship)</para> + <para>Result: Restricted schema (Inheritance + relationship)</para> </listitem> <listitem> - <para>Add <xref linkend="glo_Schematron"/> integrity rule on top of schema.</para> + <para>Add <xref linkend="glo_Schematron"/> integrity rule on + top of schema.</para> </listitem> </itemizedlist> </glossdef> @@ -1708,7 +1991,8 @@ See <xref linkend="intro"/> ...</programlisting> </figure> <figure xml:id="xmlc_fig_schematronPermalink"> - <title><xref linkend="glo_Schematron"/> <xref linkend="glo_permalink"/> rule</title> + <title><xref linkend="glo_Schematron"/> <xref + linkend="glo_permalink"/> rule</title> <programlisting language="xml"><s:pattern> <s:title>Mandatory Id definition constraint</s:title> @@ -1737,7 +2021,8 @@ See <xref linkend="intro"/> ...</programlisting> <title><xref linkend="glo_Docbook"/> XSL built in parameters</title> <figure xml:id="xmlc_fig_htmlCustomizeByParameterUseIdAsFilename"> - <title>Customization parameter <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/html/use.id.as.filename.html">use.id.as.filename</link></title> + <title>Customization parameter <link + xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/html/use.id.as.filename.html">use.id.as.filename</link></title> <mediaobject> <imageobject> @@ -1747,7 +2032,8 @@ See <xref linkend="intro"/> ...</programlisting> </figure> <figure xml:id="xmlc_fig_htmlCustomizeByParameterUlinkTarget"> - <title>Customization parameter <link xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ulink.target.html">ulink.target</link></title> + <title>Customization parameter <link + xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/html/ulink.target.html">ulink.target</link></title> <mediaobject> <imageobject> @@ -1757,29 +2043,41 @@ See <xref linkend="intro"/> ...</programlisting> </figure> <qandaset defaultlabel="qanda" xml:id="xmlc_qanda_docbookParamXmlmind"> - <title>Tweaking <xref linkend="glo_Docbook"/> transformation parameter.</title> + <title>Tweaking <xref linkend="glo_Docbook"/> transformation + parameter.</title> <qandadiv> <qandaentry> <question> - <para>Configure the <xref linkend="glo_XMLMind"/> editor using <property>use.id.as.filename=1</property> and <property>ulink.target=_blank</property> for <xref linkend="glo_Docbook"/> transformations into the <acronym>webhelp</acronym> format.</para> + <para>Configure the <xref linkend="glo_XMLMind"/> editor using + <property>use.id.as.filename=1</property> and + <property>ulink.target=_blank</property> for <xref + linkend="glo_Docbook"/> transformations into the + <acronym>webhelp</acronym> format.</para> <tip> <itemizedlist> <listitem> - <para>Consider <option>Options</option> --> <option>Customize Configuration</option> --> <option>Customize Document Conversion Stylesheets</option> </para> + <para>Consider <option>Options</option> --> + <option>Customize Configuration</option> --> + <option>Customize Document Conversion + Stylesheets</option></para> </listitem> <listitem> - <para>Choose <quote>Convert to <acronym>Webhelp</acronym></quote>.</para> + <para>Choose <quote>Convert to + <acronym>Webhelp</acronym></quote>.</para> </listitem> <listitem> - <para>Hit <quote>Customize</quote> creating a local file permanently storing your modifications.</para> + <para>Hit <quote>Customize</quote> creating a local file + permanently storing your modifications.</para> </listitem> <listitem> - <para>Hit <quote>Edit</quote>, then choose <quote>Parameters</quote> and add the desired property values.</para> + <para>Hit <quote>Edit</quote>, then choose + <quote>Parameters</quote> and add the desired property + values.</para> </listitem> </itemizedlist> </tip> @@ -1793,14 +2091,17 @@ See <xref linkend="intro"/> ...</programlisting> <itemizedlist> <listitem> - <para><link xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/param.html">DocBook XSL Stylesheets User Reference: Parameters</link></para> + <para><link + xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/param.html">DocBook + XSL Stylesheets User Reference: Parameters</link></para> </listitem> </itemizedlist> </figure> </section> <section xml:id="xmlc_sect_customizeHtmlByXsl"> - <title><xref linkend="glo_Docbook"/> <xref linkend="glo_XSL"/> style sheets</title> + <title><xref linkend="glo_Docbook"/> <xref linkend="glo_XSL"/> style + sheets</title> <figure xml:id="xmlc_fig_customizeHtmlByXsl"> <title>Hooking into XSL</title> @@ -1817,7 +2118,9 @@ See <xref linkend="intro"/> ...</programlisting> <itemizedlist> <listitem> - <para><link xlink:href="http://www.sagehill.net/docbookxsl/CustomizingPart.html">Customizing DocBook XSL</link></para> + <para><link + xlink:href="http://www.sagehill.net/docbookxsl/CustomizingPart.html">Customizing + DocBook XSL</link></para> </listitem> </itemizedlist> </figure> @@ -1837,15 +2140,20 @@ See <xref linkend="intro"/> ...</programlisting> </figure> <qandaset defaultlabel="qanda" xml:id="xmlc_qanda_docbookCssXmlmind"> - <title>Tweaking <xref linkend="glo_Docbook"/>'s default <xref linkend="glo_CSS"/>.</title> + <title>Tweaking <xref linkend="glo_Docbook"/>'s default <xref + linkend="glo_CSS"/>.</title> <qandadiv> <qandaentry> <question> - <para>Configure the <xref linkend="glo_XMLMind"/> editor to show <tag class="starttag">tip</tag> elements having a green background.</para> + <para>Configure the <xref linkend="glo_XMLMind"/> editor to + show <tag class="starttag">tip</tag> elements having a green + background.</para> <tip> - <para>Follow the tip from <xref linkend="xmlc_qanda_docbookParamXmlmind"/>. The menu allows for <xref linkend="glo_CSS"/> redefinitions as well.</para> + <para>Follow the tip from <xref + linkend="xmlc_qanda_docbookParamXmlmind"/>. The menu allows + for <xref linkend="glo_CSS"/> redefinitions as well.</para> </tip> </question> </qandaentry> @@ -1931,20 +2239,25 @@ See <xref linkend="intro"/> ...</programlisting> xmlns="http://docbook.org/ns/docbook"> <chapter version="5.1" xml:id="start"> <title>Start</title> - <para>See <xref linkend="intro" <co linkends="xmlc_cout_monolithicInternalLink-1" xml:id="xmlc_cout_monolithicInternalLink-1-co"/>/>.</para> + <para>See <xref linkend="intro" <co + linkends="xmlc_cout_monolithicInternalLink-1" + xml:id="xmlc_cout_monolithicInternalLink-1-co"/>/>.</para> </chapter> - <chapter xml:id="intro" <co linkends="xmlc_cout_monolithicInternalLink-2" xml:id="xmlc_cout_monolithicInternalLink-2-co"/>> + <chapter xml:id="intro" <co linkends="xmlc_cout_monolithicInternalLink-2" + xml:id="xmlc_cout_monolithicInternalLink-2-co"/>> <title>Introduction</title> <para>Basic stuff.</para> </chapter> </book></programlisting> <calloutlist> - <callout arearefs="xmlc_cout_monolithicInternalLink-1-co" xml:id="xmlc_cout_monolithicInternalLink-1"> + <callout arearefs="xmlc_cout_monolithicInternalLink-1-co" + xml:id="xmlc_cout_monolithicInternalLink-1"> <para>An internal link.</para> </callout> - <callout arearefs="xmlc_cout_monolithicInternalLink-2-co" xml:id="xmlc_cout_monolithicInternalLink-2"> + <callout arearefs="xmlc_cout_monolithicInternalLink-2-co" + xml:id="xmlc_cout_monolithicInternalLink-2"> <para>Internal link target.</para> </callout> </calloutlist> @@ -1955,17 +2268,28 @@ See <xref linkend="intro"/> ...</programlisting> <informaltable border="1"> <tr> - <td rowspan="2" valign="top"><para>master.xml</para><programlisting language="xml"><book version="5.1" <co linkends="xmlc_cout_masterExample-1" xml:id="xmlc_cout_masterExample-1-co"/> + <td rowspan="2" valign="top"><para>master.xml</para><programlisting + language="xml"><book version="5.1" <co + linkends="xmlc_cout_masterExample-1" + xml:id="xmlc_cout_masterExample-1-co"/> xmlns="http://docbook.org/ns/docbook" - xmlns:xi="http://www.w3.org/2001/XInclude"> <co linkends="xmlc_cout_masterExample-2" xml:id="xmlc_cout_masterExample-2-co"/> - <xi:include href="start.xml" <co linkends="xmlc_cout_masterExample-3" xml:id="xmlc_cout_masterExample-3-co"/> - xpointer="element(/1)"/> <co linkends="xmlc_cout_masterExample-4" xml:id="xmlc_cout_masterExample-4-co"/> - - <xi:include href="intro.xml" <co linkends="xmlc_cout_masterExample-5" xml:id="xmlc_cout_masterExample-5-co"/> - xpointer="element(/1)"/> <co linkends="xmlc_cout_masterExample-6" xml:id="xmlc_cout_masterExample-6-co"/> + xmlns:xi="http://www.w3.org/2001/XInclude"> <co + linkends="xmlc_cout_masterExample-2" + xml:id="xmlc_cout_masterExample-2-co"/> + <xi:include href="start.xml" <co linkends="xmlc_cout_masterExample-3" + xml:id="xmlc_cout_masterExample-3-co"/> + xpointer="element(/1)"/> <co linkends="xmlc_cout_masterExample-4" + xml:id="xmlc_cout_masterExample-4-co"/> + + <xi:include href="intro.xml" <co linkends="xmlc_cout_masterExample-5" + xml:id="xmlc_cout_masterExample-5-co"/> + xpointer="element(/1)"/> <co linkends="xmlc_cout_masterExample-6" + xml:id="xmlc_cout_masterExample-6-co"/> </book></programlisting></td> - <td valign="top"><para>start.xml</para><programlisting language="xml"><chapter version="5.1" <coref linkend="xmlc_cout_masterExample-1-co"/> + <td valign="top"><para>start.xml</para><programlisting + language="xml"><chapter version="5.1" <coref + linkend="xmlc_cout_masterExample-1-co"/> xmlns="http://docbook.org/ns/docbook"> <title>Start</title> <para>See @@ -1974,7 +2298,9 @@ xmlns="http://docbook.org/ns/docbook"> </tr> <tr> - <td valign="top"><para>intro.xml</para><programlisting language="xml"><chapter version="5.1" <coref linkend="xmlc_cout_masterExample-1-co"/> + <td valign="top"><para>intro.xml</para><programlisting + language="xml"><chapter version="5.1" <coref + linkend="xmlc_cout_masterExample-1-co"/> xmlns="http://docbook.org/ns/docbook"> <title>Introduction</title> <para>Basic stuff.</para> @@ -1986,29 +2312,35 @@ xmlns="http://docbook.org/ns/docbook"> <informaltable border="0"> <tr> <td><calloutlist> - <callout arearefs="xmlc_cout_masterExample-1-co" xml:id="xmlc_cout_masterExample-1"> + <callout arearefs="xmlc_cout_masterExample-1-co" + xml:id="xmlc_cout_masterExample-1"> <para><xref linkend="glo_Docbook"/> namespace and version</para> </callout> - <callout arearefs="xmlc_cout_masterExample-2-co" xml:id="xmlc_cout_masterExample-2"> + <callout arearefs="xmlc_cout_masterExample-2-co" + xml:id="xmlc_cout_masterExample-2"> <para>XInclude namespace</para> </callout> - <callout arearefs="xmlc_cout_masterExample-3-co" xml:id="xmlc_cout_masterExample-3"> + <callout arearefs="xmlc_cout_masterExample-3-co" + xml:id="xmlc_cout_masterExample-3"> <para>Filename reference</para> </callout> </calloutlist></td> <td><calloutlist> - <callout arearefs="xmlc_cout_masterExample-4-co" xml:id="xmlc_cout_masterExample-4"> + <callout arearefs="xmlc_cout_masterExample-4-co" + xml:id="xmlc_cout_masterExample-4"> <para>component reference</para> </callout> - <callout arearefs="xmlc_cout_masterExample-5-co" xml:id="xmlc_cout_masterExample-5"> + <callout arearefs="xmlc_cout_masterExample-5-co" + xml:id="xmlc_cout_masterExample-5"> <para>Filename reference</para> </callout> - <callout arearefs="xmlc_cout_masterExample-6-co" xml:id="xmlc_cout_masterExample-6"> + <callout arearefs="xmlc_cout_masterExample-6-co" + xml:id="xmlc_cout_masterExample-6"> <para>component reference</para> </callout> </calloutlist></td> @@ -2020,23 +2352,33 @@ xmlns="http://docbook.org/ns/docbook"> <title>RelaxNG Schema</title> <figure xml:id="xmlc_fig_xmlSchemaLanguages"> - <title>XML grammar defining <link xlink:href="https://en.wikipedia.org/wiki/XML_schema#Languages">languages</link></title> + <title>XML grammar defining <link + xlink:href="https://en.wikipedia.org/wiki/XML_schema#Languages">languages</link></title> <orderedlist> <listitem> - <para><emphasis role="bold">RE</emphasis>gular <emphasis role="bold">LA</emphasis>nguage for <emphasis role="bold">X</emphasis>ML <emphasis role="bold">N</emphasis>ext <emphasis role="bold">G</emphasis>eneration <link xlink:href="http://relaxng.org/tutorial-20011203.html">(RelaxNG)</link></para> + <para><emphasis role="bold">RE</emphasis>gular <emphasis + role="bold">LA</emphasis>nguage for <emphasis + role="bold">X</emphasis>ML <emphasis role="bold">N</emphasis>ext + <emphasis role="bold">G</emphasis>eneration <link + xlink:href="http://relaxng.org/tutorial-20011203.html">(RelaxNG)</link></para> </listitem> <listitem> - <para><link xlink:href="https://www.xml.com/pub/a/2003/11/12/schematron.html">Schematron</link></para> + <para><link + xlink:href="https://www.xml.com/pub/a/2003/11/12/schematron.html">Schematron</link></para> </listitem> <listitem> - <para>XML Schema <link xlink:href="https://www.w3schools.com/xml/schema_intro.asp">(XSD)</link></para> + <para>XML Schema <link + xlink:href="https://www.w3schools.com/xml/schema_intro.asp">(XSD)</link></para> </listitem> <listitem> - <para><emphasis role="bold">D</emphasis>ocument <emphasis role="bold">T</emphasis>ype <emphasis role="bold">D</emphasis>efinition <link xlink:href="https://www.w3schools.com/xml/xml_dtd_intro.asp">(DTD)</link></para> + <para><emphasis role="bold">D</emphasis>ocument <emphasis + role="bold">T</emphasis>ype <emphasis + role="bold">D</emphasis>efinition <link + xlink:href="https://www.w3schools.com/xml/xml_dtd_intro.asp">(DTD)</link></para> </listitem> </orderedlist> </figure> @@ -2081,7 +2423,10 @@ xmlns="http://docbook.org/ns/docbook"> <qandadiv> <qandaentry> <question> - <para>Use <link xlink:href="https://www.oxygenxml.com/xml_editor.html">Oxygen XML Editor</link> to create a RelaxNG <filename>book.rng</filename> schema suiting the subsequent document sample:</para> + <para>Use <link + xlink:href="https://www.oxygenxml.com/xml_editor.html">Oxygen XML + Editor</link> to create a RelaxNG <filename>book.rng</filename> + schema suiting the subsequent document sample:</para> <programlisting language="xml"><book> <chapter> @@ -2099,19 +2444,26 @@ xmlns="http://docbook.org/ns/docbook"> <itemizedlist> <listitem> - <para>Valid documents must start with <tag class="starttag">book</tag>.</para> + <para>Valid documents must start with <tag + class="starttag">book</tag>.</para> </listitem> <listitem> - <para>A <tag class="starttag">book</tag> element must have at least one <tag class="starttag">chapter</tag>.</para> + <para>A <tag class="starttag">book</tag> element must have at + least one <tag class="starttag">chapter</tag>.</para> </listitem> <listitem> - <para>Each <tag class="starttag">chapter</tag> has (exactly one) a <tag class="starttag">title</tag> which is being followed by at least one <tag class="starttag">paragraph</tag>.</para> + <para>Each <tag class="starttag">chapter</tag> has (exactly + one) a <tag class="starttag">title</tag> which is being + followed by at least one <tag + class="starttag">paragraph</tag>.</para> </listitem> <listitem> - <para>The elements <tag class="starttag">title</tag> and <tag class="starttag">paragraph</tag> consist of ordinary text.</para> + <para>The elements <tag class="starttag">title</tag> and <tag + class="starttag">paragraph</tag> consist of ordinary + text.</para> </listitem> </itemizedlist> </question>