Output directory containing the formatted manuscript
gh-pages branch hosts the contents of this directory at https://$OWNER_NAME.github.io/$REPO_NAME/.
The permalink for this webpage version is https://$OWNER_NAME.github.io/$REPO_NAME/v/$TRAVIS_COMMIT/.
To redirect to the permalink for the latest manuscript version at anytime, use the link https://$OWNER_NAME.github.io/$REPO_NAME/v/freeze/.
This directory contains the following files, which are mostly ignored on the
index.htmlis an HTML manuscript.
github-pandoc.csssets the display style for
manuscript.pdfis a PDF manuscript.
v directory contains directories for each manuscript version.
In general, a version is identified by the commit hash of the source content that created it.
*.ots files in version directories are OpenTimestamps which can be used to verify manuscript existence at or before a given time.
OpenTimestamps uses the Bitcoin blockchain to attest to file hash existence.
deploy.sh script run during continuous deployment creates the
There is a delay before timestamps get confirmed by a Bitcoin block.
.ots files are initially incomplete and should be upgraded at a later time, so that they no longer rely on the availability of a calendar server to verify.
webpage.py, which is run during continuous deployment, identifies files matched by
webpage/v/**/*.ots and attempts to upgrade them.
You can also manually upgrade timestamps, by running the following in the
ots upgrade v/*/*.ots rm v/*/*.ots.bak git add v/*/*.ots
Verifying timestamps with the
ots verify command requires running a local bitcoin node with JSON-RPC configured, at this time.
The manuscripts in this directory were built from