Feature #1710
closedManual: add CIDOC links for entity classes
Description
Jona from the INDIGO project kindly suggested to add CIDOC links to the entities documented in the manual.
This is a great suggestion and we will implemented it for the next version.
Updated by Bernhard Koschiček-Krombholz over 2 years ago
An example link would be: https://cidoc-crm.org/entity/e5-event/version-7.1.1
Updated by Alexander Watzinger over 2 years ago
- Status changed from Acknowledged to Assigned
- Assignee set to Nina Richards
- cidoc_url = https://cidoc-crm.org/
- cidoc_version = version-7.1.1
So that we can build links like {cidoc_url}entity/e5-event/{cidoc_version}, which would be helpful e.g if the used version changes.
These links could be placed under the title of entity entries like e.g. CIDOC class: E5 Event (where the bold text is linked)
Updated by Alexander Watzinger over 2 years ago
- Status changed from Assigned to In Progress
It bothered me to find a way to dynamically create links to e.g. the CIDOC documentation. I ended up using the Sphinx extlinks extension.
For that I activated the extension in config.py and defined cidoc_entity links:
extensions: List[str] = ['sphinx.ext.extlinks']
extlinks = {
'cidoc_entity': ('https://www.cidoc-crm.org/Entity/%s/version-7.1.1', '')}
Now it can be used in templates like this (I added an example at entity/source.rst):
CIDOC documentation: :cidoc_entity:`e33-linguistic-object`
Code is already in the develop branch but not online.
Updated by Alexander Watzinger over 2 years ago
The implementation for CIDOC links with extlinks is just one suggestion.
Even better would be a function like e.g.
cidoc_entity_link(label, url_part)
which, when called like
cidoc_entity_link('E33 Linguistic Object', 'e33-linguistic-object')
would create the link https://www.cidoc-crm.org/Entity/e33-linguistic-object/version-7.1.1 with E33 Linguistic Object as label
Updated by Alexander Watzinger over 2 years ago
- Target version changed from 7.4.0 to 7.5.0
Updated by Alexander Watzinger over 2 years ago
- Subject changed from Add CIDOC links to manual to Manual: add CIDOC links for entity classes
Updated by Nina Richards over 2 years ago
- Status changed from In Progress to Closed
I added the links to the manual and they will be public with the next release.
Updated by Alexander Watzinger over 2 years ago
- Category changed from UI to Documentation