New Partition

This dialog opens when a new partition is being created in a publication.

The partition name must be entered and must conform to the constraints listed in “Repository”. By convention, the recommended name for the first partition in a publication is Template. Some implementations use the partition with this name as a model for creating new partitions.

You may also provide an initial source document for the partition. Leave the field empty if no suitable document is available.

Fill in all the tabs then click the Next button to move to the next step.

Source document

If you tick the Copy to partition checkbox then TopLeaf will copy the source document into the partition. If this option remains unchecked, then TopLeaf will set up a link between the source document and the partition. If you set up a copy partition, make sure that the source document is self contained, as external documents or graphics referenced from the document will not be copied into the partition.

TopLeaf will check the source document file type when it creates the partition. If the source document file type is .sgm, then TopLeaf will assume that the initial partition markup type is SGML.

DTD File

A DTD is not required by TopLeaf, so it is recommended that you leave the DTD File checkbox blank.

When the option Copy to publication is unchecked, the system will operate via a link to the DTD, and any changes made externally will be honored when composing partitions within the publication. If you check this option, a private copy of the selected DTD file will be stored within the repository, and changes to the original file will have no effect on the publication.

[Note] Note

You would normally only copy a DTD into a publication if the DTD file is self contained, or when you want to associate a publication with an independent version of the DTD.

When TopLeaf makes a copy of the DTD it only copies the file you specify. If the DTD includes other files via parameter entities, then the included files will not be copied. This can result in the DTD being incomplete, and cause errors when TopLeaf composes the partition.

In most cases, these errors relate to the resolution of relative paths declared within the DTD file, and can be addressed by copying the folders containing the DTD inclusions into the TopLeaf publication folder.

Catalog File

Entities within a document type declaration can be resolved using the OASIS catalog mechanism. The catalog will be ignored if no DTD is used.

If you uncheck Copy to publication, the system will operate via a link to the catalog, and any changes made externally will be honored when composing partitions within the publication. If you check this option, a private copy of the selected catalog file will be stored within the repository, and changes to the original file will have no effect on the publication.

TopLeaf's OASIS catalog support is limited. See “OASIS catalog support” for more information.

Publication Options

The Publication Options dialog sets up the basic preferences that will be used when you open or create partitions within a publication. These are only set when you create the first partition within a publication because the same tag mapping and page layout styles are shared by all partitions in that publication.

Tag mappings

The following are the options for creating an initial set of mappings for the stylesheet:

  • Generate the mappings from the source document — TopLeaf analyses the XML source document and assigns provisional mappings for each tag based on its depth in the hierarchy, the tag position within the parent element, or the presence or absence of text content. This option is not available for SGML documents, or if no document was specified in the New Partition dialog.

  • Import from a CSS file — TopLeaf can read a Cascading Style Sheet (CSS, see “Importing a CSS stylesheet”) and convert most of the format information into TopLeaf mappings. When you choose this option, you must use the selector to locate the relevant .css file.

  • Import from a TopLeaf format specification file — If you already have a TopLeaf publication with the same or similar format, you can use that format to start off your new publication. Note that a copy is made, so you can modify the style without affecting the original publication. Use the selector to locate the mappings.tlx file located in the publication folder of the relevant publication. Note that you can only use a mappings.tlx file from a publication in a repository; if you select a file that is not in a publication the creation may fail to find other necessary files.

  • Leave empty — generates only a basic $document mapping to set default font, alignment etc, plus some default rules for paragraph splitting.

The initial mappings represent a starting point only. You can then fine tune the output format by refining these mappings and adding new mappings as required.

Paper Size

The paper size selector allows you to assign the preferred page size for this publication. In general you will normally select Letter within the USA and A4 anywhere else. The Layout Editor allows you to choose from a more extensive range of paper sizes (and to create your own custom sizes if necessary).

Table Model

TopLeaf supports either CALS or HTML table markup.

If you do not know which table model to choose, then select Unknown.