search

DigitalCommons / map-sse

Metadata Application Profile for the Social and Solidarity Economy
0 stars 0 forks source link

Regenerate HTML version of ESSGLOBAL #2

Closed wu-lee closed 2 years ago

wu-lee commented 3 years ago

Currently the HTML "front page" is static, and not generated from the RDF. It should be, as it will be going out of sync...

https://vocabs.solidarityeconomy.coop/essglobal/V2a/html-content/essglobal.html

wu-lee commented 3 years ago

Having trouble finding any tools to do this... I can't see evidence of any tools being used to generate it in this repository.

Other tools which might get there:

wu-lee commented 3 years ago

See also: https://web.archive.org/web/20151031172323/http://answers.semanticweb.com/questions/1087/generating-documentation-from-rdfs-andor-owl-vocabularies

ColmMassey commented 2 years ago

@ThomasDavisonsGit I'd recomment looking at https://datafoodconsortium.gitbook.io/dfc-standard-documentation/

for what is probably the closest project I know to what we are doing? They may have some tools we could use to visualise and edit our schemas.

ColmMassey commented 2 years ago

At the meeting on Thursday we discussed defining a simpler rdf visualisation task with immediate use. Can you create a script which given a language, generates a simple html page which lists all our supported VESs (Vocabulary Encoding Scheme) and their respective terms listed by its label in the requested language?

Like:

ColmMassey commented 2 years ago

Actually first step should be just a csv file with the same info VES Labels in the first row and then list the terms in each column.

ColmMassey commented 2 years ago

OBO project now needs a csv file listing Organisational Structure VES & Economic Activities/Sectors (Modified) VES

ColmMassey commented 2 years ago

This issue (https://github.com/SolidarityEconomyAssociation/open-data/issues/63) is not the same but might end up being addressed as a side effect.

wu-lee commented 2 years ago

Like this? (These are actually tab-delimited, for easier eyeball access, but should cut & paste into a spreadsheet in the same way as a CSV.) The term column is the final part of the term URI. The EN column is the English version of the prefLabel property.

organisational-structure:

term    EN
OS10    Community group (formal or informal)
OS20    Not-for-profit organisation
OS30    Social enterprise
OS40    Charity
OS50    Company (Other)
OS60    Workers cooperative
OS70    Housing cooperative
OS80    Consumer/User coops
OS90    Producer cooperative
OS100   Multi-stakeholder cooperative
OS110   Secondary cooperative
OS115   Cooperative
OS120   Community Interest Company (CIC)
OS130   Community Benefit Society / Industrial and Provident Society (IPS)
OS140   Employee trust
OS150   Self-employed
OS160   Unincorporated
OS170   Mutual
OS180   National apex
OS190   National sectoral federation or union
OS200   Regional, state or provincial level federation or union
OS210   Cooperative group
OS220   Government agency/body
OS230   Supranational
OS240   Cooperative of cooperatives / mutuals

activities-modified:

term    EN
AM10    Arts, Media, Culture & Leisure
AM20    Campaigning, Activism & Advocacy
AM30    Community & Collective Spaces
AM40    Education
AM50    Energy
AM60    Food
AM70    Goods & Services
AM80    Health, Social Care & Wellbeing
AM90    Housing
AM100   Money & Finance
AM110   Nature, Conservation & Environment
AM120   Reduce, Reuse, Repair & Recycle
AM130   Agriculture
AM140   Industry
AM150   Utilities
AM160   Transport

Basic HTML-isations of this should be trivial.

wu-lee commented 2 years ago

See also full vocab localisations here: https://nextcloud.solidarityeconomy.coop/index.php/apps/onlyoffice/s/i8dNYqbmj7MXrax

ColmMassey commented 2 years ago

Coming together nicely.

ColmMassey commented 2 years ago

I wonder before tackling the full https://vocabs.solidarityeconomy.coop/essglobal/V2a/html-content/essglobal.html

should we start with the simpler html pages we generate like

https://prod.data.solidarityeconomy.coop/ica/35336.html ?

wu-lee commented 2 years ago

An update.

Tom and I looked at dowl.rb and managed to get it working (it's just bitrotted slightly). It works with it's own supplied example, but not with one of our vocabs (we used activities-ica.ttl), because dowl expects the graph to have an ontology property with a title (there isn't in ours.)

However, what it does is fairly straightforward: read in a bunch of triples, stick it together into a data structure, and pass that to a HTML template to be rendered. This sticking-together can be fairly generic, but the rendering in dowl would need to be changed allow for our expectations of the vocab data.

So Tom is planning to try and alter it to consume our vocabs, and the result can be discussed.

Looking at the Ruby projects on the Rubygems website which use RDF.rb I found one called yowl - this turns out to be a newer fork of dowl. Unfortunately the author deleted/hid his GitHub repository for it, which implies it is no longer maintained either. (The last release was 2013 or so.) The code is still accessible on Rubygems, however.

wu-lee commented 2 years ago

We should also investigate LODE, which is one of the options on LOV to display information about the vocabs there. The links don't work because the server seems offline, as are pretty much all of the alternative tools there.

Here's a paper describing LODE:

https://explore.dublincore.net/learning_resource/making-ontology-documentation-with-lode/

The main website seems to be: https://essepuntato.it/lode/

They don't make it very easy to find but there is a Github project for it here:

https://github.com/essepuntato/LODE

The code is in Java, and it looks relatively maintained, with commits up to 2021.

The output looks a but like the usual W3C documents - so possibly too technical for some audiences, and experiments with dowl are useful anyway.

wu-lee commented 2 years ago

Found linked on the LODE website, this best-practices guide for publishing linked data vocabs looks worth studying:

https://www.w3.org/TR/swbp-vocab-pub/

ColmMassey commented 2 years ago

I wonder can we find a conference to attend?

ColmMassey commented 2 years ago

@lin-d-hop

ColmMassey commented 2 years ago

Just noting, there are some discussions relating to this ticket here

ColmMassey commented 2 years ago

So I think once

We could close this ticket, but actually I think we are abusing this ticket and we should consider splitting them out into new ones.

ColmMassey commented 2 years ago

A lot of discussion of this issue has spilled into https://docs.google.com/document/d/1hBlD-0apFPmiqnX_uzpw-oN5OJTtZScOE1fVUX8sVK4/edit which is not public. We'll steer the discussions back to github or the #semantics:digitalcommons.coop matrix channel.

wu-lee commented 2 years ago

A general update is that @ThomasDavisonsGit 's reworking of DOWL into "Goth" is generating reasonable looking documentation. It has some hard-wired things which need to be configurable - for example it needs to be

There may be a few other small things, Tom and I were discussing this in person yesterday.

ThomasDavisonsGit commented 2 years ago

I was going to ask what needs to be done to close this ticket, and I see some points from Colm and from Nick above. I suggest closing this ticket now and transferring any unresolved items to separate issues on my repository here: https://github.com/ThomasDavisonsGit/goth

Thoughts?

wu-lee commented 2 years ago

Agreed

ColmMassey commented 2 years ago

Let's close once the a new page hax replaced the old one and the outstanding items are in new tickets. Please @ me in new tickets.

ThomasDavisonsGit commented 2 years ago

Goth and its issues moved to here: https://github.com/DigitalCommons/goth

ColmMassey commented 2 years ago

We can close this as a new autogenerated docuement is now published to https://dev.vocabs.solidarityeconomy.coop/essglobal/2.1/html-content/essglobal.html

Nice. :-) Will create new tickets for the remaining small twaeks and bugs identified.