Trata-se de um modelo de repositório de recursos semânticos a recolher a partir do Catálogo Nacional de Dados para a interoperabilidade fornecido em https://schema.gov.it.
Para obter mais informações sobre o Catálogo, sobre os métodos de uso do portal schema.gov.it e sobre a contribuição para a nutrição dos mesmos, consulte o guia específico.
Esta secção descreve a estrutura geral em árvore de um repositório semântico.
Todos os recursos semânticos estão na pasta ativos, Cada tipo de recurso (por exemplo, ontologias, vocabulários controlados, esquemas, etc.) tem uma subpasta específica.
Para efeitos de legibilidade:
Todos os recursos semânticos a recolher/publicar estão em ativos/; Os arquivos fora deste diretório são ignorados pelo catálogo e podem ser usados para testar, desenvolver e validar ativos/conteúdos, como arquivos em ensaios/.
Neste repositório, arquivos adicionais que não devem ser processados pelo NDC estão no diretório outros/, para a qual não está definida uma árvore específica.
Neste diretório também é possível inserir arquivos que são publicados diretamente através deste repositório (por exemplo, serializações RDF adicionais, esquemas auxiliares, vocabulários específicos) que não precisam ser processados pelo NDC, mas que ainda podem ser referenciados por objetos indexados, como:
Para saber mais sobre o tema do layout do repositório, o conteúdo necessário, a versão dos recursos e para poder consultar alguns exemplos úteis, consulte o secção específica do Manual Operacional do Catálogo.
Esta secção descreve os procedimentos de controlo e teste automáticos, úteis para garantir a qualidade e integridade do conteúdo do repositório.
Os controlos implementados podem ser desativados se não forem aplicáveis ao seu caso de utilização. Por exemplo, se já implementou a sua própria solução para URIs estáveis, verificar a igualdade entre nomes de ficheiros e pastas e entre nomes de ficheiros e recursos em URIs não tem necessariamente de estar desatualizado, para que possam ser comentados.
Este repositório implementa controlos automáticos utilizando pré-compromisso. As especificações de verificação são definidas no ficheiro .pre-commit-config.yaml .
Pode efetuar estas verificações utilizando as Ações do GitHub. O ficheiro valid.yaml em .github/workflows activa automaticamente verificações pré-commit após cada pedido push ou pull (PR). Além disso, pode executá-las manualmente a qualquer momento.
Para activar controlos de pré-autorização noutro repositório, copie o ficheiro .pre-commit-config.yaml e o processo .github/fluxos de trabalho/validate.yaml .
O script test_urls.py no diretório de testes permite verificar os URLs relacionados ao GitHub nos arquivos do subdiretório de ativos.
Este teste também pode ser automatizado com o GitHub Actions. O processo test.yaml em .github/workflows dispara automaticamente os testes depois de cada pedido push ou pull. Além disso, pode executá-las manualmente a qualquer momento.
Para activar o teste de URL noutro repositório, copie o ficheiro /testes/teste_urls.py e o processo .github/fluxos de trabalho/test.yaml.