Metanorma: Aequitate Verum

Metanorma for IHO

Bibliographic references

General

In IHO deliverables, bibliographic references are presented in two categories, and put into these two sections:

  • “Normative references”, contain normative references, located at Clause 2;

  • “Bibliography”, contain informative references, placed as the first Annex.

Creating a bibliographic section

Every bibliographic section must be preceded by the style attribute [bibliography] so that bibliographic references are recognized as such.

Place them into the Normative references if they are a required part of this standard.

[bibliography]
== Normative references

* [[[iso_19103,ISO 19103:2015]]], Geographic information — Conceptual schema language

* [[[w3c_owl,W3C owl-time]]], W3C Time Ontology in OWL

Or if the references are informative,

[appendix]
[bibliography]
== Bibliography

* [[[ISO_22739,ISO 22739:2020]]]

* [[[EVANS_DDD,1]]], Eric EVANS. _Domain-Driven Design: Tackling Complexity in Software_.
Addison-Wesley: 2004.

Entering a bibliographic entry

Bibliographic references (citations) are entered using a specialized list syntax.

  1. Starts with a list item indicator (*).

  2. Followed by a pair of triple square brackets ([[[ …​ ]]]) which contains

    • A unique anchor name used to reference this entry. This anchor has to be unique per document.

    • A document identifier (also called the “reference tag”) that identifies this reference to the reader. If the cited document is a standard, it is likely that Metanorma can automatically fetch bibliographic information for it via Relaton.

      Note
      		 If Metanorma recognizes a document identifier, it will overwrite any title you provide with the authoritative title of the reference.

  3. After the triple brackets, the citation text is entered manually. IHO does not specify a citation style, but its documents generally uses the APA Style citation format.

Syntax for a bibliographic entry
* [[[{anchor},{document identifier}]]], _citation text_
Example 1. Example of an auto-fetched entry

The following two statements will create identical outputs.

* [[[IHO-S-102-220,IHO S-102 2.2.0]]]
* [[[IHO-S-102-220,IHO S-102 2.2.0]]], IHO. S-102: Bathymetric Surface Product Specification (2.2.0).
Available at: https://registry.iho.int/productspec/view.do?idx=199&product_ID=S-102

Referencing a bibliographic entry

There are two ways to cite a bibliography entry entered in the bibliography sections.

  1. Cite the whole document, by cross-referencing the anchor name like this: <<IHO-S-102-220>>.

  2. Cite a particular locality of the document, by cross-referencing the anchor name but additionally specify a locality as the second argument, like this: <<IHO-S-102-220,part=IV,chapter=3,paragraph=12>>.

Bibliography example

The following source code illustrates how a bibliography section looks like in Metanorma AsciiDoc.

Example 2. Example for a bibliography section
[bibliography]
== Normative references

* [[[ISO20483,ISO 20483:2013]]], _Cereals and cereal products -- Determination of moisture content -- Reference method_

* [[[ISO6540,ISO 6540:1980]]]. _Maize -- Determination of moisture content (on milled grains and on whole grains)_

Gets rendered as:

  • ISO 20483:2013. Cereals and cereal products — Determination of moisture content — Reference method

  • ISO 6540:1980. Maize — Determination of moisture content (on milled grains and on whole grains)

Auto-fetching IHO references

Metanorma fetches bibliographic entries for IHO documents, when the syntax matches the following:

  • IHO {identifier} (e.g. IHO S-102 2.2.0)

  • IHO(identifier) (e.g. IHO(S-102 2.2.0))

If Metanorma can resolve the reference, the bibliographic information from the database will be rendered.

Example 3. Example of a IHO standard reference
* [[[IHO-S-102-220,IHO S-102 2.2.0]]]

will render:

IHO. S-102: Bathymetric Surface Product Specification (2.2.0). Available at: https://registry.iho.int/productspec/view.do?idx=199&product_ID=S-102

If Metanorma cannot resolve the reference, the provided description will be rendered.

Example 4. Example of a non-auto-fetched reference
* [[[GeoRSS,GeoRSS]]], GeoRSS Geographically Encoded Objects for RSS Feeds. (http://www.georss.org/)

will render:

GeoRSS Geographically Encoded Objects for RSS Feeds. (http://www.georss.org/)