metanorma-taste 1.0.9 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a3e9f97884e009d35840d3d18f05fdba70e00e188a61103a3ae7389adefde6c
-  data.tar.gz: 4eb73ea8e02b601860f40be9feb1eb430d6f403fd6074cd074f498fc5ea0c146
+  metadata.gz: 66c6fca3398a09bd581387f5a36fccc1a04151b8f616ac8bce1a301c687a2447
+  data.tar.gz: 7d1147c97d3e40c7e9b26367216822877c509911b281e70cdf907972e7fe2586
 SHA512:
-  metadata.gz: 66bfb74954c81cfff671623f411ebb653622a0dff14b2698ecb84afea01ed7d4fafc2c09def624c5a5f10dda0b239cc1657cb7b5387891d30644cd8f6c6a04d0
-  data.tar.gz: 65d92ed5ebb3d5766fe7e16e35ac0807280c55b513447dc0f73a822d788999272047a0adb9f497642cf4bf4be50aafddefe3bec947068bb396a387eee17fb499
+  metadata.gz: '086f36349333fceefdb181e8095fb0f8f658dc6c54717f04e9ae80c1fd770045177fffd090a72769e69e42984da69cf477a5d2a2c0476d48a412c4024a87ffad'
+  data.tar.gz: 7156be9b7217c51494e65fc3e7607a6b043a78b345187879d61cf361ac4b44693bd550759f5c47596bb42a6eaac3f57122b381fb643d9092d3dbb037c4520c35

data/.rubocop.yml

@@ -1,14 +1,22 @@
 # Auto-generated by Cimas: Do not edit it manually!
 # See https://github.com/metanorma/cimas
 inherit_from:
-  - .rubocop_todo.yml
-  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/main/ci/rubocop.yml
+
+# Rubocop plugins enabled centrally so every metanorma-org gem picks them up
+# on cimas sync — best practice belongs at the shared-template layer, not
+# per-repo. Per ronaldtse feedback on metanorma/ci#332.
+plugins:
+  - rubocop-rspec
+  - rubocop-performance
+  - rubocop-rake
 
 # local repo-specific modifications
 # ...
 
 AllCops:
-  TargetRubyVersion: 3.1
-
-Lint/MissingSuper:
-  AllowedParentClasses: [Liquid::Drop]
+  # 3.3 matches the org-wide minimum being pushed via #274 (Raise minimum
+  # Ruby version to 3.3 due to EOL of 3.2 on 2026-03-31). Was 3.4 before
+  # this commit — 3.4 was above the org's stated minimum and would have
+  # applied Rubocop rules that fail-close on gems still targeting 3.3.
+  TargetRubyVersion: 3.3

data/Create-Taste.adoc

@@ -172,27 +172,34 @@ doctypes:
 
 ===== 5.2 Stage
 
-A limited number of tastes (CSA, PDFA) also provide a dictionary of stage values. Unlike the doctype, this does not map to the base flavor,
-but gives the listing of stages applicable to the taste. The dictionary is formatted as for `metanorma-generic`: it gives a hash
-of stage names, mapping optionally to standard stage abbreviations. Each stage may optionally have a boolean value given for whether it
-is the `default` stage applied to documents (legal for only one stage), and whether it constitutes a `published` stage (may apply to more
-than one stage). So CSA has the following stage dictionary:
+A limited number of tastes (for example, PDFA) also provide a list of stage values. Like the doctype, each stage is a struct: a `taste` value,
+for the taste's label of the stage, and a `base` value, for the corresponding stage in the base flavor to be used in processing. A stage may
+optionally give an `abbrev` (its abbreviation), and the boolean values `default` (whether it is the default stage applied to documents, legal
+for only one stage) and `published` (whether it constitutes a published stage, which may apply to more than one stage). So a taste might
+declare the following stages:
 
 [source,asciidoc]
 ----
 stages:
-  proposal:
-  working-draft:
-    abbreviation: wd
-  committee-draft:
-    abbreviation: cd
-  draft-standard:
-    abbreviation: d
-  final-draft:
-  published:
+  - taste: proposal
+    base: proposal
+  - taste: working-draft
+    base: working-draft
+    abbrev: wd
+  - taste: committee-draft
+    base: committee-draft
+    abbrev: cd
+  - taste: draft-standard
+    base: draft
+    abbrev: d
+  - taste: final-draft
+    base: final-draft
+  - taste: published
+    base: published
     default: true
     published: true
