Sfairadora

  • Reference Guide

Settings Document Section

This section contains settings applicable in general to the entire document. The same information is displayed by the Settings|Document Settings menu command.
Most values in this section have a button in front of them to inherit the value from the system settings. If the button is pressed down (the default setting), the value cannot be changed because it is inherited from the setting of the system document. This allows you to set most values only in one place – the system document – and have them reflected in all other documents. However, if you need to set any of the values separately for a particular document, simply switch this button off and enter the value.

Document Properties

Item
Description
File name
The name of the file in which the document is stored including full path. If the document has not yet been saved, the value is an empty string. The value is read-only, and it is set when the document is saved.
Document type
Document type. The following alternatives are available:
standard
A separate folder on the disk is reserved for every document type except for standard. The allocation of folders can be viewed in the Information section of the system document. If you switch the document type from standard to any other specific type and the document has already been saved to the disk, the respective file is automatically moved to the corresponding folder. Vice versa, if you switch it back to standard, the file is moved to the folder for standard documents. Should this move produce duplicate file names, a number is appended to the file name to ensure its uniqueness.
Document Types are explained in a separate chapter.
Name of master document data
This setting is significant only for the tool set document type. It contains an identifier of the document related to the tool set functions (that is, not the tool set document itself, which is normally called document). Details can be found in the chapter on tool sets.
On-load function
Function performed immediately after the document is opened. The function is defined in the Enki language. The function is evaluated in synchronous mode – the document is not opened until the function is finished.
If this function is specified and the document comes from another installation of Sfairadora, a dialog appears before opening the document asking you whether the function should be really executed. Document origin is established from its home serial number. This mechanism prevents uncontrolled spread of viruses, which could be otherwise created by this function.
On-close functions
Function performed immediately before the document is closed. The function is defined in the Enki language.
Program
An Enki language function evaluated in the background (in asynchronous mode) when the document is open. You can work with the document while the program keeps running until it ends itself or until the document is closed. When you reopen the document, the program resumes where it stopped. If the evaluation function is modified, evaluation starts from the beginning.
Closing main window closes document
Normally the box is checked and the entire document is closed when you close the document main window. The window whose closing closes the entire document is called the principal window. If you remove the check, you can close the document main window without closing the entire document. In this case the window of another presentation may assume the role of the principle window – see the Presentation Definition section, or there may be no principal window at all, and the document is closed when the last window is closed. You can also close a document by the File|Close Document menu command.
Code page
A method for encoding characters with diacritical marks and other characters not included in the common ASCII character set. This setting applies to the interpretation of characters in String and Text data types. You may need to change it if you need to create a document in a language different from that of the operating system. If you change the code page, all texts in the document are recoded using the new code page. If the new code page does not contain a particular character with a diacritical mark, the character is replaced by a character without the diacritical mark. If the new page contains no similar character at all, it replaced by “?”.
The change does not directly affect characters in formatted text types (Rich_string and Rich_text) because code page information is part of the character format. This setting is reflected in formatted text types only as the default code page setting for newly inserted characters.
Language
Document language. This setting is currently used only for the default value of the Language attribute in character format.

Page

This subsection defines the formatting of a page of paper containing Rich_text text types, i.e. the contents of rich text editors.
Item
Description
Paper size
Selection of standard paper sizes. Page width and height are automatically set according to the selection.
Page width
Page width – normally derived from paper size.
Page height
Page height – normally derived from paper size.
Distinct left and right pages
Determines whether left and right pages are distinguished, that is, whether duplex or simplex printing will be used.
Margins
Page margins
Top
Size of the top page margin.
Bottom
Size of the bottom page margin.
Left
Size of the left page margin.
Right
Size of the right page margin.
Gutter
If left and right pages are distinguished, the value is added to the left margin of odd pages and to the right margin of even pages. For simplex printing it is always added to the left margin.
Mirror
Switches the left and right margins on even pages.
Paper orientation
Determines whether portrait or landscape printing is used.
First page number
Number on the first page.
Widow and orphan control
Default setting ensuring that a single paragraph line is not left alone at the end or beginning of a page due to page breaks. You can also set this in the Paragraph Format window – individually for every paragraph.

Symbols

This subsection helps you define the symbols whose graphical appearance is not globally established. These settings are surfaced in the Enkidu language output templates – first, in number formatting and second, if special characters are used. The setting of thousand and decimal separators is surfaced in all line editors editing numbers.
You can either select a value from the listbox or specify any other value.
Item
Description
Multiplication
Multiplication sign – asterisk, cross, dot
Division symbol
Division sign – slash, colon, division sign
Decimal symbol
Decimal separator – either dot or comma.
Thousand separator
Thousand separator – space, dot, comma, apostrophe, or none – in this case digits are not divided into groups per three.
Currency symbol
Currency symbol – $,
List separator
Symbol used for separation – for example, for the separation of numbers in a list. It should be different from the decimal separator.

Text formatting styles

This button opens a window with text formatting styles. A separate chapter is devoted to the style window.