Hierbei handelt es sich um ein Template-Repository für semantische Ressourcen, die aus dem Nationalen Datenkatalog für die Interoperabilität zu sammeln sind. https://schema.gov.it.
Weitere Informationen über den Katalog, über die Verwendungsmethoden des schema.gov.it-Portals und über den Beitrag zur Ernährung derselben finden Sie im dedizierter Leitfaden.
Dieser Abschnitt beschreibt die allgemeine Baumstruktur eines semantischen Repositorys.
Alle semantischen Ressourcen befinden sich im Ordner Vermögen, Jeder Ressourcentyp (z.B. Ontologien, kontrollierte Vokabulare, Schemata, ..) hat einen bestimmten Unterordner.
Zur besseren Lesbarkeit:
Alle zu sammelnden/veröffentlichten semantischen Ressourcen sind in Vermögenswerten/; Dateien außerhalb dieses Verzeichnisses werden vom Katalog ignoriert und können zum Testen, Entwickeln und Validieren von Asset/Inhalten, wie Dateien in Prüfungen/.
In diesem Repository befinden sich zusätzliche Dateien, die nicht vom NDC verarbeitet werden sollen, im Verzeichnis Sonstiges/, für die kein bestimmter Baum definiert ist.
In diesem Verzeichnis können Sie auch Dateien einfügen, die direkt über dieses Repository veröffentlicht werden (z.B. zusätzliche RDF-Serialisierungen, Hilfsschemata, spezifische Vokabulare), die nicht vom NDC verarbeitet werden müssen, aber dennoch von indizierten Objekten referenziert werden können, wie z.B.:
Um mehr über das Thema des Repository-Layouts, den erforderlichen Inhalt, die Versionierung von Ressourcen und einige nützliche Beispiele zu erfahren, lesen Sie bitte die folgenden Links: spezieller Abschnitt im Betriebshandbuch des Katalogs.
Dieser Abschnitt beschreibt die Verfahren der automatischen Kontrolle und Prüfung, die nützlich sind, um die Qualität und Integrität des Inhalts des Repositorys zu gewährleisten.
Implementierte Steuerelemente können deaktiviert werden, wenn sie für Ihren Anwendungsfall nicht anwendbar sind. Wenn Sie beispielsweise bereits eine eigene Lösung für stabile URIs implementiert haben, muss die Überprüfung der Gleichheit zwischen Dateinamen und Ordnern sowie zwischen Dateinamen und Ressourcen in URIs nicht unbedingt veraltet sein, sodass sie kommentiert werden können.
Dieses Repository implementiert automatische Kontrollen mit vor der Mittelbindung. Prüfspezifikationen sind in der Datei definiert .pre-commit-config.yaml .
Sie können diese Prüfungen mit GitHub-Aktionen durchführen. Die Datei validate.yaml in .github/workflows ermöglicht automatisch Pre-Commit-Prüfungen nach jeder Push- oder Pull-Anforderung (PR). Darüber hinaus können Sie sie jederzeit manuell ausführen.
Um Pre-Commit-Steuerelemente in einem anderen Repository zu aktivieren, kopieren Sie die Datei .pre-commit-config.yaml und die Akte .github/workflows/validate.yaml .
Mit dem test_urls.py-Skript im Testverzeichnis können Sie die GitHub-bezogenen URLs in den Asset-Unterverzeichnisdateien überprüfen.
Dieser Test kann auch mit GitHub Actions automatisiert werden. Die Akte test.yaml in .github/workflows löst nach jeder Push- oder Pull-Anforderung automatisch Tests aus. Darüber hinaus können Sie sie jederzeit manuell ausführen.
Um URL-Tests in einem anderen Repository zu aktivieren, kopieren Sie die Datei /tests/test_urls.py und die Akte .github/workflows/test.yaml.