Changing read write rules for S1000D

Sanamdeh,

   Since you asked which files control validation and mentioned .edd, tpl, and .rwr, let me add to Ian's reply some general comments (not specified to S1000D) about the role of these types of files when you work with XML in FrameMaker:

   An Element Definition Document or EDD defines the elements and attributes to be used in a project and associates formatting information with individual elements. It is analogous to a schema or DTD in XML along with a stylesheet. An EDD is never used directly. Instead, the element definitions it contains are imported from the EDD into another FrameMaker document.

   A template is a FrameMaker document that contains formatting information and possibly element definitions that are used in other FrameMaker documents. For example, a template defines various formats or styles (such as paragraph, character and table formats) and page layouts.

    Use an EDD in either of two ways:

    1. Open both a template and the EDD. When the template is current, use File > Import > Element Definitions to replace any existing element definitions in the template with those defined in the EDD.

    2. Suppose you have an existing FrameMaker document, but have changed your EDD since the document was created. You can open the document and the EDD and import element definitions from the EDD into the document. Alternatively, once the revised element definitions have been imported into the template, you can open the document and the template and use the above command to import element definitions from the template into the document.

   A template can also be used to create a new FrameMaker document or revise an existing one. The File > New > Document command prompts for the template that will form the foundation of the new document. When you open an XML document, FrameMaker uses an XML application that specifies the template to use.  When you revise a template, you can import format changes into existing documents with File > Import > Formats and 

   Read/write rules modify FrameMaker's default correspondence between its own representation of elements and XML attributes and that of XML. FrameMaker uses these rules whenever you read (open or import) XML or when you write (or export) XML. In your example, you have three rules of the form:

      fm property x value is "y";

Such rules pertain to an element used for a FrameMaker formatting object other than a paragraph or text range within a paragraph. Examples include tables, graphics, and cross-references. Each such element has a fixed list of properties and read/write rules may map them to an XML attribute or assigned fixed values. "Value is" does the latter and tells FrameMaker to use the specified value when reading XML and not to represent the property's value when writing XML. Read/write rules are not used when you are editing FrameMaker documents.

   Thus, your rule

       fm property column widths value is "170mm";

tells FrameMaker how wide to make columns in tables it reads from XML. It does not affect tables you create when you are editing in FrameMaker. To specify the default column width in FrameMaker do the following:

1. Open your template.

2. Use Table > Insert Table to create a new table. Specify that the new table should use the format you want to change and the number of columns you will typically use for that type of table.

3. Click in a column you want to resize (or select an entire row if you want all columns to be the same size).

4. Use Table > Resize Columns to set the column width.

5. Use Table > Format > Table Designer to open the table designer.

6. Click Update Style.

7. Delete the table from the document.

8. Save the template.

       --Lynne