-  withdrawn:
+  - taste: withdrawn
+    base: withdrawn
     published: true
 ----
 

data/README.adoc

@@ -189,6 +189,11 @@ currently available:
 |`iso`
 |International Organization of Legal Metrology specifications and standards with OIML branding and copyright
 
+|`wmo`
+|World Meteorological Organization
+|`iho`
+|World Meteorological Organization specifications (e.g. S-411) with WMO branding and copyright, built on the IHO document structure
+
 
 |===
 
@@ -286,7 +291,7 @@ doctypes:                  # Array of doctypes built over base flavour doctypes
 stages:                    # Array of stages built over base flavour stages
   - taste: string          # Taste-specific machine-readable stage name
     base: string           # Base Metanorma flavor machine-readable stage name
-    abbreviation: string   # Abbreviation of stage
+    abbrev: string         # Abbreviation of stage
     default: boolean       # Whether the stage is the default stage to be applied to a document
     published: boolean     # Whether the stage is to be considered published
 committees:                # Hash of predefined editorial groups for the SDO

data/data/csa/csa.standard.xsl

@@ -6285,6 +6285,12 @@
 					<style name="{$key}-left"><xsl:value-of select="$value"/></style>
 					<style name="{$key}-bottom"><xsl:value-of select="$value"/></style>
 				</xsl:if>
+				<xsl:if test="$key = 'page-break-inside' and $value = 'avoid'">
+					<style name="keep-together.within-page">always</style>
+				</xsl:if>
+				<xsl:if test="$key = 'page-break-after' and $value = 'always'">
+					<style name="break-after">page</style>
+				</xsl:if>
 			</xsl:for-each>
 		</xsl:variable>
 		<xsl:variable name="styles" select="xalan:nodeset($styles_)"/>
@@ -6328,6 +6334,11 @@
 
 			<fo:block role="SKIP">
 
+				<xsl:variable name="styles">
+					<styles><xsl:call-template name="setTableStyles"/></styles>
+				</xsl:variable>
+				<xsl:copy-of select="xalan:nodeset($styles)/styles/@break-after"/>
+
 				<xsl:if test="$isGenerateTableIF = 'true'">
 					<xsl:attribute name="id"><xsl:value-of select="@id"/></xsl:attribute>
 				</xsl:if>
@@ -8477,11 +8488,27 @@
 	<!-- ====== -->
 	<!-- ====== -->
 
-	<xsl:attribute-set name="quote-style">
+	<xsl:attribute-set name="quote-container-style">
 		<xsl:attribute name="margin-left">12mm</xsl:attribute>
 		<xsl:attribute name="margin-right">12mm</xsl:attribute>
-		<xsl:attribute name="margin-top">12pt</xsl:attribute>
+		<xsl:attribute name="role">SKIP</xsl:attribute>
+		<xsl:attribute name="margin-bottom">6pt</xsl:attribute>
 		<xsl:attribute name="margin-left">13mm</xsl:attribute>
+	</xsl:attribute-set>
+
+	<xsl:template name="refine_quote-container-style">
+		<xsl:if test="parent::mn:note">
+			<xsl:if test="not(ancestor::mn:table)">
+				<xsl:attribute name="margin-left">5mm</xsl:attribute>
+			</xsl:if>
+		</xsl:if>
+	</xsl:template>
+
+	<xsl:attribute-set name="quote-style">
+		<xsl:attribute name="margin-left">0mm</xsl:attribute>
+		<xsl:attribute name="margin-right">0mm</xsl:attribute>
+		<xsl:attribute name="margin-top">12pt</xsl:attribute>
+
 	</xsl:attribute-set> <!-- quote-style -->
 
 	<xsl:template name="refine_quote-style">
@@ -8489,7 +8516,8 @@
 
 	<xsl:attribute-set name="quote-source-style">
 		<xsl:attribute name="text-align">right</xsl:attribute>
-		<xsl:attribute name="margin-right">25mm</xsl:attribute>
+		<xsl:attribute name="margin-right">-12mm</xsl:attribute>
+		<xsl:attribute name="margin-right">13mm</xsl:attribute>
 	</xsl:attribute-set> <!-- quote-source-style -->
 
 	<xsl:template name="refine_quote-source-style">
@@ -8512,12 +8540,9 @@
 
 			<xsl:call-template name="setBlockSpanAll"/>
 
