Se trata de un repositorio de plantillas de recursos semánticos que deben recogerse del Catálogo Nacional de Datos para la interoperabilidad facilitado el https://schema.gov.it.
Para obtener más información sobre el Catálogo, sobre los métodos de uso del portal schema.gov.it y sobre la contribución a la nutrición del mismo, consulte el Guía específica.
Esta sección describe la estructura general del árbol de un repositorio semántico.
Todos los recursos semánticos están en la carpeta activos, Cada tipo de recurso (por ejemplo, ontologías, vocabularios controlados, esquemas, ..) tiene una subcarpeta específica.
Para mayor legibilidad:
Todos los recursos semánticos que deben recopilarse/publicarse están en activos/; Los archivos fuera de este directorio son ignorados por el catálogo y se pueden usar para probar, desarrollar y validar activos / contenido, como archivos en pruebas/.
En este repositorio, los archivos adicionales que no deben ser procesados por el NDC están en el directorio otros/, para el que no se define un árbol específico.
En este directorio también puede insertar archivos que se publican directamente a través de este repositorio (por ejemplo, serializaciones RDF adicionales, esquemas auxiliares, vocabularios específicos) que no tienen que ser procesados por el NDC, pero que aún pueden ser referenciados por objetos indexados como:
Para obtener más información sobre el tema del diseño del repositorio, el contenido requerido, el control de versiones de los recursos y para poder consultar algunos ejemplos útiles, consulte el sección específica en el Manual de Operaciones del Catálogo.
En esta sección se describen los procedimientos de control y pruebas automáticas, útiles para garantizar la calidad e integridad de los contenidos del repositorio.
Los controles implementados se pueden desactivar si no se aplican a su caso de uso. Por ejemplo, si ya ha implementado su propia solución para URI estables, verificar la igualdad entre nombres de archivos y carpetas y entre nombres de archivos y recursos en URI no necesariamente tiene que estar desactualizado, por lo que se pueden comentar.
Este repositorio implementa controles automáticos utilizando pre-compromiso. Las especificaciones de verificación se definen en el archivo .pre-commit-config.yaml .
Puede realizar estas comprobaciones utilizando las acciones de GitHub. El archivo valid.yaml en .github/workflows permite automáticamente realizar comprobaciones previas después de cada solicitud push o pull (PR). Además, puede ejecutarlos manualmente en cualquier momento.
Para habilitar controles previos a la comisión en otro repositorio, copie el archivo .pre-commit-config.yaml y el expediente .github/flujos de trabajo/validate.yaml .
El script test_urls.py en el directorio tests le permite comprobar las URL relacionadas con GitHub en los archivos del subdirectorio de activos.
Esta prueba también se puede automatizar usando GitHub Actions. El expediente test.yaml en .github/workflows activa automáticamente las pruebas después de cada solicitud de push o pull. Además, puede ejecutarlos manualmente en cualquier momento.
Para habilitar las pruebas de URL en otro repositorio, copie el archivo /tests/test_urls.py y el expediente .github/workflows/test.yaml.