Uploaded image for project: 'Solder'
  1. Solder
  2. SOLDER-145

Add front matter to reference guide

        Details

        • Estimated Difficulty:
          Low

          Description

          Add the front matter stuff like book_info.xml with the list of authors to the reference guide.

            Gliffy Diagrams

              Activity

              Ascending order - Click to sort in descending order
              Hide
              Permalink
              lightguard Jason Porter added a comment -

              I can probably muddle my way through this and figure out what needs to go there, but Dan if you have the time could you at least point me in the right direction? This is the first time I've used DocBook so it's all a little foreign to me

              Show
              lightguard Jason Porter added a comment - I can probably muddle my way through this and figure out what needs to go there, but Dan if you have the time could you at least point me in the right direction? This is the first time I've used DocBook so it's all a little foreign to me
              Hide
              Permalink
              dan.j.allen Dan Allen added a comment - - edited

              Basically you just need to copy/paste from either Servlet or Faces.

              Here's what you need in master

              <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book_info.xml" />
              <toc />
              <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml"/>
              ...

              book_info.xml has author_group.xml, which is:

              <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
              "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
              <authorgroup>
              <author>
              <firstname>Jason</firstname>
              <surname>Porter</surname>
              </author>
              <author>
              <firstname>Dan</firstname>
              <surname>Allen</surname>
              </author>
              <!--
              vim:et:ts=3:sw=3:tw=120
              -->
              </authorgroup>

              And the introduction.xml should be:

              <preface id="intro">
              <title>Introduction</title>
              <para>...</para>
              </preface>

              Show
              dan.j.allen Dan Allen added a comment - - edited Basically you just need to copy/paste from either Servlet or Faces. Here's what you need in master <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="book_info.xml" /> <toc /> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="introduction.xml"/> ... book_info.xml has author_group.xml, which is: <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []> <authorgroup> <author> <firstname>Jason</firstname> <surname>Porter</surname> </author> <author> <firstname>Dan</firstname> <surname>Allen</surname> </author> <!-- vim:et:ts=3:sw=3:tw=120 --> </authorgroup> And the introduction.xml should be: <preface id="intro"> <title>Introduction</title> <para>...</para> </preface>
              Hide
              Permalink
              lightguard Jason Porter added a comment -

              Fixed in e8aade2

              Show
              lightguard Jason Porter added a comment - Fixed in e8aade2

                People

                • Assignee:
                  lightguard Jason Porter
                  Reporter:
                  dan.j.allen Dan Allen
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  2 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved:

                    Development