Git Product home page Git Product logo

obofoundry.github.io's Introduction

OBO Foundry Registry and Website

This is the registry and website for the OBO Foundry. It is deployed with GitHub Pages and Jekyll to https://obofoundry.github.io and is then mapped to https://obofoundry.org.

For most questions, see the main site FAQ at https://obofoundry.org/faq/. For details on site development, please see README-sitedev.md

Contributing

I have some comments

You can use the issue tracker

I want to contribute

Please do! Anyone can fork and make PR, or create an issue in the tracker.

Note that most members of the community will do this via the obofoundry.org website - each ontology page has links for editing the metadata.

See CONTRIBUTING.md

Repo Organization

Instructions for Registry Curators

See this FAQ entry for simple web-based editing of metadata

Please edit the source files in the ontology/ directory only.

For example:

Each *.md file consists of

  • YAML metadata
  • Markdown text to be shown on the page for that ontology

For example:

---
layout: ontology_detail
id: aeo
title: Anatomical Entity Ontology
contact: 
  email: [email protected]
  label: Jonathan Bard
description: AEO is an ontology of anatomical structures that expands CARO, the Common Anatomy Reference Ontology
domain: anatomy
homepage: http://www.obofoundry.org/wiki/index.php/AEO:Main_Page
products: 
  - id: aeo.owl
---

AEO is an ontology of anatomical structures that expands CARO, the Common Anatomy Reference Ontology, to about 200 classes using the is_a relationship; it thus provides a detailed type classification for tissues. The new classes were chosen for their use in categorizing the major vertebrate and invertebrate anatomy ontologies at a granularity adequate for tissues of a single cell type. The ontology should be useful in increasing the amount of knowledge in anatomy ontologies, facilitating annotation and enabling interoperability across anatomy ontologies

The aeo page shows the structured info on the right and the formatted text on the right. (THIS IS A BAD EXAMPLE IT HAS NO FORMATTING)

The YAML data is strictly vetted by OBO team. The Makefile takes care of syntactic validation (the GitHub Actions runs make test). The OBO team ensures the content is correct, up to date and accurate.

You can put any HTML or Markdown in the lower section - customize each ontology page!

Note that each md file is the primary source for the metadata for each ontology. It may seem odd to mix the markdown in with the yaml, but in practice this works well and is easy to manipulate using the python script in the util/ directory.

The one piece of visual info in the md is the layout field, which is necessary for Jekyll.

RDF

The yaml is all "YAML-LD" and can compile down to RDF/OWL using a generic translator (eg JENA) plus our context file.

Community Contributions

Note that general OBO users are free to edit via the GitHub web interface and make a pull request. They can update their own entries, but they are also welcome to suggest changes elsewhere.

On the live site, each page has links to view source and edit source. This makes use of githubs builtin editing facility

For example:

Note that joe randoms cannot just come in and update things. Anyone with a GitHub account can make pull request (aka PR). It is up to the OBO team whether the PR may be merged or rejected.

Note that if you make a syntax error whilst editing, then the GitHub Actions check will fail. Your PR will have a big red X next to it, in which case the OBO team will not merge your PR. Don't worry, all you have to do is make further edits to fix the syntax error.

TODO: add a quick guide to yaml, and the tags we use.

Central OBO library build

(see also the FAQ entry on this)

The central OBO build runs here:

It takes as metadata input the yml file from this repository. It makes use of the build object.

The output of this job is a set of obo and owl files deposited in

Depending on the build configuration, this may also make additional files. See for example:

A http://berkeleybop.org/ontologies/ URL should never be handed out directly. This service exists so that:

  • Un PURL-registered ontologies will have a fall-through
  • Registered PURL ontologies that do not want to take charge of either OBO or OWL generation will have a place to 302-redirect to

This job will fail if ontologies marked as infallible fail. To debug, the full log of the last build can be examined:

(Look for the text "should not fail")

Instructions for Website Development

See README-sitedev.md

obofoundry.github.io's People

Contributors

cmungall avatar matentzn avatar jamesaoverton avatar nataled avatar cthoyt avatar nicolevasilevsky avatar nlharris avatar rvita avatar github-actions[bot] avatar lschriml avatar mcourtot avatar zhengj2007 avatar ramonawalls avatar apmody avatar balhoff avatar wdduncan avatar alanruttenberg avatar erik-whiting avatar cooperl09 avatar bpeters42 avatar yongqunh avatar pfabry avatar tophat8855 avatar actions-user avatar rgduser avatar mah11 avatar leechuck avatar deepakunni3 avatar cstoeckert avatar selewis avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.