Il s’agit d’un référentiel de modèles pour les ressources sémantiques à collecter à partir du catalogue national de données pour l’interopérabilité fourni le https://schema.gov.it.
Pour plus d'informations sur le catalogue, sur les méthodes d'utilisation du portail schema.gov.it et sur la contribution à la nutrition de celui-ci, se référer à la guide dédié.
Cette section décrit la structure arborescente générale d'un dépôt sémantique.
Toutes les ressources sémantiques sont dans le dossier actifs, Chaque type de ressource (par exemple ontologies, vocabulaires contrôlés, schémas, ..) a un sous-dossier spécifique.
Pour plus de lisibilité:
Toutes les ressources sémantiques à collecter/publier sont en actifs/; Les fichiers en dehors de ce répertoire sont ignorés par le catalogue et peuvent être utilisés pour tester, développer et valider des ressources/contenus, tels que des fichiers dans essais/.
Dans ce dépôt, les fichiers supplémentaires qui ne doivent pas être traités par le NDC se trouvent dans le répertoire autres/, pour lequel un arbre spécifique n’est pas défini.
Dans ce répertoire, vous pouvez également insérer des fichiers qui sont publiés directement via ce référentiel (par exemple, des sérialisations RDF supplémentaires, des schémas auxiliaires, des vocabulaires spécifiques) qui ne doivent pas être traités par le NDC mais qui peuvent toujours être référencés par des objets indexés tels que:
Pour en savoir plus sur le thème de la mise en page du référentiel, le contenu requis, le versionnement des ressources, et pour pouvoir consulter quelques exemples utiles, référez-vous au section dédiée dans le manuel opérationnel du catalogue.
Cette section décrit les procédures de contrôle et de test automatiques, utiles pour assurer la qualité et l'intégrité du contenu du référentiel.
Les contrôles mis en œuvre peuvent être désactivés s'ils ne s'appliquent pas à votre cas d'utilisation. Par exemple, si vous avez déjà implémenté votre propre solution pour les URI stables, vérifier l'égalité entre les noms de fichiers et les dossiers et entre les noms de fichiers et les ressources dans les URI ne doit pas nécessairement être obsolète, afin qu'ils puissent être commentés.
Ce référentiel implémente des contrôles automatiques en utilisant pré-engagement. Les spécifications de vérification sont définies dans le fichier .pre-commit-config.yaml .
Vous pouvez effectuer ces vérifications à l'aide des actions GitHub. Le fichier validate.yaml dans .github/workflows permet automatiquement des vérifications de pré-engagement après chaque push ou pull request (PR). En outre, vous pouvez les exécuter manuellement à tout moment.
Pour activer les contrôles de pré-engagement dans un autre dépôt, copiez le fichier .pre-commit-config.yaml et le dossier .github/workflows/validate.yaml .
Le script test_urls.py dans le répertoire tests vous permet de vérifier les URL liées à GitHub dans les fichiers du sous-répertoire de ressources.
Ce test peut également être automatisé à l'aide de GitHub Actions. Le dossier test.yaml dans .github/workflows déclenche automatiquement les tests après chaque requête push ou pull. En outre, vous pouvez les exécuter manuellement à tout moment.
Pour activer le test d'URL dans un autre référentiel, copiez le fichier /tests/test_urls.py et le dossier .github/workflows/test.yaml.