SI Brochure edition 9, semantic encoded version (WARNING: DRAFT)

Warning

DO NOT USE THESE FOR ANY OFFICIAL PURPOSE. These documents are under development — the authoritative documents can be found on the BIPM website.

Published components are available here:

• BIPM SI Brochure components index (DRAFT DOCUMENTS)

LICENSE

This work item belongs to the BIPM.

Official BIPM documents are distributed under the Creative Commons Attribution 3.0 IGO License.

Purpose

This repository holds the Metanorma source markup for the semantic version of the SI Brochure (edition 9) and its components.

These components include:

• SI Brochure (bilingual)

  • content body (fr, en)

  • Appendix 1 (fr, en)

  • Appendix 2: individual mise en pratique documents (en)

  • Appendix 3 (fr, en)

  • Appendix 4 (fr, en)

• SI Brochure concise summary (fr, en)

Rendering formats supported include:

• Metanorma semantic XML

• Metanorma presentation XML

• HTML

• PDF

Each of these components can be individually published.

The composite bilingual SI Brochure is compiled as a Metanorma collection which includes all its components as individual documents.

Structure

sources/si-brochure/

source files for the SI Brochure and its components.

sources/si-brochure/1.08

source files for the SI Brochure edition 9 v1.08, published 2020-09-17.

sources/si-brochure/2.01

source files for the SI Brochure edition 9 v2.01, published 2019-05-20.

sources/si-brochure/3.01

source files for the SI Brochure edition 9 v3.01.

Fetching the document

git clone https://github.com/metanorma/bipm-si-brochure/

Installing build tools

See https://www.metanorma.org/install/

Building the documents

Full set

Run the following command to build the full collection of the documents.

$ bundle exec metanorma site generate --agree-to-terms

SI Brochure

If you wish only to generate the bilingual SI Brochure, the following will suffice. (the brochure.yml file does not compile any MEP documents)

Compile document in single language

$ bundle exec metanorma sources/si-brochure/3.01/si-brochure-en.adoc

Compile collection with dual languages

$ bundle exec metanorma collection --agree-to-terms sources/si-brochure/3.01/collection.yml

This method generates the English and French SI Brochures separately, and then combines them together into the bilingual version.

metanorma sources/si-brochure-en.adoc
metanorma sources/si-brochure-fr.adoc
mkdir -p _site/documents
mv sources/si-brochure-en.xml _site/documents
mv sources/si-brochure-fr.xml _site/documents
metanorma collection collection.yml

Outputs

The following outputs will be built:

Component index

_site/index.html

Component outputs

under _site/documents/ (HTML, PDF, MN S/P XML)

Bilingual brochure

bilingual-brochure/collection.{pdf,xml,presentation.xml}

References

The original source files for the SI Brochure are available at:

• https://github.com/metanorma/bipm-si-brochure-refs (private link)

License

Content copyright BIPM. Other tools copyright Ribose.