Skip to content

Commit

Permalink
PR to merge rootstock changes on 2019-03-14
Browse files Browse the repository at this point in the history
This build is based on
1ddd48d.

This commit was created by the following Travis CI build and job:
https://travis-ci.org/dhimmel/rephetio-manuscript/builds/506344659
https://travis-ci.org/dhimmel/rephetio-manuscript/jobs/506344668

[ci skip]

The full commit message that triggered this build is copied below:

PR to merge rootstock changes on 2019-03-14

Merges #5
  • Loading branch information
dhimmel committed Mar 14, 2019
1 parent 8c8664a commit 3ee3120
Show file tree
Hide file tree
Showing 23 changed files with 16,404 additions and 371 deletions.
27 changes: 24 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Output directory containing the formatted manuscript

The [`gh-pages`](https://github.com/dhimmel/rephetio-manuscript/tree/gh-pages) branch hosts the contents of this directory at https://dhimmel.github.io/rephetio-manuscript/.
The permalink for this webpage version is https://dhimmel.github.io/rephetio-manuscript/v/1ddd48dabdb669a3c09b1a3dfdfee455f642b5a9/.
To redirect to the permalink for the latest manuscript version at anytime, use the link https://dhimmel.github.io/rephetio-manuscript/v/freeze/.

## Files

Expand All @@ -9,10 +11,29 @@ This directory contains the following files, which are mostly ignored on the `ma
+ [`index.html`](index.html) is an HTML manuscript.
+ [`github-pandoc.css`](github-pandoc.css) sets the display style for `index.html`.
+ [`manuscript.pdf`](manuscript.pdf) is a PDF manuscript.
+ `*.ots` files are OpenTimestamps which can be used to verify manuscript existence at or before a given time.
[OpenTimestamps](opentimestamps.org) uses the Bitcoin blockchain to attest to file hash existence.

The `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.

### Timestamps

The `*.ots` files in version directories are OpenTimestamps which can be used to verify manuscript existence at or before a given time.
[OpenTimestamps](https://opentimestamps.org/) uses the Bitcoin blockchain to attest to file hash existence.
The `deploy.sh` script run during continuous deployment creates the `.ots` files.
There is a delay before timestamps get confirmed by a Bitcoin block.
Therefore, `.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 `gh-pages` branch:

```sh
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.

## Source

The manuscripts in this directory were built from
[`7b5b0e67fb9ab159c84c230dd5c07001941d82af`](https://github.com/dhimmel/rephetio-manuscript/commit/7b5b0e67fb9ab159c84c230dd5c07001941d82af).
[`1ddd48dabdb669a3c09b1a3dfdfee455f642b5a9`](https://github.com/dhimmel/rephetio-manuscript/commit/1ddd48dabdb669a3c09b1a3dfdfee455f642b5a9).
8 changes: 3 additions & 5 deletions images/github.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 3 additions & 11 deletions images/orcid.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 4 additions & 5 deletions images/twitter.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 3ee3120

Please sign in to comment.