daps-init: also include example for set

[tomschr]

Reported by taroth21 on 2013-01-17 15:25 UTC
Maybe we can provide a sort of "daps-init" for advanced users. It should include: a set (DC + example XML files), including profiling, remarks, XML comments. This would help to ensure more consistency in the examples and commands mentioned in the DAPS User Guide, as we could refer to concrete example files (XML or DC files) also for the more advanced stuff. Currently, this is only possible for anything related to book or article.

I don't know if it make sense to implement this as on option to the existing daps-init or to rather create a separate script for this (daps-init-advanced)?

If possible, we can also base this on the existing examples in the User Guide chapters (see daps_user_modularize.xml or daps_user_review.xml).

[tomschr]

Commented by taroth21 on 2013-01-17 15:31
For the chapters, forgot to mention daps_user_concept.xml, which holds an example for a set (admittedly, not the most original example...) ;)

[tomschr]

Here is a short, but incomplete example.

Tasks would be:

• Add some more elements: more sections, maybe another book etc. to be useful.
• Save it as init_templates/MAIN.db5-set.template
• Create another file for DocBook4 and save it as init_templates/MAIN.db4-set.template
• Probably extend the DAPS User Guide
• Edit the usage guide for daps-init

<set xmlns="http://docbook.org/ns/docbook"
 xmlns:xi="http://www.w3.org/2001/XInclude"
 xmlns:xlink="http://www.w3.org/1999/xlink" version="5.1">
 <title>Example Set</title>
 <info/>

 <book xml:id="book.a">
  <info>
   <title>§§TITLE§§</title>
   <subtitle>generated by DAPS</subtitle>
   <releaseinfo>Version 0.1</releaseinfo>
   <releaseinfo>Revision: 0</releaseinfo>
   <date>§§DATE§§</date>
   <legalnotice>
    <para>
     <link xlink:href="http://www.gnu.org/licenses/fdl-1.3-standalone.html">GNU
      Free Documentation License</link>
    </para>
   </legalnotice>
  </info>
  <!--  -->
  <chapter xml:id="cha.template.examples">
  <title>Examples: the most commonly used DocBook XML constructs</title>
  <info>
   <abstract>
    <para> You may use this file as a template. For a complete
    DocBook reference, see
    <citetitle>DocBook: The Definitive Guide</citetitle>
    (<link xlink:href="http://www.docbook.org/tdg51/en/html/docbook.html"/>).
    </para>
   </abstract>
  </info>
  </chapter>
 </book>
 
 <!-- <book xml:id="book.b"> -->
 
</set>