Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tooling for ontology development and documentation #5

Open
jokroese opened this issue Apr 11, 2024 · 3 comments
Open

Tooling for ontology development and documentation #5

jokroese opened this issue Apr 11, 2024 · 3 comments

Comments

@jokroese
Copy link
Member

It turns out @valevo is old school and writes directly in HTML. This is fine for now (and quite funny for me).

However, this isn't ideal for maintenance longer term.

I'm wondering what tooling is available for developing, documenting and maintaining ontologies. This is a new area to me so we will need some research.

@jokroese jokroese converted this from a draft issue Apr 11, 2024
@jokroese jokroese changed the title Tooling for ontology documentation Tooling for ontology development and documentation Apr 11, 2024
@jokroese
Copy link
Member Author

From some initial research I've found:

  • We should probably define the ontology in Turtle for its readability (human-friendly and concise), ease of use, and wide support.
  • Protégé, an ontology editor with a graphical interface: https://protege.stanford.edu/. This seems to be a pretty standard tool for ontology development
  • WebVOWL, app for visualising ontologies: https://github.com/VisualDataWeb/WebVOWL. Less widespread, not actively maintained but does a nice job for the focus on communicating the ontology to a non-technical audience which we've spoken about as important. There may be alternatives to this.

@jokroese
Copy link
Member Author

After that, I found this Awesome List for ontology resources: https://github.com/ozekik/awesome-ontology as well as this list focused on ontology resources for digital humanities: https://github.com/CLARIAH/awesome-humanities-ontologies. This section of Awesome Semantic Web is also useful as a more selective list: https://github.com/semantalytics/awesome-semantic-web?tab=readme-ov-file#ontology-development.

@jokroese
Copy link
Member Author

I was also thinking about (and haven't yet seen) nice, flexible ways to take an ontology as input and create customisable documentation websites. I'm particularly interested in this as we are set on making sure that this ontology can be easily communicated.

Some documentation tools exist (Wideco, Oontology, LODE) but they all look pretty formal and plain and, at first glance, non-customisable. I want graphs and colours and to get Radical Data-y with it!

I don't think it would be too hard to build a better alternative from scratch. One workflow could be: Turtle file defining the ontology -> convert to JSON-LD -> read as data in a framework like Astro.

There are also tools that turn a .ttl file into an API (e.g. OBA). We could do this and use it for building the website. This is an extra step but maybe having an open API could be useful for something else?

If we decide to build an alternative, we should create a template version so that others can point it to their ontology and get a nice customisable website out of it.

@valevo valevo moved this from Todo to In Progress in MoSA Ontology May 13, 2024
@valevo valevo moved this from In Progress to Archive in MoSA Ontology May 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: Archive
Development

No branches or pull requests

1 participant