Metanorma: Aequitate Verum

tag::exercise-2-1[] Now it’s your turn. Fill the document with the following attributes:

Hint

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

For example: :publisher: Ribose Inc.

end::exercise-2-1[]

tag::exercise-2-2[] Look at the prepopulated Metanorma document. There are many clauses describing the content but there are sections missing to form a correct standard document.

Add the following sections:

end::exercise-2-2[]

tag::exercise-2-3-1[] Add lists to the prepopulated document.

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

end::exercise-2-3-1[]

tag::exercise-2-3-2[] Create a term definition entry for the term "immature kernel":

Hint

The structure for a term definition looks like this:

=== Term
alt:[alternative term]
deprecated:[deprecated term]

definition

end::exercise-2-3-2[]

tag::exercise-2-3-3[] Let’s compare rice against wheat in a table:

Table 1. Nutrient profile of rice vs. wheat

Nutrient

Rice

Wheat

Energy (kJ)

1736

1574

Protein (g)

8.1

14.5

Fat (g)

0.8

1.8

Carbohydrates (g)

91

82

Fiber (g)

1.5

14

Sugar (g)

0.1

0.5

Hint

The structure for a three column table looks like this:

|===
|||
|||
|||
|===

end::exercise-2-3-3[]

tag::exercise-2-3-4[] Insert an image of a rice plant in line 17 by following the steps below:

 https://upload.wikimedia.org/wikipedia/commons/2/27/Oryza_sativa_-_K%C3%B6hler%E2%80%93s_Medizinal-Pflanzen-232.jpg
A:: Rice - A flowering specimen of the variety _melanoceras_ Alef.
B:: blossom panicle
C:: crop panicle
Hint

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

Make sure to include the square brackets after the link.

end::exercise-2-3-4[]

tag::exercise-2-3-5[] Turn the existing text into admonitions:

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.
====

end::exercise-2-3-5[]

tag::exercise-2-3-6[] There are some code samples in the document but they are not neatly packed into source blocks, so they cause trouble.

Hint

Source code blocks look like this:

[source,language]
----
Code
----

end::exercise-2-3-6[]

tag::exercise-2-4-1[]

Format the text using the following formatting:

tag::exercise-2-4-2[] Let’s add some index entries to the text.

Hint

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

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

end::exercise-2-4-2[]

tag::exercise-2-4-3[] Let’s add some references to the sample document.

Internal references:

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

Hint

Setting an anchor: [[anchor]]

Referencing an anchor: <<anchor>>

end::exercise-2-4-3[]

tag::exercise-3-1[] The text contains some typos. Mark the errors using comments.

tag::exercise-3-2[] Enter the command metanorma document.adoc into the terminal and see what happens. end::exercise-3-2[]

tag::exercise-4[] The following document doesn’t compile because there are some errors.

  1. Enter metnanorma exercise-4.adoc to trigger the build process

  2. Have a look at the error messages

  3. Try to debug the document. If you get stuck, have a look at the hints.

  4. Once you solved the errors, run metanorma exercise-4.adoc again to see if the document compiles.

Hint Error 1

Lines 12 and 43: Both sections have the anchor [[prefatory-clause]] assigned. You can solve this error by renaming 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 420: The image attribute contains a whitespace after image::, so the path is invalid. Delete the whitespace.

end::exercise-4[]