Tutorials

Task-driven tutorials and recipes for PageSeeder

 

Tutorials

The tutorials will help to solve common problems quickly by providing guidance through simple examples.

Created on , last edited on

Available tutorials

How to change the display of PSML using CSS

PSML documents are rendered as HTML when displayed to end-users in both PageSeeder and Berlioz. This tutorial explains how to customize the presentation of documents using CSS styles.

Skill required:
CSS
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to configure CentOS/Amazon Linux for Berlioz

The purpose of this tutorial is to outline the steps required to prepare an installation of CentOS or Amazon Linux for PageSeeder and Berlioz. By the end of this tutorial you will have a working installation of PageSeeder and Jetty that can be used as a base for other PageSeeder and Berlioz tutorials.

Skill required:
Basic Linux knowledge
Time required:
30 minutes
Difficulty:
Medium
Category:
Berlioz
How to configure a custom properties editor

When it comes to fielded or form-oriented data, PageSeeder provides a mechanism that allows developers to configure a document type with special properties fragments. These fragments contain one or more <property> elements, which is how PSML represents fielded or forms data.

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to configure auto-numbering, equations, footnotes, endnotes and citations

Publications sometimes require the features below. They are not enabled in PageSeeder by default but can easily be configured as shown in this tutorial.

Skill required:
XML
Time required:
45 minutes
Difficulty:
Easy
Category:
Document
How to control access to a Berlioz site using the Deck

Using the permission model and account management of PageSeeder is a straightforward way of managing user access to a Berlioz site. This task is made simpler by a module called Deck (a companion to Bridge).

Skill required:
XML,XSL
Time required:
30 minutes
Difficulty:
Medium
Category:
Berlioz
How to convert XML data to PSML documents

Content of PSML documents often originates in other XML formats. This tutorial will demonstrate how to convert XML generated by Wikipedia to PSML documents using XSLT.

Skill required:
XML, XSLT
Time required:
30 minutes
Difficulty:
Easy
Category:
Document
How to convert XML data to PSML documents with XRefs

PSML documents are often linked together using cross-references (XRefs). This tutorial will demonstrate how use XSLT to convert two XML files generated by Wikipedia to PSML documents linked together with XRefs. The PSML will then be uploaded to PageSeeder for checking the results.

Skill required:
XML, XSLT
Time required:
30 minutes
Difficulty:
Medium
Category:
Document
How to create a Berlioz index using PSML content

This tutorial will explain how to create a Berlioz index using PSML content.

Skill required:
XML
Time required:
45 minutes
Difficulty:
Medium
Category:
Berlioz
How to create a new document type

Document types are a key concept in how PageSeeder represents and validates structured text. 

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to create a properties fragment

PSML supports a special class of fragments known as properties fragments. These name/value pairs can be used to store information such as metadata. This tutorial will explain how they can be implemented.

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to create a website (or Berlioz) publish script in PageSeeder (Advanced)

This tutorial demonstrates the use of advanced features in publish scripts to process folders in PageSeeder. These kinds of features are typically required for more advanced website publishing.

Skill required:
XML
Time required:
30 minutes
Difficulty:
Medium
Category:
Berlioz
How to create document collections from a template

Through the PageSeeder interface, document templates allow users to create single documents. This tutorial explains is how developers can use a process script to have a document template create an entire collection of linked documents.

Skill required:
XML
Time required:
30 minutes
Difficulty:
Easy
Category:
Document
How to create website (or Berlioz) publish script in PageSeeder

This tutorial will show how to create a script to publish PageSeeder documents to a website (or Berlioz). It explains how to publish from both the document and folder level.

Skill required:
XML
Time required:
30 minutes
Difficulty:
Medium
Category:
Berlioz
How to display an image thumbnail for a document

PageSeeder can display a thumbnail of the first image in a document in place of the usual file icon in search results, XRef lookups and the omnibox. By the end of this tutorial the ability, to configure PageSeeder so that the thumbnail is displayed instead of the standard icon, will be gained.

Skill required:
None
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to import and export LwDITA in PageSeeder

PageSeeder can be used to edit, manage and publish content from different XML formats. This tutorial shows how to import/export and edit Lightweight DITA (LwDITA) XML format in PageSeeder.

Skill required:
XML
Time required:
45 minutes
Difficulty:
Medium
Category:
Document
How to run XSLT from Eclipse

XSLT is a W3C standard programming language primarily designed to process XML content. One task it is particularly well suited to is transforming XML to another syntax such as plain text or HTML or to an alternate XML structure. This tutorial shows how to do an XSLT transformation using the Eclipse IDE.

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to run XSLT from the command line

XSLT is a W3C standard programming language primarily designed to process XML content. One task it is particularly well suited to is transforming XML to another syntax such as plain text or HTML or to an alternate XML structure. This tutorial shows how to do an XSLT transformation using the Windows command line.

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to use metadata to substitute lo-res with hi-res images

This tutorial describes how image metadata can control which version of an image is used when PageSeeder outputs a document. For example, publishing a document to a website or mobile device may use the same resolution image as the editing process. However, when the same document is output for print the images may be substituted with a higher resolution version.

Skill required:
XML
Time required:
30 minutes
Difficulty:
Medium
Category:
Document
How to validate documents using Schematron

By the end of this tutorial you will be able to use Schematron to validate film documents. This includes learning how to define validation rules and implementing them on PageSeeder.

Skill required:
Schematron
Time required:
30 minutes
Difficulty:
Easy
Category:
Document
How to constrain new documents to a specific location or naming rules

This tutorial explains how to configure PageSeeder so that any new documents of a specific document type conform to rules that specify where the document must be stored and what it must be named.

Skill required:
XML
Time required:
15 minutes
Difficulty:
Easy
Category:
Document
How to upload an Excel spreadsheet as PSML

This tutorial will explain how to create PSML files from an Excel file using an Ant publishing task (upload).

Skill required:
XML, XSLT, Apache Ant, Pageseeder
Time required:
30 minutes
Difficulty:
Medium
Category:
Document