-			<xsl:if test="parent::mn:note">
-				<xsl:if test="not(ancestor::mn:table)">
-					<xsl:attribute name="margin-left">5mm</xsl:attribute>
-				</xsl:if>
-			</xsl:if>
-			<fo:block-container margin-left="0mm" role="SKIP">
+			<fo:block-container xsl:use-attribute-sets="quote-container-style">
+				<xsl:call-template name="refine_quote-container-style"/>
+
 				<fo:block-container xsl:use-attribute-sets="quote-style" role="SKIP">
 
 					<xsl:call-template name="refine_quote-style"/>
@@ -8529,14 +8554,16 @@
 					</fo:block-container>
 				</fo:block-container>
 				<xsl:if test="mn:author or mn:fmt-source or mn:attribution">
-					<fo:block xsl:use-attribute-sets="quote-source-style">
-						<xsl:call-template name="refine_quote-source-style"/>
-						<!-- — ISO, ISO 7301:2011, Clause 1 -->
-						<xsl:apply-templates select="mn:author"/>
-						<xsl:apply-templates select="mn:fmt-source"/>
-						<!-- added for https://github.com/metanorma/isodoc/issues/607 -->
-						<xsl:apply-templates select="mn:attribution/mn:p/node()"/>
-					</fo:block>
+					<fo:block-container margin-left="0mm" margin-right="0mm" role="SKIP">
+						<fo:block xsl:use-attribute-sets="quote-source-style">
+							<xsl:call-template name="refine_quote-source-style"/>
+							<!-- — ISO, ISO 7301:2011, Clause 1 -->
+							<xsl:apply-templates select="mn:author"/>
+							<xsl:apply-templates select="mn:fmt-source"/>
+							<!-- added for https://github.com/metanorma/isodoc/issues/607 -->
+							<xsl:apply-templates select="mn:attribution/mn:p/node()"/>
+						</fo:block>
+					</fo:block-container>
 				</xsl:if>
 
 			</fo:block-container>
@@ -13626,6 +13653,10 @@
 		<fo:block break-after="page"/>
 	</xsl:template>
 
+	<xsl:template match="mn:pagebreak[ancestor::mn:table]" priority="2">
+		<fo:block break-after="page"/>
+	</xsl:template>
+
 	<xsl:variable name="font_main_root_style">
 		<root-style xsl:use-attribute-sets="root-style">
 		</root-style>

data/data/pdfa/config.yaml

@@ -15,18 +15,20 @@ base-override:
     publisher: PDF Association
     publisher_abbr: PDF Association
     presentation-metadata-color-secondary: '#d03f4e'  # PDFa logo red - good contrast for WCAG Level AA
-    presentation-metadata-backcover-text: pdfa.org
-    body-font: "'Source Sans Pro', 'Helvetica Neue', Helvetica, sans-serif"
-    header-font: "'Source Sans Pro', 'Helvetica Neue', Helvetica, sans-serif"
+    presentation-metadata-backcover-text: https://pdfa.org
+    body-font: "'Source Sans 3', 'Helvetica Neue', Helvetica, sans-serif"
+    header-font: "'Source Sans 3', 'Helvetica Neue', Helvetica, sans-serif"
+    monospace-font: "'Noto Sans Mono', Courier, monospace"
     fonts: Source Sans 3;Source Sans 3 SemiBold;Source Sans Pro
     output-extensions: xml,html,pdf
     toclevels-html: 6
-    docidentifier:  '{% assign version = edition | split: "." %}{{ doctype_abbr }} {{ docnumeric }}{% if docyear %}:{{ docyear }}{% endif %} {% if edition %}({{ edition }}{% if version.size == 2 %}.0{% endif %}{% if version.size == 1 %}.0.0{% endif %}){% endif %} {% if stageabbr %}({{ stageabbr }}){% endif %}'
+    docidentifier: '{{ doctype_abbr }}-{{ docnumeric | prepend: "000" | slice: -3,3 }} {% if draft %}v{{ draft }}{% endif %} {% if edition %}ed. {{ edition }}{% endif %}'
 doctypes:
 - taste: specification # Specification # The name goes into i18n.yaml
   base: standard
+  abbrev: SPEC
   override-attributes:
-  - presentation-metadata-color-secondary: '#d03f4e' # PDFa logo red - good contrast for WCAG Level AA
+  - presentation-metadata-color-secondary: '#4891af' # PDFa logo blue - insufficient contrast for WCAG Level AA
 - taste: application-note # Application Note
   base: report
   abbrev: AN
@@ -45,12 +47,11 @@ doctypes:
 stages:
   - taste: draft
     base: draft
