add examples

[VladimirAlexiev]

@johanwk Thanks for inviting me to this work! I've forked the repo and can make Pull Requests.
Can you please add some example to make it easier to get oriented?
Eg elot-lob has file:images/example-ttl.svg but that is not included.

[johanwk]

I'm happy to add examples. As for the svg example you are referring to, that's obviously a left-over that should have been taken out.

What kind of example would you prefer to start with? More ontology content, or rdfpuml content? I'm happy with both.

With rdfpuml, my setup on Windows is kind of inconvenient. The Perl installation and everything, I wasn't able to make it portable at all. I think you mentioned a Docker image for rdfpuml -- would that be something that could be fetched from somewhere else, then made easy to access from this repo, perhaps?

[VladimirAlexiev]

Any examples you see fit!

• Obviously, it will be easier for me to help with rdfpuml diagramming
• But I also know OMN and a bit of org literate programming, so may be able to help with that too
• In particular, I see some intriguing tables in elot-template ("Overview of progress")
• I've just learned of org-ql and org-roam (previously dabbled with Roam and Zettelkasten): org is an ever-expanding world :-)

If you don't want to add examples to this repo, you can send them by email.

[johanwk]

Actually, the largest example so far is the Industrial Data Ontology, for which the document made with this tool is available at https://rds.posccaesar.org/ontology/lis14/ (see the link under the word "here"). A new version will be out very soon, we are wrapping up the next version by the end of next week, with hundreds of corrections and improvements. So, the IDO ontology is the main example we have so far. Note, the document there was made with MS Word, to satisfy ISO requirements, but only after the contents were written into the ELOT tool.

The IDO document available at the above link is very close to the ISO document, but modified so it can be distributed. IDO as new standard ISO 27326-3 is planned to be published in 2025.

[johanwk]

The org-ql tables are really powerful, and org-ql is under active development, so new features keep coming. Now, it's of course possible to just query the ontology using SPARQL, but -- there are advantages to having these queries in the ELOT document. You can add links and quickly jump to places you want to edit. You can typeset the tables and have them included in the document while working on draft versions. Completion "cookies" that show how complete you are with regard to annotation requirements (IDO uses the excellent annotation vocabulary by IOF) can be queried; these aren't even exported to the ontology document, so will not be available to SPARQL. And so forth -- all very nice.

[johanwk]

The IDO document includes quite a few rdfpuml diagrams. In some cases, they are tweaked to fit with ad-hoc content. For instance, it's difficult to show class unions in any reasonably compact way in ontology documentation. Maybe this is something we could look at together, for a reusable way to do it.

[VladimirAlexiev]

Hi! I know https://rds.posccaesar.org/WD_IDO.pdf (looked at it end of last year).
But I mean some simple example as org source (similar to what you've shown me), so we can retest as I make any changes to your code (org or elisp).
Thanks for a great meeting!

[johanwk]

I see! Yes, I'll see if I can add some examples in the repo today. Now that the new template <os is working, it's easy to create new ontologies.

OH, and by the way, the README needs to be updated. The "package" is now in subfolder elot-package, so that should be added to load-path, followed by `(load-library "elot").

[johanwk]

I just added pizza.org as an example!

This was converted from the original with Emacs keyboard macros.

The export to LaTeX is not quite right , but from a superficial inspection, the tangled OWL version seems to be at least very close to the original.

[johanwk]

Update to the pizza.org example: now there's a section called "ROBOT metrics" that illustrates how ROBOT can provide useful information.

[johanwk]

Update 9843b79 to pizza.org: sparql queries using ROBOT.