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.
-
Starts with a list item indicator (
*
). -
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.
NoteIf Metanorma recognizes a document identifier, it will overwrite any title you provide with the authoritative title of the reference.
-
-
After the triple brackets, the citation text is entered manually. IHO uses the Chicago Manual of Style citation format as documented in the IHO Standards Style Manual.
* [[[{anchor},{document identifier}]]], _citation text_
The following two statements will create identical outputs.
* [[[IHO_528-2019,IHO 528-2019]]]
* [[[IHO_528-2019,IHO 528-2019]]], IHO. _IHO Standard for Inertial Sensor Terminology_ (2019).
Available at: https://standards.iho.org/iho/528/7292/
Referencing a bibliographic entry
There are two ways to cite a bibliography entry entered in the bibliography sections.
-
Cite the whole document, by cross-referencing the anchor name like this:
<<IHO_528-2019>>
. -
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_528-2019,part=IV,chapter=3,paragraph=12>>
.
Bibliography example
The following source code illustrates how a bibliography section looks like in Metanorma AsciiDoc.
[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
Relaton fetches bibliographic entries for IHO documents, when the syntax matches the following:
IHO(identifier)
(e.g. IHO(528-2019)
), or any identifier prefixed with IHO
.
-
If Relaton can resolve the reference, the bibliographic information from the database will be rendered.
Example 3. Example of a IHO standard reference* [[[IHO_528-2019,IHO 528-2019]]], _Standard for Specifying ..._
will render:
IHO 528-2019, IHO Standard for Inertial Sensor Terminology (2019). Available at: https://standards.iho.org/iho/528/7292/
-
If Relaton can not resolve the reference, the provided description will be rendered.
Example 4. Another example* [[[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/)