Publication types

This feature requires PageSeeder v5.96 or later.

A publication is a set of documents embedded or transcluded into the same hierarchy. A document can be in more than one publication allowing for re-use of content. Grouping documents in a publication enables the following features:

• Display a table of contents (TOC) for a document and it's ancestors in a publication.
• Configure heading and paragraph numbering for a publication.
• Display numbering in the TOC based on the publication being viewed.
• Resolve target numbering in XRef link text automatically (e.g. <xref display="template" title="{prefix}"> ).
• Version all documents in a publication independent of other publications.
• Export a version of a publication independent of other publication versions.

Creating a publication

Each publication has a root document which is the document at the top of the hierarchy. A publication must also have a user chosen publication ID which consists of letters, numbers, hyphens or underscores up to 250 characters long. It provides an easy, stable way to identify the publication and must be unique for the website domain on the PageSeeder server (similar to Document ID).

To create a publication from an existing set of documents follow these steps:

1. Navigate to the root document and click the Properties tab.
2. Enter an ID of your choice under Publication ID (usually less than 20 characters).
3. Click on Save.

Now click on the View tab and open the Table of contents block (on the left) which should display the contents for the whole publication.

Deleting a publication

To delete a publication clear the publication ID from the root document Properties page.

Changing the publication root

To change the publication root document, navigate to the new root document and enter the publication ID on the Properties page. To do this the user must also have contributor access to the old root document.

Configuring a publication

Each publication has a type which can be used to customize the numbering and heading/paragraph levels for publications with that type. If no type is selected on the Document properties page of the root document then the type will be default.

A custom publication type is defined using a publication-config.xml file located in the template/[project]/publication/[type] folder on the server. The easiest way to create this file is as follows:

1. Go to the Dev > Document config page in the Developer perspective.
2. Click the Create publication type button and enter the name for the type which can contain letters, numbers or underscores.
3. Click on the create icon next to publication-config.xml.
4. Make modifications to customize the publication (see Publication config below).
5. Click the Save button at the bottom.
6. Navigate to the root document of the publication and click the Properties tab.
7. Select the new type under Publication type.
8. Click on Save.

Publication config

Below is the default publication-config.xml used by PageSeeder.

<publication-config>
  <toc title-collapse="always" />
  <levels xref-relative-to="heading"
      para-relative-to="heading"
      heading-adjust="numbering"
      para-adjust="numbering" />
  <numbering>
    <schemes>
      <scheme level="1" type="decimal"    format="[1.]" />
      <scheme level="2" type="decimal"    format="[1.][2]" />
      <scheme level="3" type="decimal"    format="[1.][2.][3]" />
      <scheme level="4" type="decimal"    format="[1.][2.][3.][4]" />
      <scheme level="5" type="decimal"    format="[1.][2.][3.][4.][5]" />
      <scheme level="6" type="loweralpha" format="[(6)]" />
      <scheme level="7" type="lowerroman" format="[(7)]" />
      <scheme level="8" type="upperroman" format="[(8)]" />
      <scheme level="9" type="upperalpha" format="[9]" />
    </schemes>
  </numbering>
</publication-config>

<toc> element

This element is optional and can have the following optional attribute:

<levels> element

This element is optional  and can have the following optional attributes:

<numbering> element

There can be multiple <numbering> elements that apply different numbering to documents with different labels. If there are no numbering elements then publication numbering will be disabled. This element can have the following optional attributes:

<scheme> element

Defines the numbering format for a level. If not defined for a level that level will be treated as a skipped level (see above). This element can have the following attributes:

Example

<publication-config>
  <toc title-collapse="always" />
  <levels xref-relative-to="heading"
      para-relative-to="heading"
      heading-adjust="content"
      para-adjust="content" />
  <numbering>
    <schemes>
      <scheme level="1" type="decimal"    format="[1.]" />
      <scheme level="2" type="decimal"    format="[1.][2]" />
      <scheme level="3" type="decimal"    format="[1.][2.][3]" />
      <scheme level="4" type="decimal"    format="[1.][2.][3.][4]" />
      <scheme level="5" type="decimal"    format="[1.][2.][3.][4.][5]" />
      <scheme level="6" type="loweralpha" format="[(6)]" />
      <scheme level="7" type="lowerroman" format="[(7)]" />
      <scheme level="8" type="upperroman" format="[(8)]" />
      <scheme level="9" type="upperalpha" format="[9]" />
    </schemes>
  </numbering>
  <numbering skipped-levels="strip" document-label="detail">
    <schemes>
      <scheme level="1" type="decimal"    format="[1.]" />
      <scheme level="2" type="decimal"    format="[1.][2.]" />
      <scheme level="2" type="decimal"    format="[Table 1-][2]"
          block-label="table-caption" />
      <scheme level="2" type="upperalpha" format="[Fig 1-][2]"
          block-label="figure-caption" />
      <scheme level="3" type="decimal"    format="[1.][2.][3.]"
          element="any"/>
      <scheme level="4" type="decimal"    format="[1.][2.][3.][4.]"
          element="any"/>
      <scheme level="5" type="loweralpha" format="[(5)]"
          element="para"/>
      <scheme level="6" type="lowerroman" format="[(6)]"
          element="para" />
      <scheme level="7" type="upperalpha" format="[(7)]" />
      <scheme level="8" type="upperroman" format="[(8)]" />
      <scheme level="9" type="loweralpha" format="[9]" />
    </schemes>
  </numbering>
</publication-config>

Versioning a publication

Publication versions are the same as ordinary document versions but are related to a particular publication. When a publication version is created, all documents cross-referenced in that publication will have a version created that is related to the publication.

To create a publication version follow these steps:

1. Navigate to the root document and click the Version tab.
2. Click on Create publication version and enter the new version number.
3. Click Submit.

Refresh the version page and mouse over the new version number. It should display something like Publication ID: [mypub1] in the pop-up box.

A publication version can also be created for a single document only as follows:

1. Navigate to a document in the publication and click the Version tab.
2. Click on Create version and enter the new version number.
3. Under Publication: select the publication from the drop down menu.
4. Click Submit.

In the fragment change history versions related to a publication will have the publication ID in square brackets after the version number.

Exporting a publication

To export a version of a publication follow these steps:

1. Select Developer perspective from the cube icon (top left).
2. Navigate to the root document of the publication (alternatively if the publication is in a single folder navigate to that folder and export the whole folder).
3. Click the Export icon in the actions block (top right) or select Export from the actions menu (left) in document browse.
4. If using the root document click Export as PSML and enter the number of XRef levels in your publication or more under Maximum depth of forward xrefs.
5. Under Version to export select the version.
6. Under Publication ID for version select the publication. This is the publication ID that version or compare version must be related to. If no version or compare version related to this ID can be found the original uploaded version is used.
7. Click Export.

Created on 18 May 2018 , last edited on 11 July 2018 at 11:59