Table of Contents
Advertisement
15
G e n e r a t i n g a C S S
After you generate a CSS in this way, the stylesheet is not necessarily used by any XML
documents. If you specify the same path and file name as an existing CSS, and that CSS
is used by an XML document, the following will result:
•
The new CSS will overwrite the older one.
•
Any XML documents that specify a CSS of that path and file name will now use the new
CSS.
Generating a CSS on Save As XML
When editing XML documents, you must control whether FrameMaker generates a CSS
every time you save a document as XML. For example, if an XML document specifies an
existing CSS, you may want to retain that specification each time you save the document
as XML. On the other hand, if you generate a CSS on Save As XML, FrameMaker will
change the CSS specification to use this generated CSS.
Specifying how FrameMaker generates a CSS
You specify how FrameMaker will generate a CSS by inserting elements in the structure
application definition. These elements are all children of the Stylesheets element. You
specify these elements as follows:
•
To direct FrameMaker to generate a CSS, set GenerateCSS2 to Enable.
•
To specify a path for the stylesheet, provide a URI in StylesheetURI. If you don't provide
a URI but have enabled GenerateCSS2, FrameMaker will save the generated stylesheet
at the same location as the resulting XML document.
•
To have FrameMaker support EDD context selectors in the CSS via a reserved attribute,
set AddFmCSSAttrToXml to Enable.
•
To direct FrameMaker to save the generated CSS in a specific location, provide a URI
in the StylesheetURI element. Otherwise, FrameMaker saves a generated CSS in the
same location as the ML document.
•
To direct FrameMaker to save XML with a new stylesheet declaration that uses the URI
specified in your structure application, set RetainStylesheetPIs to Disable.
•
To ensure that the stylesheet declaration in the exported XML is the same as it was when
you imported the XML, set RetainStylesheetPIs to Enable.
•
To specify the type of stylesheet you are using, provide a string in the StylesheetType
element. Currently, FrameMaker can only generate a CSS stylesheet. Even if you are
not generating a stylesheet, you should provide a stylesheet type in case other processes
rely on that data. For example, a structure API client may vary its processing depending
on the value you provide here.
Stylesheet specifications in a structure application
You specify stylesheet parameters in the application definitions file, structapps.fm. For
an XML application, you can include the following elements.
Structure Application Developer's Guide
225
Advertisement
Table of Contents
