Default styles for type

Build 1501 on 14/Nov/2017  This topic last edited on: 17/Mar/2016, at 16:50

GN4 supports optional auto-insertion of default paragraph styles in a new created text or article element, and manual refresh of such styles if they get deleted by mistake.

Click to toggle expandAuto-insertion of default paragraph styles for type

If auto-insertion is properly configured, each time you create a new article element, related paragraph styles are automatically inserted.

When editing a new article element and GN4 inserts style(s) to match what's defined in the schema, the style with the name of the corresponding element type is selected.

Example: you are creating a body element, and there's a body style in the body format - the body style is inserted.

This functionality is based on the styles, defined in the schema GN4.XSD for specific element type.

Example

You want that every new element of "body" type has three styles auto-inserted as mandatory(1) (by2, byrule and news).

What you need to change in the schema?

The 'body element in the default GN4.XSD schema looks like:

  <xs:element name="body">

    <xs:complexType>

...

              <xs:complexType>

                <xs:sequence>

                  <xs:element name="p" type="p" minOccurs="0" maxOccurs="unbounded"/>

                  <xs:element name="byline" type="byline" minOccurs="0" maxOccurs="1"/>

                  <xs:element name="dateline" type="dateline" minOccurs="0" maxOccurs="1"/>

                  <xs:sequence minOccurs="0" maxOccurs="unbounded">

                    <xs:element name="crosshead" type="crosshead" minOccurs="0" maxOccurs="unbounded"/>

                    <xs:element name="table" type="table" minOccurs="0" maxOccurs="unbounded"/>

                  </xs:sequence>

...

  </xs:element>

 

Change it into:

 <xs:element name="body">

   <xs:complexType>

...

             <xs:complexType>

               <xs:sequence>

                  <xs:element name="by2" type="by2" minOccurs="1" maxOccurs="1"/>

                  <xs:element name="byrule" type="byrule" minOccurs="1" maxOccurs="1"/>

                  <xs:element name="news" type="news" minOccurs="1" maxOccurs="1"/>

                  <xs:element name="p" type="p" minOccurs="0" maxOccurs="unbounded"/>

                  <xs:element name="byline" type="byline" minOccurs="0" maxOccurs="1"/>

                  <xs:element name="dateline" type="dateline" minOccurs="0" maxOccurs="1"/>

                 <xs:sequence minOccurs="0" maxOccurs="unbounded">

                   <xs:element name="crosshead" type="crosshead" minOccurs="0" maxOccurs="unbounded"/>

                   <xs:element name="table" type="table" minOccurs="0" maxOccurs="unbounded"/>

                 </xs:sequence>

...

 </xs:element>

 

Moreover, create, for each new default style for type, a section such as below:

 <xs:complexType name="by2" mixed="true">

    <xs:annotation>

      <xs:documentation>Byline paragraph</xs:documentation>

    </xs:annotation>

  </xs:complexType>

 

 <xs:complexType name="byrule" mixed="true">

    <xs:annotation>

      <xs:documentation>Byline paragraph</xs:documentation>

    </xs:annotation>

  </xs:complexType>

 

 <xs:complexType name="news" mixed="true">

    <xs:annotation>

      <xs:documentation>Byline paragraph</xs:documentation>

    </xs:annotation>

  </xs:complexType>

 

Look for the byline style definition in the standard GN4.XSD and add your styles there.

The paragraph styles are common for all elements of the specifed element type(2). All declared paragraph styles must exist in the GN4 format which is applied to the element.

Also, ensure that maxOccurs="1" for each style (except "p" which is just a placeholder, not a real style).

In case the maxOccurs="2", such style would be applied on first two paragraphs instead to one.

Should maxOccurs="*", such style would be applied on all paragraphs.

Notes

1Mandatory styles are marked as such in the schema with minOccurs="1". By contrary, optional styles are marked with minOccurs = "0". They're not inserted in the new created element. Have in mind, though, that they are verified by the manual refresh (see more below), which won't work even if the minOccurs is 0.
2This, obviously, creates a problem if some of your body elements contain less styles than others. To handle this properly, it is recommended to put all styles in all formats, and to disable the ones you do not need by >rem< tag. This won't hide them from the style selector, but won't produce any output if someone uses them.
Click to toggle expadManual refresh of default styles for type

On the Type menu, point to Paragraph, and then click Apply default styles. It does not matter where the cursor is, nor if something is selected or not.

If either of required paragraph styles does not exist in the format, no style is inserted, not even those which exist, and the warning message "The schema does not match the current format: there is no paragraphs style matching the element type 'name'" is displayed.
Click to toggle expadPreventing auto-insertion of styles

You can use the p element to prevent auto-insertion of any GNML tag - just put "p" as the first in the list of defined tags (look at the body definition below).

Important: this assumes that "p" styles does not exists in the GN4 system, otherwise it won't work - the "p" style will continue to be inserted.

<xs:element name="body">

    <xs:complexType>

...

              <xs:complexType>

                <xs:sequence>

                  <xs:element name="p" type="p" minOccurs="0" maxOccurs="unbounded"/>

                  <xs:element name="byline" type="byline" minOccurs="0" maxOccurs="1"/>

                  <xs:element name="dateline" type="dateline" minOccurs="0" maxOccurs="1"/>

                  <xs:sequence minOccurs="0" maxOccurs="unbounded">

                    <xs:element name="crosshead" type="crosshead" minOccurs="0" maxOccurs="unbounded"/>

                    <xs:element name="table" type="table" minOccurs="0" maxOccurs="unbounded"/>

                  </xs:sequence>

 ...

  </xs:element>