WPCubed GmbH
Wordprocessing and PDF components 

documentARRAY

Edit Pages

Introduction to "Pages"

Pages contain the material of any publication and are managed by documentARRAY through a database. This database includes fields that store the properties of each page, as well as data necessary for generating the publication. You can edit this data using the page editor, which presents it in a straightforward word processor for formatted text. Here, you can apply paragraph styles like headlines, and also insert images and basic tables.

Design Philosophy

Please be aware that a page is not intended to be edited using a WYSIWYG (What You See Is What You Get) approach. Instead, the emphasis should be on the text's content rather than its layout. Consequently, the page editor is intentionally kept very limited.

The text is formatted using styles as they are defined in the CSS stylesheet. The style sheet file is actually a XML file with different sections for different usages. It also defines hotkeys to select styles quickly using the keys CTRL+'0'..'9'.

Starting the Page Editor

To start the page editor double click on an entry in the project explorer under "Pages"

 

Bottom Toolbar of the Page Editor

 

Source

The source shows a viewer of the source text. If you imported from WordPress this will be the raw HTML text, including meta tags [...] and HTML code <...>.

The source is not used when you create new pages inside documentARRAY and not imported external content.

Edit

This is the main editor. If you imported content, the edit view will be loaded from the source data and rendered as raw preview of the rendering which would be performed on PDF export.

 

Click right on the "Save" button for a menu

Hint: Here you can choose if the edited version of the text is used, or the original, in case the page was loaded from WordPress.

 

Click on the "Pages" button to show the menu to add pages.

 

Click on the gear button to see the editor menu:

Here you can optimize selected text, you can insert text and fields. You can also insert objects to mark conditional text.

Options

Here you find a "replace" script. This script is used to convert the "Source" to text which is used for the import to "Edit". You can use it to remove some code which disturbs the conversion.

In addition page variables can be defined there, unless the list has been moved to the main window.

Stylesheet

Click here to select a stylesheet used for the conversion.

Quick Export

Click here to start the quick export. You can also press F9. The Quick Export only exports the current page using the currently enabled export parameters on the currenbtly enabled target. If no target was enabled, please open one and select "Enable F9". The quick export also creates files in the "Publish" folder in case this feature has been enabled. You can use your FTP program to quickly copy just the modified files(s) to your webserver.

Page Variables

Page variables can hold text which can be used when the page is exported. They are used for meta tags, such as descriptions and key words. Very often those texts can be read from the page contents, so there are 2 hotkeys to create and fill page variables. This are CTRL+N and CTRL+N. You can specify which variable will be created when pressed. In that case the variable will be filled with the selected text. Click on the gear button, to move this panel to the "Etc..." tab.

Functions of the Editor

Toolbar

The toolbar of the editor let you load a file, save a file, select spell check, find text, replace text, select font names, and font sizes.

Please note that documentARRAY is not supposed to provide WYSIWYG page editing. The formatting of text is defined by styles sheets and can be very elaborate when exporting to HTML using InPage templates.. For PDF export the formatting is usefull though.

You can further select a font color, bold, italic and underline.

You can create a bullet list and a numbered list.

It is also possible to insert a table and change its formatting. Tables can be usable to separate contents which is processed by In-Page templates.

Styles

Usually documentARRAY just uses the styles P and H1 ... H7. They are visible in the area to the right, so you can see quickly, which style has been assigned to a paragraph. To assign a style to selected text, you can simply press CTRL + 1..9. If you also press SHIFT, only paragraphs which have no styles attached, will be updated.

LINK

If you click here, you can insert a hyperlink. You can create a link to a different page or also enter an extern link. The dialog box contains display all pages in the current project, with the option to filter for certain text.

You can also convert selected text to a link  to a different page, if you use the right mouse button to drag&drop the caption of a different page in the list of pages to the selected text.

Field

A mouse click will open the field dialog.

Insert a custom variable

Insert InPage template

This will create a group object. The paragraphs (or table cells) in this group will be processed and formatted by the InPage template. The scripts written in XML and kept separate from the page's content. The purpose of these templates is to transform the text within the page's data into a specific structure, such as an HTML accordion.

For example the "Tabs" template will format table cells as tabs when exported to HTML. The "FAQ" template will use paragraphs, with every first paragraph being the question and every second being the answer.

Example - Create a Tabs in HTML - View in Editor:

Exported to HTML:

 

Please note: Currently when exporting to PDF, the text will be exported just as it is visible in the editor.

Insert list with links to other pages

This will insert a special merge field. That mergefield will be filled with links to page in the same page collection or also a different. Without further processing the links will be just hyperlinks, but if this field is used with an InPage block, it can be processed by that. This makes it possible to create not just links to other pages, but also include excerpts of the text on that pages. (akn content view)

Insert link to external document (experimental)

At present the external file is read as plain text and inserted at this position.

Code

You can select some text and mark it as code. When exporting to HTML, java script code can be used to format the output at display time.