Publication Modules

Publication modules define the content and structure of a publication. Content can be packaged and delivered as one or more publication modules, each of which contain a series of references to data modules or other publication modules. Every publication has a single top level publication module. As with data modules, the degree to which publications are split and broken down by sections is a matter for authors to decide. A publication module is represented by a single XML file with a <pm> root element and the same two main sections as a data module but with the content section containing one or more publication module entries.

                    <pm>
                        <identAndStatusSection>
                            <pmAddress>
                            ...
                            </pmAddress>
                            <pmStatus>
                            ...
                            </pmStatus>
                        </identAndStatusSection>
                        <content>
                            <pmEntry>
                                <pmRef>
                                ...
                                </pmRef>
                            </pmEntry>
                            <pmEntry>
                                <dmRef>
                                ...
                                </dmRef>
                            </pmEntry>
                        </content>
                    </pm>
                

A publication module entry <pmEntry> can contain references to other publication modules <pmRef>, data modules <dmRef> and also contain other <pmEntry> elements if the entry exists only to give structure to the publication. The <pmEntry> elements can be thought of as providing the table of contents, so there may be a heading which contains only other sub-headings for example. A <pmEntry> can also have a title <pmEntryTitle> which is seen by the viewer. If no title is provided then alternatively the reference number can be shown to the viewer or the title could be derived from the target document.