About Arbortext Styler > Creating a Basic Stylesheet > Converting a FOSI to a Stylesheet
Converting a FOSI to a Stylesheet
Arbortext Styler provides a conversion utility that partially converts a FOSI to a stylesheet (.style file). Before converting a FOSI, refer to the following limitations of the conversion program.
As a general rule, Arbortext Styler's FOSI conversion generates two contexts for each FOSI e-i-c (note that this does not apply for titles, or contexts that start with a “*” wildcard - see limitations below). Arbortext Styler will generate one context that matches the FOSI e-i-c exactly, e.g. blockquote in para, and one that contains an additional implicit wildcard, e.g. blockquote anywhere in para. This ensures that Arbortext Styler matches the FOSI e-i-c matching process - a built in rule states that, once FOSI has searched unsuccessfully for a matching e-i-c using context as specified, it prepends a “*” wildcard to all contexts and starts searching again.
In most cases it is the job of the stylesheet developer to decide which of the two (almost identical) contexts they wish to keep after the conversion from FOSI, and delete the other. In most cases, it is recommended that they delete the “anywhere in” context and keep the “in” context.
Limitations of Converting FOSIs to Stylesheets
The FOSI to Arbortext Styler conversion process does not convert the following FOSI features because Arbortext Styler does not provide corresponding capabilities:
Change marks (chgmark)
Conditional post space (postsp:condit)
Element-in-contexts whose gitype is pi.
Environment (envdesc)
Floats and float locations (floatloc)
Font width (font:width)
Footnote description (ftndesc)
Highlighting (highlt), score weight (scorewt), score offset (scoreoff), and foreground percent (forpct)
Hyphenation rule (hyphrule) characteristics other than language
Hyphenation zones (hyphen:zone)
Keep floats out (keeps:floatsout)
L-page column spans (span:pageflow)
Run-in titles
Security description (secdesc)
Sentence spacing (sentxsp)
Word spacing (wordsp)
Use values (fillval)
Test values (specval) that use #FOSI, system-var (other than editor-only, print-only, html-only), system-func or the use of a textid in the attval characteristic
Title element contexts that use initial wildcards, i.e. those whose context attribute value begins with a “*”., for example <e-i-c gi=”title” context=”*chapter”>. These need to be manually fixed once the FOSI has been converted to remove the initial wildcards. The steps to carry out this correction are:
1. Select the element context in the Elements list
2. Choose the Edit > Edit Context menu option
3. In the Edit Context dialog box, select the node that contains the “*” character and delete it
The numbering of titles will be adversely affected if the wildcards are not removed in this way.
The following generated text FOSI features are not converted during the conversion process, but Arbortext Styler provides corresponding capabilities. Once you have converted your FOSI, you can duplicate the formatting of these features using the Generated text category in Arbortext Styler:
Character fills (charfill)
Counters, reset, and enumerate (enumerat)
Generated graphics (putgraph)
Rules (ruling)
Saved text (savetext)
Use text (usetext)
listitem gentext is converted to bullets, and indentation may need to be modified
FOSI Conversion
Perform the following steps to convert a FOSI to a stylesheet.
1. Open a document in Arbortext Editor, and choose Format > Select Stylesheets to select the FOSI stylesheet you want to convert.
2. Choose Styler > Convert Stylesheet.
3. Select OK in the Convert Current Stylesheet dialog box.
4. After the conversion, a message displays indicating that the automatic conversion is finished. Click OK. The document is updated in the Edit pane, and Arbortext Styler opens, allowing you to manually convert those features that the automated process did not.