The rendering of OGC documents has changed over the years. Metanorma formats OGC documents following current practice:
All body text is left justified, with no exceptions allowed.
Where section obligations are named (i.e. in annex names), they are only given as “normative” or “informative”; the alternate text of “non-normative” is disallowed.
Ordered lists follow ISO style numbering, i.e. “a), b), c) …”, with no exceptions allowed.
Metanorma-OGC supports highlighting of text [added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.2.16]:
This is #text to be highlighted#.
The Normative References section may be named just “References”, reflecting OGC practice.
The following clauses are preliminary elements, and are moved into the frontispiece of the document (in Metanorma, the “document preface”).
The OGC DocTeam has specified that all these elements are MANDATORY in OGC documents (in this order):
Security Considerations [added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.2.5]
The Foreword and Introduction are not recognised as part of the document preface by default [added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.0.2].
The abstract is recognized as the first clause with an
[abstract] == Abstract This standard describes a conceptual and logical model for the exchange of groundwater data, as well as a GML/XML encoding with examples.
The “Preface” can be specified in two ways, depending on whether it is a “simple clause”, or a “full clause”.
Simple preface clause
If the “Preface” does not contain subclauses, it is considered a simple preface clause.
A simple preface clause is entered as text after the
placed between the AsciiDoc document attributes and the first AsciiDoc
section title. It should not be given a section title of its own.
:received-date: 2019-01-01 .Preface Your preface text... More preface text...
Full preface clause
If the “Preface” contains subclauses, it needs to be encoded as a full preface clause.
A full preface clause is recognized as a full Metanorma AsciiDoc section, with the title “Preface”. Simple preface content can also be encoded this way. \[added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.0.1]
:received-date: 2019-01-01 == Preface Your preface text... === Preface sub-clause More preface text...
“Keywords” are entered as document attributes as
:keywords:, with the
value as a comma-delimited list.
Prefatory text is generated automatically.
:keywords: ogcdoc, OGC document, groundwater, hydrogeology, GWML2
The Security Considerations section is entered as a clause with the title “Security Considerations”.
== Security Considerations The following security considerations apply...
If the Security Considerations are not provided in the source document, the clause is inserted with the text “No security considerations have been made for this standard.”
“Submitting Organizations” are entered using the
The values are entered using a semi-colon delimited list.
Prefatory text is generated automatically.
:submitting-organizations: Geological Survey of Canada (GSC), Canada; U.S. Geological Survey (USGS), United States of America
“Submitters” are entered using a table, contained in a section with the title “Submitters”.
|Any table included in a Submitters section is automatically unnumbered [added in https://github.com/metanorma/metanorma-ogc/releases/tag/v1.4.1]|
== Submitters |=== |Name |Affiliation |OGC member |Steve Liang | University of Calgary, Canada / SensorUp Inc. | Yes |===
== Submitters All questions regarding this submission should be directed to the editor or the submitters: |=== |Name |Affiliation |Boyan Brodaric |GSC |Alexander Kmoch |U Salzburg |===
Additional preliminary elements
The OGC DocTeam has specified that additional preliminary elements are allowed but not encouraged. This is useful for document backwards-compatibility and cross-published standards at other SDOs.
Additional preliminary elements should be encoded under the
element, and they will be rendered after the five mandatory preliminary
Functionality implemented in https://github.com/metanorma/metanorma-ogc/issues/83.
.Preface ... [.preface] == Intended audience ...
A glossary in an OGC document is an annex with the same content as a “Terms and definitions” section, but with informative rather than normative effect.
Glossaries are recognised as annexes with the title “Glossary”, or marked up
[heading=glossary] [added in
[appendix] == Glossary === geospatial relating to geographic and spatial information [.source] <<OGC21-017,clause="4.3">>
[appendix,heading=glossary] == Customized glossary section === geospatial relating to geographic and spatial information [.source] <<OGC21-017,clause="4.3">>
Unlike the normal case in Metanorma, examples can have captions:
[example] .Example caption ==== Text ====
Table cells under OGC always have a vertical alignment of
middle [added in
markup instructions to set cell alignment to a different vertical alignment