Name: ontology-starter-kit
Owner: INCATools
Description: Bootstrap an OBO Library ontology
Created: 2015-12-15 14:28:35.0
Updated: 2018-05-19 01:34:03.0
Pushed: 2018-05-19 01:34:34.0
Homepage: null
Size: 74
Language: Perl
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
Initialize a GitHub repo for managing your ontology the OBO Library way!
For more details, see
Any Linux or OS X command line environment should work. You will minimally need the following installed:
The kit will also try to make an initial ontology release, unless you tell it not to. It will attempt to download the following dependencies:
It's recommended you get a release version: https://github.com/INCATools/ontology-starter-kit/releases
First you must be in the root level of the starter kit
cd ontology-starter-kit
The seed-my-ontology-repo.pl command does everything you need. For help:
./seed-my-ontology-repo.pl -h
An example:
./seed-my-ontology-repo.pl -d po ro pato -u cmungall -t "Triffid Behavior ontology" triffo
You can list any set of dependencies you like after “-d”. However, these must be the official OBO ontology IDs. See http://obofoundry.org for details.
This will create your starter files in
target/triffid-behavior-ontology. It will also prepare an initial
release and initialize a local repository (not yet pushed to GitHub).
You can customize at this stage, or (recommended) after making an initial push to github
The starter kit will automatically initialize a git project, add all files and commit.
You will need to create a project on GitHub.
-u option. The MUST be the one you set with -t.Follow the instructions there. E.g.
arget/triffid-behavior-ontology
remote add origin git@github.com:cmungall/triffid-behavior-ontology.git
push -u origin master
Note: you can now mv target/triffid-behavior-ontology to anywhere you like in your home directory. Or you can do a fresh checkout from github
In your repo you will see a README-editors.md file that has been customized for your project. Follow these instructions.
Generally the cycle is to:
To make a release
make prepare_release
Note that any make step can be preceded by run.sh if you have Docker installed
The assumption here is that you are ahdering to OBO principles and want to eventually submit to OBO. Your repo will contain stub metadata files to help you do this.
You can create pull requests for your ontology on the OBO Foundry. See the src/metadata file for more details.
For more documentation, see http://obofoundry.org
You will want to also:
See the README-editors.md file that has been generated for your project.
If you have issues, file them here: https://github.com/INCATools/ontology-starter-kit/issues
Some things to check:
target dir, or use the -c optionYou will likely want to customize the build process, and of course to edit the ontology.
The main thing you will want to do is to modify the seeds that are used to build the imports. The ones that are there are just examples, edit them as you like. See the ROBOT docs and the OBO Tutorial for more info.
The OSK is designed for creating a new repo for a new ontology. It can still be used to help figure out how to migrate an existing github repository to the OSK structure. There are different ways to do this.
Manually compare your ontology against the template folder and make necessary adjustments
Run osk as if creating a new repo. Manually compare this with your existing repo and use git mv to rearrange, and adding any missing files by copying them across and doing a git add
Create a new repo de novo and abandon your existing one, using github issue mover to move tickets across.
Obviously the second method is not ideal as you lose your github history. Note even with git mv history tracking becomes harder
You will find additional documentation in the src/ontology/README-editors.md file in your repo