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
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
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.
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
colsattribute 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 |
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.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
IMPORTANTadmonition. - [ ] Turn the text in line 24 into a
WARNINGadmonition. - [ ] Turn the text in lines 26-27 into a
NOTEadmonition.
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
rubyfor the code in lines 20-35. - [ ] Create a source block with the attribute
pythonfor the code in line 38. - [ ] Create a source block with the attribute
javafor the code in lines 41-45.
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
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:
- [ ] dcat, W3C vocab-dcat, W3C: Data Catalog Vocabulary, W3C Recommendation 16 January 2014, https://www.w3.org/TR/vocab-dcat/
- [ ] iso19101, ISO 19101, ISO: ISO 19101-1:2014 -- Geographic information -- Reference model -- Part 1: Fundamentals https://www.iso.org/standard/59164.html
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'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 "(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 ----- Relaton fetches checks the cited standards if it can fetch some information automatically. .
Lines 47 and 66: Both sections have the anchor \[[prefatory-clause]] assigned. You can solve this error by renaming one of the anchors.
Line 76: The file that should be included cannot be found. Since the scope section already contains text, you can delete the reference.
Line 236: The image attribute contains a whitespace after image::, so the path is invalid. Delete the whitespace.