Skip to content
Metanorma

Exercises

.

The corresponding file is named {exercise-file}.adoc

  • [ ] Document title
  • [ ] Your name
  • [ ] Your organization using the :publisher: attribute
  • [ ] Your organization's address
  • [ ] The document class: ogc
  • [ ] The document type: standard
  • [ ] The language
  • [ ] The copyright year
Hint

To declare an attribute, follow the syntax :attribute: value.

For example: :publisher: Ribose Inc.

  • [ ] Abstract on line 19
  • [ ] Introduction on line 23
  • [ ] Scope on line 28
  • [ ] Conformance on line 41
  • [ ] Normative references on line 45
  • [ ] Terms and definitions on line 60
  • [ ] Bibliography on line 95
  • [ ] Add an ordered list in lines 23-27
  • [ ] Add a definition list in lines 34-50
  • [ ] Add an unordered list in lines 56-58
Hint

Ordered list items start with a dot, followed by a blank: . List item.

Unordered list items start with an asterisk, followed by a blank: * List item.

To write a definition list, follow the syntax:

`term
Definition`
  • [ ] Add an alternative term ("task")
  • [ ] Add a deprecated term ("process")
  • [ ] Add a definition: The (processing) job is a server-side object created by a processing service for a particular process execution.
Hint

The structure for a term definition looks like this:

=== Term
alt:[alternative term]
deprecated:[deprecated term]
definition
  • [ ] Create an empty three column table with five rows.
  • [ ] Add a table title: Namespace conventions.
  • [ ] Use the cols attribute to specify the ratio between the columns. Let's set the ratio to 2:3:4 so that the URI and Description rows are larger than the first row.
  • [ ] Populate the table like this:

.Namespace conventions

Prefix Namespace URI Description
ows http://www.opengis.net/ows/2.0 OWS Common 2.0 XML Schema
xlink http://www.w3.org/1999/xlink Definitions for XLINK
xml http://www.w3.org/XML/1998/namespace XML (required for xml:lang)
xs http://www.w3.org/2001/XMLSchema XML Schema
Hint

The structure for a three column table looks like this:

|===
|||
|||
|||
|===
  • [ ] Add an image macro.
  • [ ] Populate the image:: macro with this link:
https://en.wikipedia.org/wiki/Open_Geospatial_Consortium#/media/File:GeoServer_GeoNetwork_with_web_app.svg
  • [ ] Add a picture title: Relationship between clients/servers and OGC protocols
  • [ ] Create a key with three entries
GeoNetwork:: Catalog application to manage spatially referenced resources
GeoServer:: Open-source server for sharing geospatial data
Data stores:: Contain databases and shape files.
Hint

The syntax for images is: image::URL[].

Make sure to include the square brackets after the link.

  • [ ] Turn the text in line 22 into an IMPORTANT admonition.
  • [ ] Turn the text in line 24 into a WARNING admonition.
  • [ ] Turn the text in lines 26-27 into a NOTE admonition.
Hint

To create admonitions that span several lines, you need to declare a block.

[NOTE]
====
This is a long note.
It contains three lines.
Line three.
====
  • [ ] Create a source block with the attribute ruby for the code in lines 20-35.
  • [ ] Create a source block with the attribute python for the code in line 38.
  • [ ] Create a source block with the attribute java for the code in lines 41-45.
Hint

Source code blocks look like this:

[source, language]
====
Code
====
  • [ ] Add underline formatting to the sentence in line 23
  • [ ] Add bold formatting to "worldwide" in line 25
  • [ ] Add smallcaps formatting to "FAIR" in line 27
  • [ ] Add italic formatting to the OGC Innovation Program in line 30
  • [ ] Add a footnote on line 30 to explain the OGC Innovation Program. Footnote text: See all active initiatives at the OGC website. https://www.ogc.org/projects/initiatives/active[].
  • [ ] Add a visible index entry to "OGC" on line 25
  • [ ] Add an invisible three level index entry after "FAIR" on line 27: FAIR, findability, accessibility
  • [ ] Add an invisible two level index entry on line 30 after "OGC Innovation Program": OGC Innovation Program, innovation
  • [ ] Create a new index section at the bottom of the document
Hint

Visible index terms: \((Level 1 index term))

Hidden index terms: (\((Level 1 index term, Level 2 index term, Level 3 index term)))

  • [ ] Create an anchor for the table called tab-properties-of-the-descriptiontype-structure
  • [ ] Replace the word "ANCHOR" in line 44 with a reference to the table.

Bibliographic references: The text references some standards which don't have a matching entry in the bibliography section. Add the following bibliographic references:

Hint

Setting an anchor:

[[anchor]]

Referencing an anchor:

<<anchor>>
  • [ ] Line 25: commnuity
  • [ ] Line 27: agencys
  • [ ] Line 20: colaborative
cd Documents/Metanorma/metanorma-tutorial</code></pre></div><ol><li>Start the container and compile the document. To learn more about the command syntax and options, read the <a href="/software/metanorma-cli/docs/usage/">metanorma-cli documentation</a>.<div class="admonition admonition-note" data-admonition="note"><div class="admonition-header"><svg class="admonition-icon" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><circle cx="12" cy="8" r="1" fill="currentColor"/></svg><span class="admonition-label">Note</span></div><div class="admonition-body">The <a href="https://github.com/fontist/fontist" target="_blank" rel="noopener">fontist</a> automatically installs all needed fonts. The <code>--agree-to-terms</code> option agrees to all font license agreements that come up during the compilation process. If you don&#39;t set this option, you will be asked to agree to the licenses during the compilation process which might break it. + .Docker on Linux and macOS [source,sh] ---- docker run -v &quot;(pwd)":/metanorma/ -w /metanorma metanorma/metanorma metanorma compile -t ogc exercises/exercise-3-2.adoc --agree-to-terms ---- + .Docker on Windows [source,sh] ---- docker run -v "%cd%":/metanorma/ -w /metanorma metanorma/metanorma metanorma compile -t ogc exercises/exercise-3-2.adoc --agree-to-terms ----
Hint Result
  1. Relaton fetches checks the cited standards if it can fetch some information automatically. .
Example

Lines 47 and 66: Both sections have the anchor \[[prefatory-clause]] assigned. You can solve this error by renaming one of the anchors.

Hint Error 2

Line 76: The file that should be included cannot be found. Since the scope section already contains text, you can delete the reference.

Hint Error 3

Line 236: The image attribute contains a whitespace after image::, so the path is invalid. Delete the whitespace.

Edit this page on GitHub →