DEPRECATED: Use https://github.com/linkml/linkml-model-template instead
This is a GitHub template for a LinkML project.
It allows you to create a project for your schema as quickly as possible. It takes care of generating a beautiful readthedocs themed site, as well as downstream artefacts, including:
.yaml
suffixmake install all
to build your downstream artefacts (jsonschema, owl, etc)make gh-deploy
to make a github pages websiteMinor tweak: for now you must pass in the name of your schema on the command line, e.g.
make all SCHEMA_NAME=my_awesome_schema
This repo is a GitHub "template" repo. When you "Use this template" it will make a copy for your project.
Everything is orchestrated by a generic single Makefile. For this to work you should follow certain conventions:
.yaml
suffix for all schema filesTo run the Makefile you will need Python (>=3.7), and linkml. You can type:
make install
or equivalently
. environment.sh
pip install -r requirements.txt
You can make specific targets, e.g
make stage-jsonschema
Use the all
target to make everything
Note to redeploy documentation all you need to do is:
make gh-deploy
That's it!
The Makefile takes care of dependencies. Downstream files are only rebuilt if source files change.
You can change the theme by editing mkdocs.yml
Do not edit docs in place. They are placed in the docs
dir by make stage-docs
.
You can add your own docs to `src/docs/
Note that docs are actually deployed on the gh-pages branch, but you don't need to worry about this. Just type:
make gh-deploy
The template site is deployed on
http://cmungall.github.io/linkml-template
But this is not very interesting as it is a toy schema