We're missing some documentation on how to deploy on GitHub pages (maybe add to an INSTRUCTIONS.adoc file in the templates?) (https://github.com/metanorma/metanorma-document-gh-pages/)

Right now the user has to do the following after cloning the document template:

1. Push the document template to a GitHub repo
2. use ssh-keygen to generate a key-pair which will be used as the "deploy key" (filename: deploy_key)
3. At GitHub, upload the public key of the deploy key and authorize "write access".
4. Enable Travis for this repository.
5. Use Travis command tools to encrypt this deploy key into deploy_key.enc
6. Add deploy_key.enc to the repo and push.

During deployment:

1. The make deploy_key task is used to decrypt the deploy_key.enc into deploy_key. (This step is not integrated into Travis deploy!! (TODO))
2. .travis.yml file includes a directive to push compiled documents to GitHub pages.

https://github.com/CalConnect/csd-admin-documents is an example of a mini-site for a collection of Metanorma documents.

Within this repository, it contains a folder called collection/ that provides a basic structure of a Metanorma collection.

For example, this could be fetched by calling metanorma collection new my-coll and the my-coll/ directory will be populated.

metanorma/metanorma-cli#264

Add tests to ensure the templates can compile