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>


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" />

The pragma ?docbook will respond with the transclude 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.

                Text goes here.
        <xi:include href="articles/new-topic.docbook" />

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.

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