Chapter 6. Using sets

Procedure 6.1. Creating a stand-alone set

1. Run the following command in a shell in the books/ directory to create a set named My_Set branded in the Red Hat style and in which the XML will be written in American English.

   publican create --type=Set --name=My_Set --brand=RedHat --lang=en-US

2. $ cd into the My_Set/en-US directory and create two directories (not books) called Book_A and Book_B.

   $ cd My_Set/en-US
   $ mkdir Book_A Book_B

3. $ cd into the books/My_Set/en-US/Book_A directory. Create and edit the Book_A.xml, Book_Info.xml, and any other xml files required for your book such as those required for individual chapters. Ensure that Book_A.xml contains the correct xi:include references to all of your xml files in the directory. For example, if Book A contained Book_Info.xml and Chapter_1.xml, the Book_A.xml file would look like this:

   <?xml version='1.0'?>
   <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   ]>
   	  
   <book>
   	  <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
   	  <xi:include href="Chapter_1.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
   </book>

4. Use the same process for Book_B, located in the books/My_Set/en-US/Book_B directory, as per the step above.

5. Open the books/My_Set/en-US/My_Set.xml file in an editor. For each book in the set, add an xi:include reference to the primary xml file from the book. The primary xml file for Book A will be Book_A.xml and for Book B, Book_B.xml. The My_Set.xml file should now look like this:

   <?xml version="1.0"?>
   <!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   ]>
   
   <set>
   	<xi:include href="Set_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   	<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   	<xi:include href="Book_A/Book_A.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   	<xi:include href="Book_B/Book_B.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   	<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
   </set>
   

6. To make your set XML valid, you will need to change the following:

   1. In My_Set.xml, comment out the following lines:

      <remark>NOTE: the href does not contain a language! This is CORRECT!</remark>
      <remark><xi:include href="My_Other_Book/My_Other_Book.xml" xmlns:xi="http://www.w3.org/2001/XInclude"></remark>
      <setindex></setindex>

   2. In the Preface.xml and Book_Info.xml for each book you are using, add ../../ to the front of every Common_Content string you see. For example:

      <xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />

      This will need to become:

      <xi:include href="../../Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />

      This is because in a standalone set, the Common Content folder is two directories further away from where Publican usually looks for it, so it has to be told manually. To build your book individually, without building the entire set, undo this step.

7. Test your set by running the publican build --formats=test --langs=en-US command.