Skip to main content

Example Publication Topic Structure

To help you understand the correct structure for the info elements, we have included a sample publication topic. The example shows the underlying XML so that you can see how the various info elements, such as copyright and pubdate, are structured and positioned inside the info element.

To learn how to add and remove info elements in your own publication topics, see Edit a Publication Topic.

Example 1. Publication topic example

Here is an example of an entire publication topic. Note that we have removed the XML IDs so that the structure is clearer to view. When you create your own publication topic, you will have XML IDs included as well as other XML data.

<?xml version="1.0"?>
<article>
    <info>
        <title>Acme HomeHub User Guide</title>
        <subtitle>The smarter way to manage your home</subtitle>
        <mediaobject role="titleimage">
            <imageobject>
                <imagedata fileref="UUID-4352d337-29fd-6ee2-e88c-e04bed3ce898" xinfo:image="UUID-4352d337-29fd-6ee2-e88c-e04bed3ce898"/>
            </imageobject>
        </mediaobject>
        <volumenum>ACME-SH-123456-A1</volumenum>
        <edition>ACME 100X PBD-10003</edition>
        <pubdate>May 17 2022</pubdate>
        <copyright>
            <year>2022</year>
            <holder>Acme Enterprises</holder>
        </copyright>
        <legalnotice>
            <para>All pertinent state, regional, and local safety regulations must be observed when installing and using this product. For reasons of safety and to help ensure compliance with documented system data, only the manufacturer shall perform repairs to components. Failure to observe this information can result in injury or equipment damage.</para>
            <para>All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the publisher. For permission requests, write to the publisher, addressed “Attention: Permissions Coordinator,” at the address below.</para>
        </legalnotice>
        <address>Acme Enterprises
            <street>1A Main Street</street>
            <city>Generic City</city>
            <postcode>123 456</postcode>
            <country>USA</country>
        </address>
        <authorgroup>
            <author>
                <personname>Richard Greenwood</personname>
            </author>
            <author>
                <personname>Leanne Matthews</personname>
            </author>
                 <orgname>Acme Enterprises</orgname>
            <author>
            </author>
        </authorgroup>
        <releaseinfo>v16.1 release includes documentation for humidity monitoring and controls, extended range of supported lighting systems, and how to order replacement parts.</releaseinfo>
        <abstract>
          <para>Learn how to use the Acme SmartHome hub to manage your household devices from your phone.</para>
        </abstract> 
</info>
</article>