We are in active development of the content at the moment, and breaking changes are to be expected as we encounter new use cases. The version of the documents is thus below 1.0, somewhere about 0.6 (if that means anything) as what we have is reasonably stable but we do not guarantee it!
We use hyde (a Python based clone of jekyll) to manage the transformation from the easy-to-edit markdown content, into the nicely styled static HTML for the website. We use github to manage distributed contributions and continuous deployment.
To get up and running you need python 2.7 or more recent, plus pip:
pip install -r requirements.txt
./build.sh to generate all the example JSON-LD files and the site into .site
Note that build.sh runs
hyde gen twice ... the second time generates only the index that is created on the first run through.
hyde serve to run a local webserver at http://localhost:8080/ to view the site
Pull requests from any branch, regardless of which repository they're from, will auto-deploy to previews at https://deploy-preview-NNN--linked-art.netlify.com/, where NNN is the numeric identifier of the pull request. Commits on these branches with open PRs will re-deploy the preview.
Please join our discussions. How to get involved is described at: https://linked.art/community/
Most significant editorial changes are handled only after discussion with the community, filing of an issue and consensus around the solution. As this work is ongoing and very active, we are not currently tracking versions of the documents individually, or backwards incompatible changes.
Pull requests for typo corrections and other non-normative changes are very welcome from anyone.
Technical infrastructure improvements, such as tests, coverage or other integrations, are welcome but do drop by slack to discuss them first. Stylistic or HTML changes are the same.
If the build errors with a complaint about not being able to "generate meta", it is probably that you have a special character in the title of the document, such as a
:. Remember that the header is actually YAML, so put the title in double quotes.
The pymdown extras package is slightly broken with hyde at version 6.0 (late 2018), and hence we restrict the version in requirements. If some markdown functionality isn't working as expected, it could be this.
- Rob Sanderson (email@example.com)
- David Newbury
- Matthew Lincoln