documentARRAY uses special themes to convert the data from page collections to export documents (PDF) or websites.

Such themes consists of different parts:

1) Template (File: WPT Format)

This is document which pulls in data and sends it to the export. The export can be a new document or separate different files in HTML or MD (=markdown) format.

The Template is edited in an editor right in documentARRAY. It consists of text, fields and certain bands. Templates are managed by the project manager.

This example show the template which can create a document consisting of an index and the text loaded from pages.

Templates can be used to create a destination document. Certain "Bands" in the template can be used to create a HTML navigation element which can be used by each exported page.

2) Outline (File - WPT Format)

Outlines are documents which consists of links to pages which are ordered hierarchically. They are required to create any kind of output.

In contrast to other programs, doucmentARRAY does not use the structure used to save pages directly to crete the output. This makes this unique features possible:

Change the title easily, i.e. for translation

Create different output by simply choosing a different outline

Create outlines which pull pages from different page collections

Outlines are edited in a text editor right in documentARRAY. They are managed by the project manager.

This example shows  an outline with 4 main entries and sub-levels.

When a website is produced, the outline is used to create the website menu structure. In addition you can select the pages collections which contain the pages which should also be exported. Conditions can be used to exclude / include certain pages.

3) Optional: WebScript (XML File)

This is a template written in XML. It can be edited in documentARRAY or in an external editor, such as notepad++. WebScripts are used to translate the data from the templates (1) and the data loaded from pages to output files in HTML format. Compilers, such as Delphi can create documentation files in XML format, also called XMLDoc. WebScripts are mainly used to convert such XMLDOC to documentation web sites.

4) Optional: Themes (Directory with files)

A Theme consists of a set of HTML, JavaScript, Image and Styleheet files. It theres as basis for a website and contains all important files which are important for the layout and the navigation. Most of the files are simply copied by documentARRAY to the destination folder. Certain HTML or JS files can be edited by documentARRAY by removing or changing text and of course also by also changing the file name.

In many cases one HTML (i.e. _base.html) file will be used as base to show the text stored on the pages. The menu can be created by a band in the template (1) and injected into the html. We recommend the program bootstrapstudio to create and edit a theme. But is is also possible to use an existing website and simply insert some variables into some of the HTML files.

Variables are encoded as HTML or JAVA comments: /*%VARNAME%*/ or <!--%VARNAME--!>, both syntax are possible as required. (By using the JavaScript syntax, it is possible to simply add the text in a HTML editor.)

5) Optional: In-Page Templates (XML File)

Such templates are written in XML. They contain structures which are used to convert areas on pages which are marked to certain HTML structures. This makes it possible to create HTML accordions, galleries, FAQ Lists etc.

6) Optional: Document Variables (XML File)

The data file consists of files which can be used by fields in templates and themes.

7) Stylesheet (XML File)

The stylesheet contains headline and paragraph style definition in CSS syntax. Using XML tags the CSS used by the editor, PDF export and the website export are separated.

Use Quickexport
Export as Website
Export as PDF