What’s new in version 6.1000

Key point: Updated fragment menu, improved third party sign-in, and OAuth client administration.

Updated fragment menu

We’ve expanded some of the menu options on fragments. You can now view the edit history, post comments, and create tasks on fragments in edit mode.

To make it clearer, the layout of the menu has also been redesigned.

PageSeeder now warns you if you try to archive a fragment which has an active task.

Improved third-party sign-in

To improve the user experience when using third party sign-in or Single-Sign On (SSO), PageSeeder can now be configured so that the portal is displayed to end users directly.

For administrators: Administrators can use the external identity page to see how identity providers are configured.

OAuth client and scopes

To help administrators manage OAuth client apps, the OAuth clients page now provides search filters to only show clients that match selected value. The filters include:

  • Open text filter matching the identifier, member name, client name, or app name.
  • Select box filter by grant type.
  • Select box filter by scope (multiple options possible).

For developers: New scopes have been introduced to better control the permissions delegated to client apps. See the PageSeeder developer website for details.

Archived fragment location

We’ve introduced a new icon  to indicate when a task, comment, edit, or note is attached to an archived fragment.

For example, if you have an active task against an archived fragment, the location icon links to the edit history of the fragment instead of the fragment in the document.

Note on archived fragments

You can provide a note when you archive a fragment. The note title is automatically set to the fragment title.

The fragment title is the first heading of the fragment, including any prefix or the first few words of the content.

The note is available in both the edit history and document edit notes panel:

Keyboard shortcuts

In edit mode, you can use TAB and Shift+TAB to navigate between cells in a table.

To navigate between fragments, you can use the following:

  • Control+Left or Control+Up – when at the beginning of the fragment to go to the previous fragment.
  • Control+Right or Control+Down – when at the end of the fragment to go to the next fragment.

On MacOS, use the Command key instead of Control.

Experimental mermaid support

PageSeeder provides experimental support for Mermaid diagrams. The Mermaid diagram syntax lets you specify diagrams using plain text with a simple language.

PageSeeder supports Mermaid documents with the file extension .mermaid.  The documents are indicated using a icon. 

PageSeeder automatically renders Mermaid content as an SVG graph. It follows your dark mode preferences so that your graphs look good whether you’re in light or dark mode.

Mermaid documents are automatically rendered, but you can also view the source. You can upload and overwrite Mermaid documents, but you cannot edit them.

If you want to edit Mermaid content, you need to use media fragments. When viewing documents with Mermaid fragments, graphs are automatically rendered.

In edit mode, you can edit the Mermaid code directly. The editor displays a preview of the graphs below the source code.

Finally, PageSeeder can provide syntax highlighting for Mermaid content in preformatted content when you set the role to lang-mermaid.

Mermaid support is still experimental, and it has limitations, including the inability to export mermaid content as a graph or comparing mermaid content. Although, we encourage you to try out this feature and provide feedback. Do not use Mermaid in production projects. 

More info on document panel

The document panel includes useful information about the document such as the document type, the number of incoming xrefs , outgoing xrefs , and links  .

Custom styles are automatically loaded to provide a more consistent view of documents in the panel.

The number of incoming xrefs, shown as , lets you see whether the document is referenced. This can be useful to determine whether documents such as images are in use or can be safely archived.

Placeholder dialog

The placeholder dialog has been redesigned and simplified to be more intuitive and provide better feedback when inserting or editing placeholders in your PSML documents.

You can now select the associated metadata on the right or decide to use a placeholder which isn’t mapped to an existing metadata property.

If you type a placeholder name that does not have a matching metadata property, PageSeeder reminds you to create it.

Languages for preformat role

PageSeeder supports syntax highlighting for many languages in preformatted text content. To assist editors setting the correct language role, the dialog to set the role includes a drop-down list of supported languages. This feature only applies to the role of preformat content.

Select a language value in the drop-down to set the correct role value. For example, if you select XML, the role is set to lang-xml.

If you have a predefined list of roles in your document configuration, the language drop-down is no longer shown.

Generated publication ID

When you click the Make this document a publication button in the document information panel, PageSeeder automatically generates a valid unique identifier for your publication.

You can always edit the suggested publication ID.

For developers: The generated publication ID is globally unique. Its prefix is generated from the group name, the middle part is generated from the start and end of the document title, and the suffix is random. 

Auto-completer disambiguation

The '@' auto-complete text pattern lets you insert xrefs quickly, without having to open the xref dialog.

When several documents have the same title, PageSeeder now includes the folder name in the drop-down to help you select the correct one.

Track duplicate as variation option

The duplicate document dialog now includes a checkbox to let you choose whether you want PageSeeder to associate the duplicate with the original.

The checkbox is active by default so that the duplicate is considered a variation of the original document. This lets you compare the duplicate with the original from the variations tab in the compare documents panel.

For developers: To identify variations, PageSeeder ensures that the original document has a Document ID and saves that ID as metadata on the duplicate. If the original document does not have a document ID, PageSeeder automatically generates one.

You can clear the check option, if you do not want PageSeeder to keep track of the relationship between the duplicate and the original. In that case, the duplicate is a copy of the original with no reference to the original.

Simplified link tooltip

We’ve improved the display of links to URLs that have a lot of parameters in the link tooltip so that they are easier to read.

For example, if you create a link to a PageSeeder search result page, the search criteria are presented as a table.

Clearer xref tooltip

To help you understand why an xref is unresolved, PageSeeder can distinguish between different scenarios and provides explanations in the xref tooltip.

For example, using the xref tooltip, you can tell the difference between an xref pointing to:

  • An archived fragment in a document.
  • A fragment in an archived document.

Schematron improvements

We’ve improved the user interface of Schematron validation results. The context of the validation rules can be highlighted more accurately when you point the mouse to the icon in the validation panel, in particular, for text-based assertions and assertions on property values.

The quickfix function now supports parameters and can load documents so that developers can provide more sophisticated quickfix options.

This can be useful to generate or compute a part of a document from another part. For example, you can generate a graph or an SVG in a separate media fragment or compute a score from a set of properties in a different fragment.

Batch workflow update

When you select an action from the document search results to update the workflows, the dialog lets you select which aspects of the workflow you want to update for the selected documents.

For example, if you only want to change the workflows so that the status is “In Progress” and they are assigned to a single person, click the Update checkbox under the Status and Assignee drop-downs and select the person. The other workflow properties are left unchanged.

If you do not select a status, the update only works on documents which already have a status.

Property styling

Developers can apply styles to specific PSML properties so that the user interface can provide better visual feedback.

For developers

Individual properties in a PSML properties table are now given the class property-{name}. Single string properties also have a data-value attribute that is set to the value of the property.

Although we don’t generally recommend using custom styles for properties as they can interfere with built-in PageSeeder styles, it can be useful in some circumstances.

Editing improvements

If you try to insert an image inside a heading (which PSML does not allow), the heading is automatically converted to a paragraph. If an image somehow appears inside a heading, the editor interface makes it clear why it needs to be changed.

You can toggle auto-numbering on multiple selected paragraphs with the button in the editing toolbar or in the editing context menu.

Searching improvements

We’ve tidied up the display of auto-filters in the search bar so that they are easier to read and fit better.

To help you find comments and tasks, you can search by context document type or media type. They are available in the Refine search dialog, and the Select columns dialog in the table view.

When you select an auto-suggested filter from the search, PageSeeder automatically triggers the search and sets up the search page.

For example, when you are looking for a document with a specific document type like ‘help’, start typing the name of the document type, wait for the Filter by help document to appear, use the down arrow key to select the filter and press ↵ Enter to trigger the search directly.