About publication documents

The source and publication documents form a relationship through object valued properties on the Document class. A publication Document points to a source document as either a non-dependent document or a dependent document, depending on the option specified in the original publish request. If a dependent publication document, a metadata relationship exists that causes the publication document to be deleted if the source Document is deleted.

When republishing a document, the publication document is related to a previous publication document in different ways depending on the original publish request and the capabilities of the previous document. The following are examples of the publication document behavior upon republishing:

Note that typically you republish a document because a new version of the source exists.

If a publication document does not support versioning, then the ‘version’ option to republish a document is not valid. Specifying the ‘replace’ option causes a new document to be created and the previous document deleted.

NOTE Publishing a document consisting of multiple content elements will result in only the primary (1st) content element being published. In this respect, publishing does not 'support' multiple content element documents.

For versionable documents, the Publishing Designer has four options regarding the actions to take upon republishing:

Each of these four republish options is valid for the three publishing types; native publishing, publishing to PDF, and publishing to HTML. The following describes how moving a publication document and/or filing it in multiple folders will affect each of the three publishing types and four republishing options:

The publishing cases described above are summarized in the following table:

    Moved to a different folder Filed in multiple folders
Native publishing Add cases Supported Supported
  Version cases Supported Supported
Publishing to PDF Add cases Supported Supported
  Version cases Supported Supported
Publishing to HTML Add cases Supported Not recommended
  Version cases Supported Not supported