vocab icon indicating copy to clipboard operation
vocab copied to clipboard

Define Solid vocabulary

Open RubenVerborgh opened this issue 6 years ago • 5 comments

RubenVerborgh avatar Jul 11 '19 08:07 RubenVerborgh

What do you mean by "add"?

http://www.w3.org/ns/solid/terms can be referred from "Namespaces". See https://github.com/solid/specification/pull/83 .

We can describe and exemplify some aspects of the vocab without defining anything.

csarven avatar Oct 02 '19 21:10 csarven

I was reserving the term "defining" to http://www.w3.org/ns/solid/terms . The vocabulary can be described in its own document similar to https://www.w3.org/TR/annotation-vocab/ or https://www.w3.org/TR/activitystreams-vocabulary/ . It should not go into The Solid Ecosystem document.

csarven avatar Oct 03 '19 22:10 csarven

Sure, happy to work on this. We can publish that document in HTML(+RDFa) from http://www.w3.org/ns/solid/terms in addition to the current Turtle.

csarven avatar Oct 03 '19 22:10 csarven

Just a question @csarven: I've been using Widoco (https://github.com/dgarijo/Widoco) to auto-generate really nicely formatted HTML documentation directly from the vocab RDF itself for vocabs I create myself. Are you familiar with that tool? I don't know if Widoco generates RDFa within that HTML too, but it would be really cool if we could generate lovely documentation like https://www.w3.org/TR/annotation-vocab/ or https://www.w3.org/TR/activitystreams-vocabulary/ automatically from the RDF itself without doing any work at all...?

pmcb55 avatar Oct 04 '19 11:10 pmcb55

If source is authored in HTML+RDFa eg. same as the process that will be taken for https://github.com/solid/specification/issues/6 , other serializations can be generated. I think that is the most efficient and flexible way of doing it. But I understand that some have their heart on writing vocabs in Turtle :)

csarven avatar Oct 04 '19 12:10 csarven