Merge pull request #3 from datosgobes/develop

Añadidos ejemplos para migración a DCAT-AP-ES y mejora descripcion/SHACL `dct:accrualPeriodicity`

Author: mjanez

docs/examples.md

@@ -103,3 +103,31 @@ La distribución `http://datos.gob.es/catalogo/2332/SHP` proporciona el acceso a
     ```turtle linenums="1"
     --8<-- "examples/ttl/NTI-RISP_Distribution.ttl"
     ```
+
+# Ejemplo de migración: [Catálogo NTI-RISP a DCAT-AP-ES](/catalogo_-_nti_dcatapes)
+Este ejemplo muestra cómo un catálogo modelado originalmente según NTI-RISP (2013) puede adaptarse al perfil [DCAT-AP-ES](https://datosgobes.github.io/DCAT-AP-ES). Sirve como plantilla para la transición porque mantiene la estructura básica del catálogo NTI-RISP y la enriquece con metadatos interoperables a nivel europeo, facilitando la integración en portales nacionales y europeos.
+
+El catálogo `http://dcat-ap-es.ejemplo.org/catalogo` incluye información esencial como título, descripción, publicador, fechas clave, página web, temáticas, idiomas, términos de uso y referencia a datasets. Además, incorpora elementos recomendados por DCAT-AP-ES, como la cobertura geográfica y la alineación con vocabularios europeos, lo que permite una migración progresiva y compatible.
+
+Este ejemplo es útil como plantilla porque:
+- Muestra cómo mapear propiedades NTI-RISP a DCAT-AP-ES sin perder información relevante.
+- Permite enriquecer el catálogo con nuevos metadatos exigidos por DCAT-AP-ES.
+- Facilita la interoperabilidad y el cumplimiento de estándares europeos.
+- Es fácilmente adaptable a otros catálogos NTI-RISP existentes.
+
+!!! tip "Ejemplos disponibles"
+
+    Puedes consultar versiones de ejemplo migradas al perfil DCAT-AP-ES en los siguientes enlaces:
+
+    - [Catálogo NTI-RISP a DCAT-AP-ES](https://datosgobes.github.io/DCAT-AP-ES/examples/#catalogo_-_nti_dcatapes)
+    - [Catálogo NTI-RISP a DCAT-AP-ES HVD](https://datosgobes.github.io/DCAT-AP-ES/examples/#catalogo_-_nti_dcatapes_hvd)
+
+=== "RDF/XML"
+    ```xml linenums="1"
+    --8<-- "examples/rdf/E_NTI-RISP_Catalog.rdf"
+    ```
+
+=== "TTL"
+    ```turtle linenums="1"
+    --8<-- "examples/ttl/E_NTI-RISP_Catalog.ttl"
+    ```

docs/index.md

@@ -214,7 +214,7 @@ Cada conjunto de recursos de información presente en el catálogo se describir
 | Identificador | URI que identifica al documento o recurso de información. | dct:identifier | R | 0..1 | **xsd:anyURI**<br>*URI que identifica la ficha descriptiva del documento o recurso de información.* |
 | Fecha de creación | Fecha de creación del documento o recurso de información. | dct:issued | R | 0..1 | **rdfs:Literal**<br>*Fecha/Hora con formato ISO-8601: `YYYY-MM-DDThh:mm:ssTZD`.* |
 | Fecha de última actualización | Última fecha conocida en la que se modificó o actualizó el contenido del documento o recurso de información. | dct:modified | R | 0..1 | **rdfs:Literal**<br>*Fecha/Hora con formato ISO-8601: `YYYY-MM-DDThh:mm:ssTZD`.* |
-| Frecuencia de actualización | Periodo de tiempo aproximado entre actualizaciones del documento o recurso de información, si hubiera. | dct:accrualPeriodicity | R | 0..1 | **dct:Frequency**<br>*Se recomienda especificar periodos normalizados con formato ISO8601 (`P<date>T<time>`), o similar.* |
+| Frecuencia de actualización | Periodo de tiempo aproximado entre actualizaciones del documento o recurso de información, si hubiera. | dct:accrualPeriodicity | R | 0..1 | **dct:Frequency**<br>*Se recomienda describir la frecuencia mediante un recurso de tipo `dct:Frequency`, siguiendo el modelo de datos RDF. Si se desea indicar el periodo en formato ISO8601, debe especificarse en el valor de `rdf:value` dentro del nodo `dct:Frequency`. Ver [ejemplos](/examples/#__codelineno-2-14). |
 | Idioma(s) | Idioma(s) en el(los) que se encuentra la información del documento o recurso de información. | dc:language | R | 0..n | **dct:LinguisticSystem**<br>*Valores normalizados de etiquetas para identificar idiomas definidos en el RFC 5646 `es`, `ga`, `ca`, `eu`, `en`, `fr`<br>Se usará una etiqueta por propiedad.* |
 | Organismo que expone y publica los datos | Organismo que publica el documento o recurso de información. | dct:publisher | Ob | 1..1 | **foaf:Agent**<br>*Se especificará el URI correspondiente a un organismo público diferenciados por un código alfanumérico único para cada órgano/unidad/oficina, que será extraído del Directorio Común gestionado por el MINHAP según el esquema siguiente: `http://datos.gob.es/recurso/sector-publico/org/Organismo/{ID}`* |
 | Condiciones de uso | Recurso que describe las condiciones de uso o licencia específica aplicable al propio documento o recurso de información. | dct:license | R | 0..1 | **dct:LicenseDocument**<br>*Se especificará un URI que referencia al recurso que define las condiciones de uso. Si no es una licencia-tipo, y si fuese necesario, en la descripción se podría indicar contraprestación económica utilizando valores del código de divisa normalizado por el estándar [ISO-4217](https://www.iso.org/iso-4217-currency-codes.html) (`EUR`, `USD`, `GBP`, etc.).* |
@@ -236,11 +236,11 @@ A continuación se muestra una tabla con valores de ejemplo que podrían tomar l
 | Identificador | `http://datos.gob.es/catalogo/2332` | |
 | Fecha de creación | `2012-12-26` | |
 | Fecha de última actualización | `2012-12-26` | |
-| Frecuencia de actualización | `P0Y3M0DT0H0M0S` |(Trimestral |
+| Frecuencia de actualización | `P0Y3M0DT0H0M0S` |Trimestral |
 | Idioma(s) | `es` `ga` `ca` `en` | Castellano, gallego, catalán e inglés |
 | Organismo que expone y publica los datos | `http://datos.gob.es/recurso/sector-publico/org/Organismo/E00004401` | URI correspondiente al Ministerio de Hacienda y Administraciones Públicas |
 | Condiciones de uso | `http://www.minhap.gob.es/Documentacion/Publico/NormativaDoctrina/Catastro/Acceso%20a%20la%20informacion%20catastral/res_230311.pdf` | |
-| Cobertura geográfica | `http://datos.gob.es/recurso/sector-publico/territorio/Pais/España` |(toda España |
+| Cobertura geográfica | `http://datos.gob.es/recurso/sector-publico/territorio/Pais/España` |toda España |
 | Cobertura temporal | `2012-12-26` `2013-03-26` | Del *2012-12-26* al *2013-03-26*
 | Vigencia del recurso | `2013-03-26` | Válido hasta el *2013-03-26* |
 | Recurso(s) relacionado(s) | `http://www1.sedecatastro.gob.es` | Sede Electrónica del Catastro |

examples/rdf/E_NTI-RISP_Catalog.rdf

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+         xmlns:dcat="http://www.w3.org/ns/dcat#"
+         xmlns:dct="http://purl.org/dc/terms/"
+         xmlns:foaf="http://xmlns.com/foaf/0.1/"
+         xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
+		 xmlns:dc="http://purl.org/dc/elements/1.1/"
+		 xmlns:time="http://www.w3.org/2006/time#">
+
+  <dcat:Catalog rdf:about="http://dcat-ap-es.ejemplo.org/catalogo">
+    <dct:title xml:lang="es">Catálogo de Datos Abiertos</dct:title>
+    <dct:title xml:lang="en">Open Data Catalog</dct:title>
+    <dct:description xml:lang="es">Catálogo de Datos Abiertos que sirve de ejemplo en DCAT-AP-ES.</dct:description>
+    <dct:description xml:lang="en">Open Data Catalogue that serves as an example in DCAT-AP-ES.</dct:description>
+    <foaf:homepage rdf:resource="http://dcat-ap-es.ejemplo.org"/>
+    <dct:publisher rdf:resource="http://datos.gob.es/recurso/sector-publico/org/Organismo/E0DAT0001"/>
+    <dcat:themeTaxonomy rdf:resource="http://datos.gob.es/kos/sector-publico/sector"/>
+    <dcat:themeTaxonomy rdf:resource="http://publications.europa.eu/resource/authority/data-theme"/>
+    <dct:issued rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2025-01-01T09:00:00+01:00</dct:issued>
+    <dct:modified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2025-01-02T12:00:00+01:00</dct:modified>
+    <dc:language>es</dc:language>
+	<dc:language>en</dc:language>
+    <dct:spatial rdf:resource="http://datos.gob.es/recurso/sector-publico/territorio/Pais/España"/>
+	<dct:license rdf:resource="http://publications.europa.eu/resource/authority/licence/CC_BY_4_0"/>
+	
+    <dcat:dataset>
+      <dcat:Dataset rdf:about="http://dcat-ap-es.ejemplo.org/dataset/dataset-ejemplo-1">
+        <dct:identifier>http://dcat-ap-es.ejemplo.org/dataset/dataset-ejemplo-1</dct:identifier>
+		<dct:title xml:lang="es">Dataset de ejemplo</dct:title>
+        <dct:title xml:lang="en">Example Dataset</dct:title>
+        <dct:description xml:lang="es">Descripción de un dataset de ejemplo.</dct:description>
+        <dct:description xml:lang="en">Example dataset description.</dct:description>
+        <dct:publisher rdf:resource="http://datos.gob.es/recurso/sector-publico/org/Organismo/E0DAT0001"/>
+        <dcat:theme rdf:resource="http://datos.gob.es/kos/sector-publico/sector/medio-ambiente"/>
+        <dct:spatial rdf:resource="http://datos.gob.es/recurso/sector-publico/territorio/Pais/España"/>
+		<dcat:keyword xml:lang="es">estadísticas</dcat:keyword>
+		<dct:license rdf:resource="http://publications.europa.eu/resource/authority/licence/CC_BY_4_0" />
+		<dc:language>es</dc:language>
+		<dc:language>en</dc:language>
+        <dct:temporal>
+			<time:Interval>
+				<rdf:type rdf:resource="http://purl.org/dc/terms/PeriodOfTime" />
+				<time:hasBeginning>
+				  <time:Instant>
+					<time:inXSDDateTime rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2021-01-01T00:00:00</time:inXSDDateTime>
+				  </time:Instant>
+				</time:hasBeginning>
+			   <time:hasEnd>
+				 <time:Instant>
+					<time:inXSDDateTime rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">20255-01-01T00:00:00</time:inXSDDateTime>
+				  </time:Instant>
+				</time:hasEnd>
+			</time:Interval>
+		</dct:temporal>
+			 
+        <dcat:distribution>
+          <dcat:Distribution rdf:about="http://dcat-ap-es.ejemplo.org/distribucion/dataset-ejemplo-1-CSV">
+			  <dct:title xml:lang="es">Distribución de ejemplo</dct:title>
+			  <dct:title xml:lang="en">Example distribution</dct:title>
+			  <dct:description xml:lang="es">Descripción de un distribución de ejemplo.</dct:description>
+			  <dcat:accessURL rdf:resource="http://dcat-ap-es.ejemplo.org/files/dataset-ejemplo-1.CSV"/>
+			  <dct:format>
+                  <dct:IMT>
+                    <rdf:value>text/csv</rdf:value>
+                    <rdfs:label>CSV</rdfs:label>
+                  </dct:IMT>
+                </dct:format>
+          </dcat:Distribution>
+        </dcat:distribution>
+
+      </dcat:Dataset>
+    </dcat:dataset>
+
+  </dcat:Catalog>
+</rdf:RDF>

examples/ttl/E_NTI-RISP_Catalog.ttl

@@ -0,0 +1,57 @@
+@prefix dcat: <http://www.w3.org/ns/dcat#> .
+@prefix dct: <http://purl.org/dc/terms/> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix dc: <http://purl.org/dc/elements/1.1/> .
+@prefix time: <http://www.w3.org/2006/time#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://dcat-ap-es.ejemplo.org/catalogo>
+  a dcat:Catalog ;
+  dct:title "Catálogo de Datos Abiertos"@es, "Open Data Catalog"@en ;
+  dct:description "Catálogo de Datos Abiertos que sirve de ejemplo en DCAT-AP-ES."@es, "Open Data Catalogue that serves as an example in DCAT-AP-ES."@en ;
+  foaf:homepage <http://dcat-ap-es.ejemplo.org> ;
+  dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/E0DAT0001> ;
+  dcat:themeTaxonomy <http://datos.gob.es/kos/sector-publico/sector>, <http://publications.europa.eu/resource/authority/data-theme> ;
+  dct:issued "2025-01-01T09:00:00+01:00"^^xsd:dateTime ;
+  dct:modified "2025-01-02T12:00:00+01:00"^^xsd:dateTime ;
+  dc:language "es", "en" ;
+  dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Pais/España> ;
+  dct:license <http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ;
+  dcat:dataset <http://dcat-ap-es.ejemplo.org/dataset/dataset-ejemplo-1> .
+
+<http://dcat-ap-es.ejemplo.org/dataset/dataset-ejemplo-1>
+  a dcat:Dataset ;
+  dct:identifier "http://dcat-ap-es.ejemplo.org/dataset/dataset-ejemplo-1" ;
+  dct:title "Dataset de ejemplo"@es, "Example Dataset"@en ;
+  dct:description "Descripción de un dataset de ejemplo."@es, "Example dataset description."@en ;
+  dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/E0DAT0001> ;
+  dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> ;
+  dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Pais/España> ;
+  dcat:keyword "estadísticas"@es ;
+  dct:license <http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ;
+  dc:language "es", "en" ;
+  dct:temporal [
+    a time:Interval, dct:PeriodOfTime ;
+    time:hasBeginning [
+      a time:Instant ;
+      time:inXSDDateTime "2021-01-01T00:00:00"^^xsd:dateTime
+    ] ;
+    time:hasEnd [
+      a time:Instant ;
+      time:inXSDDateTime "20255-01-01T00:00:00"^^xsd:dateTime
+    ]
+  ] ;
+  dcat:distribution <http://dcat-ap-es.ejemplo.org/distribucion/dataset-ejemplo-1-CSV> .
+
+<http://dcat-ap-es.ejemplo.org/distribucion/dataset-ejemplo-1-CSV>
+  a dcat:Distribution ;
+  dct:title "Distribución de ejemplo"@es, "Example distribution"@en ;
+  dct:description "Descripción de un distribución de ejemplo."@es ;
+  dcat:accessURL <http://dcat-ap-es.ejemplo.org/files/dataset-ejemplo-1.CSV> ;
+  dct:format [
+    a dct:IMT ;
+    rdf:value "text/csv" ;
+    rdfs:label "CSV"
+  ] .

overrides/dcatapes/index_header.html

@@ -93,12 +93,12 @@
                     {{ config.dcatapes[lang].period.start.value }}
                   </span>
                 {% endif %}
-                {% if config.dcatapes[lang].period.start.value and config.dcatapes[lang].period.end.value %}
+                {% if config.dcatapes[lang].period.start.value and period_end_value %}
                   &nbsp;–&nbsp;
                 {% endif %}
-                {% if config.dcatapes[lang].period.end.value %}
-                  <span class="period-end tooltip" title="{{ config.dcatapes[lang].period.end.title }}">
-                    {{ config.dcatapes[lang].period.end.value }}
+                {% if period_end_value %}
+                  <span class="period-end tooltip" title="{{ period_end.title }}">
+                    {{ period_end_value }}
                   </span>
                 {% endif %}
               </dd>

shacl/1.0.0/nti-risp_common_shapes.ttl

@@ -117,14 +117,39 @@
 :Frequency_Shape
     a sh:NodeShape ;
     rdfs:comment "Validación para estructuras dct:Frequency usadas en dct:accrualPeriodicity"@es ;
-    sh:property [
-        sh:path rdf:value ;
-        sh:minCount 1 ;
-        sh:maxCount 1 ;
-        sh:nodeKind sh:BlankNodeOrIRI ;
-        sh:node :TimeDurationDescription_Shape ;
-        sh:message "dct:Frequency debe contener exactamente un rdf:value con una estructura time:DurationDescription válida"@es ;
-    ] ;
+    sh:or (
+        # Opción 1: Estructura time:DurationDescription
+        [
+            sh:property [
+                sh:path rdf:value ;
+                sh:minCount 1 ;
+                sh:maxCount 1 ;
+                sh:nodeKind sh:BlankNodeOrIRI ;
+                sh:node :TimeDurationDescription_Shape ;
+                sh:message "dct:Frequency debe contener exactamente un rdf:value con una estructura time:DurationDescription válida"@es ;
+            ]
+        ]
+        # Opción 2: rdf:value como literal xsd:duration o xsd:timePeriod y rdfs:label
+        [
+            sh:property [
+            sh:path rdf:value ;
+            sh:or (
+                [ sh:datatype xsd:duration ]
+                [ sh:datatype <http://www.w3.org/2001/XMLSchema#timePeriod> ]
+            ) ;
+            sh:pattern "^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+S)?)?$" ;
+            sh:minCount 1 ;
+            sh:maxCount 1 ;
+            sh:message "rdf:value debe ser un literal xsd:duration o xsd:timePeriod (ejemplo: P0Y3M0DT0H0M0S) y cumplir el patrón ISO-8601"@es ;
+            ] ;
+            sh:property [
+                sh:path rdfs:label ;
+                sh:minCount 1 ;
+                sh:nodeKind sh:Literal ;
+                sh:message "Debe incluir al menos un rdfs:label descriptivo"@es ;
+            ]
+        ]
+    ) ;
     sh:message "La estructura dct:Frequency no cumple con los requisitos"@es .
 
 :TimeDurationDescription_Shape

shacl/1.0.0/nti-risp_dataset_shape.ttl

@@ -140,20 +140,11 @@
     [
         sh:path dct:accrualPeriodicity ;
         sh:maxCount 1 ;
-        sh:or (
-            [
-                # Literal con formato ISO8601
-                sh:nodeKind sh:Literal ;
-                sh:pattern "^P([0-9]+Y)?([0-9]+M)?([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+S)?)?$" ;
-                sh:message "El valor debe ser un período ISO8601 válido, ejemplo: 'P0Y3M0DT0H0M0S' para trimestral"@es ;
-            ]
-            [
-                # Estructura compleja con dct:Frequency
-                sh:nodeKind sh:BlankNodeOrIRI ;
-                sh:class dct:Frequency ;
-                sh:node :Frequency_Shape ;
-            ]
-        ) ;
+
+        # Estructura compleja con dct:Frequency
+        sh:nodeKind sh:BlankNodeOrIRI ;
+        sh:class dct:Frequency ;
+        sh:node :Frequency_Shape ;
         sh:severity sh:Violation ;
     ],