Skip to content

Commit

Permalink
chore: clean up iso document scheme content
Browse files Browse the repository at this point in the history
  • Loading branch information
ronaldtse committed Apr 5, 2024
1 parent 0a48954 commit 9566946
Show file tree
Hide file tree
Showing 3 changed files with 30 additions and 8 deletions.
7 changes: 6 additions & 1 deletion author/iso/ref/document-attributes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,12 @@ stage "`60`" (published), where a substage of "`60`" is assumed.
Specifies the version of the ISO document specification that should be used in
generating the Metanorma document.
[added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.1]
Currently used only to specify the PDF layout.
+
When omitted, the scheme to apply is inferred from the `:copyright-year:`
document attribute, if set. Otherwise, the current default scheme is
applied. [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].
+
NOTE: Currently used only to specify the PDF layout.

`2024`::: (default) Latest document layout as of 2024 (default)
`2013`::: Document layout used from 2013 to early 2024.
Expand Down
25 changes: 20 additions & 5 deletions author/iso/topics/markup.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,23 @@ title: Metanorma for ISO markup

Metanorma ISO supports multiple layouts of ISO documents through the
`:document-scheme:` document attribute [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.1].
If the `:document-scheme:` is not provided, the scheme to apply is inferred based on the `:copyright-year:` document attribute
(without allowing for the month in which transition was made from one scheme to another -- which in any case was
not always a clean transition historically) [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].
If neither of those attributes is present, the current default is applied, `2024`.

If the `:document-scheme:` is not provided, the scheme to apply is inferred
solely based on the `:copyright-year:` document attribute.

If neither of those attributes is present, the current default is applied.

NOTE: The current default is `2024`.

NOTE: Metanorma does not consider the month in selecting the actual document
scheme because historically the transitions made from one scheme to another were
according to a specific cut-off
date [added in https://github.com/metanorma/metanorma-iso/releases/tag/v2.7.6].

Specific instructions on using these layouts are described below.

=== 2024 (latest)

=== 2024 (latest and default)

The following attributes should be set:

Expand Down Expand Up @@ -59,6 +68,12 @@ The following attributes should be set:

* `:classification:` to set the UDC code(s).

=== 1979

The following attributes should be set:

* `:classification:` to set the UDC code(s).

=== 1972

The following attributes should be set:
Expand Down
6 changes: 4 additions & 2 deletions author/topics/output/font-management.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,10 @@ given the correct font files.
== Automatic font installs with Fontist

To make openly-licensed fonts available, Metanorma is integrated with
https://github.com/fontist/fontist[Fontist] --
a cross-platform font installer that helps you install publicly available fonts.
https://github.com/fontist/fontist[Fontist].

Fontist is a cross-platform font installer that helps you install publicly
available fonts.

If Metanorma detects that a necessary font is missing on your
setup, it would automatically invoke Fontist to install the font.
Expand Down

0 comments on commit 9566946

Please sign in to comment.