-    abbreviation: D
+    abbrev: DRAFT
   - taste: release-candidate
     base: draft
-    abbreviation: RC
+    abbrev: RC
   - taste: published
     base: published
     default: true
     published: true
-

data/data/pdfa/copyright.adoc

@@ -2,24 +2,18 @@
 
 // This is authorized by the PDF Association.
 
-=== Copyright notice
+// Avoid heading tag
+=== {blank}
 
 Copyright (c) {{ docyear }} PDF Association
 
 This work is licensed under the Creative Commons Attribution 4.0 International
-License.
-
-To view a copy of this license, visit
+License. To view a copy of this license, visit
 http://creativecommons.org/licenses/by/4.0/ or send a letter to Creative
 Commons, PO Box 1866, Mountain View, CA 94042, USA.
 
-PDF Association Inc. +
-{blank} +
 E-mail: copyright@pdfa.org +
-{blank} +
-Web: https://www.pdfa.org +
-{blank} +
-{blank}
+Web: https://pdfa.org
 
 Vendors own their respective copyrights and trademarks wherever they are
 mentioned. Attention is drawn to the possibility that some of the elements of
@@ -43,7 +37,3 @@ any of the mentioned information, services, products, or providers.
 === {blank}
 
 
-// [align=center]
-// **PDF Association**:
-
-// (c) PDF Association {{ docyear }} - All rights reserved

data/data/pdfa/htmlcoverpage.html

@@ -1,19 +1,46 @@
 <div id='toggle'> <span>•</span> </div>
 
-<div class="coverpage-container">
+<div class="coverpage-container" style="padding-left: 22px"> <!-- padding-left required to avoid submarining left edge text below "toggle" div -->
 
-<div class="logo">
-  <img src="{{ copublisher_logos[0] }}" alt="PDF Association logo"/>
-</div>
+  <div class="logo">
+    <img src="{{ copublisher_logos[0] }}" alt="PDF Association logo"/>
+  </div>
 
-<div>
-  <p class="doctitle-en">{{ doctitle }}</p>
-</div>
+  <div>
+    <p class="doctitle-en">{{ doctitle }}</p>
+  </div>
 
-<div class="docidentifier">
-  <p><b>
-  {{doctype_display}}: {{docnumber}}
-  </b></p>
+  <div style="display: none;">
+    <!-- p>document.docid.id = {{ document.docid.id }}</p -->
+    <!-- p>document.docstatus.stage = {{ document.docstatus.stage }}</p -->
+    <!-- https://www.metanorma.org/develop/topics/metadata-and-boilerplate/#default-metadata -->
+    <p>doctype = {{ doctype }}</p>
+    <p>doctype_display = {{ doctype_display }}</p>
+    <p>doctype_abbr = {{ doctype_abbr }}</p>
+    <p>docidentifier = {{ docidentifier }}</p>
+    <p>docnumber = {{ docnumber }}</p>
+    <p>docnumeric = {{ docnumeric }}</p>
+    <p>docyear = {{ docyear }}</p> 
+    <p>edition = {{ edition }}</p>
+    <p>edition_display = {{ edition_display }}</p>
+    <p>version = {{ version }}</p>
+    <p>version_display = {{ version_display }}</p>
+    <p>iteration = {{ iteration }}</p>
+    <p>draft = {{ draft }}</p>
+    <p>status = {{ status }}</p>
+    <p>stage = {{ stage }}</p>
+    <p>stage_display = {{ stage_display }}</p>
+    <p>stage_abbr = {{ stage_abbr }}</p>
+    <p>stageabbr = {{ stageabbr }}</p>
+    <p>statusabbr = {{ statusabbr }}</p>
+    <!-- p>doctype_abbreviated = {{ doctype_abbreviated }}</p -->
+    <!-- p>document.docstatus.stage.abbreviation = {{ document.docstatus.stage.abbreviation }}</p -->
 </div>
 
+  <div class="docidentifier">
+    <p><b>
+    {{doctype_display}} : {{ docnumber }} {%if stage_display %} - <span style="color:red">{{stage_display}}</span>{% endif %}
+    </b></p>
+  </div>
+  <hr/>
 </div>

data/data/pdfa/htmlstylesheet-override.scss

@@ -2,26 +2,83 @@
   --ribose-primary-color: #d03f4e; /* PDFa logo red. Required for WCAG Level AA colour contrast */
 }
 
