6. To publish

Publishing consists of transforming a document into a format suitable for its dissemination, via a style sheet that defines its final graphic appearance.

Figure 22. Managing publications

Managing publications

[Note] Custom layouts

Advanced style sheets are not customized by default. They are provided by NeoDoc on demand for a specific layout and data transformation.

6.1. To create a publication

[Important]

The instructions below concern the publication of the current version of the document. To publish a specific version of a document, see To publish a particular version.

[Tip] Publications of a document created from a template

The publications defined on a template are automatically recreated on the instances of this template (Create a content template).

  1. Click on the icon corresponding to the document.

  2. Click on + Add.

Procedure 5. To create a publication based on another publication

  1. Click in the Based on field, select an existing publication.

    The name of a template publication is composed of [Publication name (document label)].

    By default, all publication templates are in the Others. As they are used, the most widely used model publications make up the section Most Used.

    The number next to the star indicates the number of times this publication has been used as a template.

    You can click on the star to set the model publications as favorites.

  2. In the field Name, the file name is automatically set with the name of the field Based on. Rename the publication if you want.

  3. All parameters in the template are auto-populated. Set a Output Name Template if necessary.

  4. Click Validate.

Procedure 6. Create a publication with manual setup

  1. Skip the field Based onand enter a name to identify the publication.

  2. Select an output format in the drop-down list.

  3. If necessary, select a layout format.

  4. Click Validate.

[Important]

Filters. The values selected in the Filters are to be applied for targeted publication (see To define the filtering criteria of a publication).

[Tip]

For more advanced publication settings, refer to To configure a publication.

6.1.1. To filter content

This feature allows you to filter elements that do not match the goal of the publication. This makes it possible, for example, to generate two versions of the same document intended for two audiences who do not need exactly the same information.

The three stages of filtering

6.1.1.1. To define the filtering criteria of a publication

The customized attributes are listed and their values can be selected without risk of error:

Figure 23. Filtering a publication

Filtering a publication

[Important]

Document content items that do not have any filter criteria are published normally.

6.1.1.2. Filtering rules and profiling restrictions

For a targeted publication to generate successfully, the filtering information set for a publication and the profiling information set at the content level in the editor must be consistent.

See the most common restriction cases and methods for detecting potential issues impacting publications Detect potential issues related to profiling.

6.1.2. To configure a publication

Figure 24. Parameters of a publication

Parameters of a publication

For advanced users, this window will allow to modify all the possible parameters of the publication:

Name

  • This name is used in particular to name the result file(s) of the publication.

Output Name and Output Name Template

The output name is assigned to a publication when it is downloaded or sent to an external server (see Send result to). By default, the output name is the same as the name. The output name can be configured:

  • by modifying it directly in the dedicated field;

  • by defining its model with a set of variables.

The available variables are:

  • filename : technical name of the file;

  • title : title of the document;

  • label : label of the file;

  • revision : version (visible in the list of documents) attributed by Calenco for the document;

  • language (or LANGUAGE for uppercase display): language version of the document;

  • startTimestamp: start timestamp of the very last publication;

  • startDate: start date of the very last publication;

  • lastModifiedTimestamp: timestamp of the last modification of the document;

  • lastModifiedDate : date of the last modification of the document.

For example, by setting the title variable followed by the language variable you get the translated publication name with the indication of the target language, once the concerned document is back in Calenco after the translation.

Output format

  • Select an output format in the list.

Options

The options are specific to each output format. Main options are:

  • pdfprofile = PDF / X-3: 2003

    Produce a PDF compliant with PDF / X standard:

    • All fonts are integrated in the PDF;

    • Images with transparency are not supported.

  • convert.mathml = [svg | png]

    Define the format used to convert MathML mathematic formulas in html publications.

  • convert.mathml.size = [12]

    Specifies the font size to publish MathML formulas, if parameter convert.mathml is used.

  • images.maxsize = [1000]

    Specifies the maximum size in pixels (width or height) of bitmap images. Useful for reducing the weight of publications.

Layout

  • Depending on the output format, choose the style sheet corresponding to the desired layout. The provenance of the selected style sheet - source workspace (in the case of shared spaces) and / or the storage language - is indicated to the left of the label of this style sheet:

Parameters of a style sheet

  • Parameters to customize a publication

    [Tip]

    The effect is different depending on your stylesheet - nevertheless basic stylesheets are sensitive to standard publish settings.

[Note]

Protect PDF publications. PDFs produced by Calenco conform to Acrobat Reader:

  • Their opening can be blocked by a password on opening (password linked to the publication to personalize it and change it periodically);

    user-password = UnMotDeP @ sseC_mp_qué

  • They can be made non-printable;

    noprint = true

  • Their content may be non-copiable.

    nocopy=true

Send result to

  • If the administrator of the workspace has configured any, you can choose to send the result of the publication to an external server (FTP, SFTP, email, Sharepoint, OneDrive). For more information, please refer to To connect storage servers.

Check out the video of the principle Multi-format publications: