A Callimachus book is a DocBook document.

Books organize articles into a desired sequence and hierarchy and may be divided into parts and chapters.

To create a book, select Book using the create menu from the folder you wish to store the book in. You will be presented with the following initial DocBook code:


<?xml version="1.0" encoding="UTF-8" ?>
<book xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" 
      xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">

<title>Untitled Book</title>

</book>

Screenshot: Initial code for a book

Including an article

Use the xi:include tag to include an article by specifying its relative path.


<xi:include href="articles/who-is-using-callimachus.docbook" />
Pragma Description
?docbook Transcludes all articles and return the combined docbook file

Editing an included article

To edit an article when viewing a book

  • click on the  symbol which appears immediately after the article's title
  • press the edit tab to edit the article

Linking to a point in a book

When linking to a particular point in a book, insert an archor tag to set the destination for the link. The link target can be a named anchor within the article, a hash identifier elsewhere in the book, or the view page of an included article. Other links will point to the coresponding resources.

Adding a part

Use the following DocBook code to add a part to the book. Insert the code directly after the book's title tag for the first part.


    <part>
        <title>Topic</title>
        <preface>
            <title>Introduction</title>
            <para>
                Text goes here.
            </para>
            <para>Topics</para>
        </preface>
        <xi:include href="articles/new-topic.docbook" />
    </part>

Adding a chapter

Use the following DocBook code to add a chapter to a part. Insert the code directly after the part's <title> tag for the first chapter.


        <chapter>
            <title>Chapter title goes here</title>
            <info>
                <abstract>
                    <para>Overview goes here.</para>
                    <para>Topics</para>
                </abstract>
            </info>
            <xi:include href="articles/new-topic.docbook" />
        </chapter>