-.logo {
-  text-align: center;
+a {
+  text-decoration: underline; /* WCAG - all links must be clearly visible */
+  color: #d03f4e; /* PDFa logo red */
+}
+
+img { /* Make images more responsive */
+  max-width: 100%;
+  height: auto;
+}
+
+body {
+  line-height: 1.5; /* WCAG level AA requires minimum line height of 1.5 */
+}
+
+tt, td tt, p tt { /* override 0.8em formatting elsewhere */
+  font-size: 100%;
+}
+
+figure, pre, .pseudocode { /* incl. source code */
+  line-height: 1.5; /* WCAG level AA requires minimum line height of 1.5 */
+  margin-top: 0cm; 
+  padding-top: 0.1em;
+  margin-bottom: 0cm; 
+  padding-bottom: 0.1em;
+}
+
+table > caption {
+  font-weight: bold;
+}
+
+th {
+  color: white;
+  background-color: blue;
+}
+
+tbody tr:nth-child(even) {
+    background-color: LightGray; /* Light grey for even rows - not header */
+}
+
+/* Level 1: Square bullet, red */
+ul > li::before {
+  content: "\25A0";  /* Black square */
+  color: #d03f4e;    /* PDFa logo red */
+  font-size: 90%;
 }
 
-.docidentifier {
+/* Level 2: Diamond bullet, blue */
+ul ul > li::before {
+  content: "\25C6";  /* Diamond */
+  color: #489aaf;    /* PDFa logo blue */
+  font-size: 100%;
+}
+
+/* Level 3: Circle bullet, green */
+ul ul ul > li::before {
+  content: "\25CF";  /* Filled circle */
+  color: #8b9856;    /* PDFa logo green */
+  font-size: 110%;
+}
+
+.logo { /* cover page logo */
   text-align: center;
-  font-size: 18pt;
 }
 
-.doctitle-en {
-  font-size: 36pt;
+.docidentifier { /* cover page doc type, version and status */
+  line-height: 1.5; /* WCAG level AA requires minimum line height of 1.5 */
   text-align: center;
+  font-size: 20pt;
 }
 
-.coverpage-container {
-  line-height: 1.5; /* WCAG Level AA recommends 1.5 line height as a minimum */
+.doctitle-en { /* cover page primary title */
+  text-align: center;
+  font-size: 32pt;
 }
 
 #toc li a, #toc > ul :is(.h1, .h2, .h3, .h4, .h5, .h6) li a {
-  text-transform: none; /* PDF is case-sensitive! Never force uppercase! */
+  text-transform: none; /* PDF is case-sensitive! Never force nav bookmark text uppercase! */
 }
 
 h1, .h1 {
@@ -32,10 +89,154 @@ h1, .h1 {
   text-transform: none; /* PDF is case-sensitive! Never force uppercase! */
 }
 
-a {
-  text-decoration: underline; /* WCAG - all links must be clearly visible */
+.example {
+  text-transform: none; /* PDF is case-sensitive! Never force uppercase! */
+  font-size: 90%; 
+  background-color: #D6FFFE; /* Very pale blue */
+}
+
+.sourcecode {
+  font-size: 90%; 
+}
+
+figcaption .SourceTitle { /* Revert the title back from monospaced font */
+  font-family: 'Source Sans 3', 'Helvetica Neue', Helvetica, sans-serif;
 }
 
 span.TermNum {
-  font-weight: 100;
+  font-weight: normal;
+}
+
+.requirement {
+  color: Red; 
+  font-weight: bold;
+  text-transform: uppercase; /* Uppercase "SHALL" a-la RFCs */
+}
+
+.recommendation {
+  color: DarkOrange;
+  font-weight: bold;
+  text-transform: uppercase; /* Uppercase "SHOULD" a-la RFCs */
+}
+
+.pdf-keyword {
+  font-family: 'Courier New', Courier, monospace;
+  background-color: #e2e29f;
+  color: Blue; 
+  font-weight: bold;
+}
+
+.pdf-operator {
+  font-family: 'Courier New', Courier, monospace;
+  background-color: #e2e29f;
+  color: Red; 
+  font-weight: bold;
+}
+
+.pdf-version { 
+  font-style: italic; 
+  font-weight: lighter; 
+  color: blue; 
+}
+.pdf-version::before { content: "(PDF "; }
+.pdf-version::after  { content: ")"; }
+
+/* Base admonition styling */
+.Note, .note, .Admonition  {
+  font-size: 86%;
+  margin-left: 8.5mm;
+  margin-right: 0.5mm;
+  margin-top: 6pt;
+  margin-bottom: 6pt;
+  padding: 1mm;
+  padding-left: 1.5mm;
+  padding-right: 1.5mm;
+  border-left: 4pt solid;
+}
+
+.note_label {
+  font-weight: bold; /* the "NOTE 1" text before the body of a note */
+}
+
+.AdmonitionTitle { /* titles of all admonitions */
+  text-align: left;
+  text-transform: none; /* PDF is case sensitive! */
+  font-weight: bold;
+}
+
+/* Tip admonition */
+.AdmonitionTip {
+  background-color: #f5ebce; /* rgb(245,235,206) */
+  border-left-width: 4pt;
+  border-left-color: #d03f4e; /* rgb(208,63,78) - PDFa red */
+}
+
+.AdmonitionTip .AdmonitionTitle {
+  color: #d03f4e;
+}
+
+/* Warning admonition */
+.AdmonitionWarning {
+  background-color: #fff5e6; /* rgb(255,245,230) */
+  border-left-width: 4pt;
+  border-left-color: #ff8c00; /* rgb(255,140,0) - dark orange */
+}
+
+.AdmonitionWarning .AdmonitionTitle {
+  color: #ff8c00;
+}
+
+/* Caution admonition */
+.AdmonitionCaution {
+  background-color: #fffacd; /* rgb(255,250,205) */
+  border-left-width: 4pt;
+  border-left-color: #b8860b; /* rgb(184,134,11) - dark goldenrod */
+}
+
+.AdmonitionCaution .AdmonitionTitle {
+  color: #b8860b;
+}
+
+/* Important admonition */
+.AdmonitionImportant {
+  background-color: #ffe6e6; /* rgb(255,230,230) */
+  border-left-width: 4pt;
+  border-left-color: #ff0000; /* rgb(255,0,0) - red */
+}
+
+.AdmonitionImportant .AdmonitionTitle {
+  color: #ff0000;
+}
+
+/* Safety-precaution admonition */
+.AdmonitionSafetyPrecaution {
+  background-color: #e6f5e6; /* rgb(230,245,230) */
+  border-left-width: 4pt;
+  border-left-color: #008000; /* rgb(0,128,0) - green */
+}
+
+.AdmonitionSafetyPrecaution .AdmonitionTitle {
+  color: #008000;
+}
+
+/* Editorial admonition */
+.AdmonitionEditorial {
+  background-color: #f0f0f0; /* rgb(240,240,240) */
+  border-left-width: 4pt;
+  border-left-color: #808080; /* rgb(128,128,128) - gray */
+}
+
+.AdmonitionEditorial .AdmonitionTitle {
+  color: #808080;
+}
+
+/* Box admonition */
+.AdmonitionBox {
+  background-color: #9addda; /* rgb(154, 221, 218) */
+  border: 2pt solid black;
+  border-left: none;
+}
+
+.AdmonitionBox.AdmonitionTitle {
+  border: none;
 }

data/data/pdfa/i18n.yaml

@@ -1,17 +1,44 @@
 no_place: 
-no_date: Undated
+
+no_date: (undated)
+
 doctype_dict:
   specification: Specification
   application-note: Application Note
   best-practice-guide: Best Practice Guide
   technical-note: Technical Note
+
 term_def_boilerplate: |
-  PDF Association maintains terminology databases for use in describing the
+  The PDF Association maintains terminology databases for use in describing the
   Portable Document Format at the following addresses:
 
   * Glossary of general PDF terms: available at https://pdfa.org/glossary-of-pdf-terms/[]
   * Glossary of PDF accessibility terminology: available at https://pdfa.org/resource/glossary-of-accessibility-terminology-in-pdf/[]
+
 stage_dict:
   draft: Draft
   release-candidate: Release Candidate
   published: Published
+
+admonition:  # see https://github.com/metanorma/isodoc/issues/760
+  tip: Tip
+  danger: DANGER
+  warning: Warning
+  caution: Caution
+  important: IMPORTANT!
+  safety precautions: SECURITY!
+  editorial: Editor Note
+
+abstract: Summary
+foreword: Preface
+clause: Section
+formula: Equation
+subclause: sub-section
+section: Section
+annex: Appendix
+table_of_contents: Table of Contents
+annex_subclause: sub-section
+termsdef: Definitions
+termsdefsymbolsabbrev: Definitions, acronyms and abbreviations
+termsdefsymbols: Definitions, acronyms and abbreviations
+termsdefabbrev: Definitions, acronyms and abbreviations