Metanorma: Aequitate Verum

Creating a new document from a template

The easiest way to get started is with a template because it provides the document structure and lets you fill in the content. To see which document types are available as a samples, check out the IHO sample documents repository.

  1. Open a new terminal window on your computer.

  2. Use the cd command to navigate to the folder where the documents should be copied to.

  3. To copy the template to your machine, use the new command and specify the organization type and document.

    metanorma new PROJECT-NAME -t ORGANIZATION -d DOCUMENT-TYPE

  4. Edit the copied files with a text editor of your choice.

These examples illustrate how to use metanorma new in different setups:

Local Metanorma installation
metanorma new my-new-standard -t iho -d standard
Metanorma in Docker (MacOS)
docker run -v "$(pwd)":/metanorma/ \
  -w /metanorma metanorma/mn
  metanorma new my-new-standard -t iho -d standard
Metanorma in Docker (Windows, cmd)
docker run ^
  -v %cd%:/metanorma ^
  -w /metanorma ^
  metanorma/mn ^
  metanorma new my-new-standard -t iho -d standard
Metanorma in Docker (Windows, Powershell)
docker run `
  -v ${pwd.Path}:/metanorma `
  -w /metanorma `
  metanorma/mn `
  metanorma new my-new-standard -t iho -d standard

The blog post about templates discusses the technical details of templates.