Manage the development and maintenance of the ToIP Foundation level white paper. This paper focuses on how the Foundation is organized and what it will deliver.
This repo contains the content resources for the generation of a white paper deliverable. It contains the tools necessary to generate two document renderings (printed, online).
- Online White Paper Access
- Printable White Paper (PDF Version)
- MkDocs
- PDF Generation
The ToIP Foundation leverages uses standard pull-request code collaboration processing. Contributors to this repo should create a fork and then use that fork as the origin for their local machine based development.
This repo uses GitHub Pages to host the static HTML content that is generated by MkDocs. The gh-pages branch reflects the latest committed docs. See make pages.
Use make to manage the build process for this repo.
$ make
- Clone repository
git clone git@github.com:trustoverip/foundation-white-paper.git
git remote
git remote add upstream git@github.com:trustoverip/foundation-white-paper.git
git remote
- Setup Environment
$ make setup
Iteratively develop documentation content using markdown files.
$ make dev
Iteratively review online content using localhost.
$ make test
This repo uses mkdocs gh-deploy to push generated HTML content to the gh-pages branch on the origin repo on GitHub. This process also creates a single PDF document in the pdf folder but the file is not pushed.
$ make pages
Note: You can ignore the DEBUG and WARNING messages during the PDF generation.
To complete the development process, follow normal git commit and git push processing. The .gitignore file will prevent the pushing of the static HTML content.
Before each coding session, insure your fork and local-machine are in sync with changes made to the upstream repo.
make rebase
This repo uses a GitHub Workflow process coupled with a GitHub Action to automatically refresh the GitHub Pages on the upstream repo.
Please refer to mkdocs-pdf-export-plugin for PDF tooling configuration help.