diff --git a/conf.py b/conf.py index 2a2fca5..35b714b 100644 --- a/conf.py +++ b/conf.py @@ -5,8 +5,8 @@ settings_project_name = "Catalogo Nazionale Dati per l'Interoperabilità Semantica" settings_copyright_copyleft = "Dipartimento per la Trasformazione Digitale" settings_editor_name = "Dipartimento per la Trasformazione Digitale" -settings_doc_version = "Bozza" -settings_doc_release = "Bozza" +settings_doc_version = "" +settings_doc_release = "" settings_basename = "dati-semantic-guida-sviluppo" settings_file_name = "dati-semantic-guida-sviluppo" settings_discourse_url = "https://forum.italia.it/" diff --git "a/docs/come-contribuire/attivit\303\240-propedeutiche-alla-contribuzione-al-catalogo.rst" "b/docs/come-contribuire/attivit\303\240-propedeutiche-alla-contribuzione-al-catalogo.rst" index 8c19401..f6981c4 100644 --- "a/docs/come-contribuire/attivit\303\240-propedeutiche-alla-contribuzione-al-catalogo.rst" +++ "b/docs/come-contribuire/attivit\303\240-propedeutiche-alla-contribuzione-al-catalogo.rst" @@ -60,7 +60,7 @@ Contributore sono: id44-->id45((END)) end -Figura 2 Diagramma delle attività propedeutiche alla contribuzione +Diagramma delle attività propedeutiche alla contribuzione Aggiunta di nuove risorse ------------------------- diff --git a/docs/come-utilizzare-le-risorse/ricerca-di-risorse-semantiche.rst b/docs/come-utilizzare-le-risorse/ricerca-di-risorse-semantiche.rst index 189a6f4..b125ada 100644 --- a/docs/come-utilizzare-le-risorse/ricerca-di-risorse-semantiche.rst +++ b/docs/come-utilizzare-le-risorse/ricerca-di-risorse-semantiche.rst @@ -7,11 +7,11 @@ selezionando sulle diverse categorie o tipologie degli asset semantici, come illustrato nella figura sottostante. .. figure:: ../../media/image3.png - :alt: Figura 3 Homepage di schema.gov.it – Ricerca asset semantici + :alt: Homepage di schema.gov.it – Ricerca asset semantici :width: 5.71198in :height: 2.89375in -Figura 3 Homepage di schema.gov.it – Ricerca asset semantici + Homepage di schema.gov.it – Ricerca asset semantici La ricerca tramite textbox permette agli utenti del Catalogo una rapida individuazione delle risorse desiderate, fornendo in input le **parole @@ -21,12 +21,11 @@ termini contenuti nella descrizione, titolare e concetti principali della risorsa. .. figure:: ../../media/image4.png - :alt: Figura 4 Homepage di schema.gov.it – Ricerca asset semantici (Esplora il catalogo) + :alt: Homepage di schema.gov.it – Ricerca asset semantici (Esplora il catalogo) :width: 6.13542in :height: 2.1057in -Figura 4 Homepage di schema.gov.it – Ricerca asset semantici (Esplora -il catalogo) + Homepage di schema.gov.it – Ricerca asset semantici (Esplora il catalogo) In aggiunta alla precedente modalità di ricerca, è possibile cliccare su 'Esplora il catalogo' e di conseguenza accedere ad una pagina di @@ -34,12 +33,11 @@ ricerca avanzata che ne estende le funzionalità di filtraggio delle risorse. .. figure:: ../../media/image5.png - :alt: Figura 5 Catalogo – Ricerca asset semantici a partire da 'Esplora il catalogo' + :alt: Catalogo – Ricerca asset semantici a partire da 'Esplora il catalogo' :width: 5.30208in :height: 3.90625in -Figura 5 Catalogo – Ricerca asset semantici a partire da 'Esplora il -catalogo' + Catalogo – Ricerca asset semantici a partire da 'Esplora il catalogo' In particolare, è possibile filtrare le risorse per: diff --git a/docs/come-utilizzare-le-risorse/scheda-della-risorsa-semantica.rst b/docs/come-utilizzare-le-risorse/scheda-della-risorsa-semantica.rst index 3fa5299..e90f916 100644 --- a/docs/come-utilizzare-le-risorse/scheda-della-risorsa-semantica.rst +++ b/docs/come-utilizzare-le-risorse/scheda-della-risorsa-semantica.rst @@ -9,11 +9,9 @@ titolo, la descrizione, e mostra due tasti che permettono di accedere alle due funzionalità 'SPARQL' e 'Vai al sorgente'. .. figure:: ../../media/image6.png - :alt: Figura 6 Esempio schermata della scheda di un'ontologia - :width: 5.46087in - :height: 2.74051in + :alt: Esempio schermata della scheda di un'ontologia -Figura 6 Esempio schermata della scheda di un'ontologia + Esempio schermata della scheda di un'ontologia In particolare: @@ -22,10 +20,9 @@ In particolare: del Catalogo. .. figure:: ../../media/image7.png - :alt: Figura 7 Interfaccia per l'esecuzione di interrogazioni mediante SPARQL Query Editor + :alt: Interfaccia per l'esecuzione di interrogazioni mediante SPARQL Query Editor - Figura 7 Interfaccia per l'esecuzione di interrogazioni mediante SPARQL - Query Editor + Interfaccia per l'esecuzione di interrogazioni mediante SPARQL Query Editor - Il tasto 'Vai al sorgente' permette di accedere al repository sorgente della risorsa semantica, dove eventualmente l'utente può @@ -41,11 +38,11 @@ quali la versione corrente, gli autori e altre modalità di visualizzazione. .. figure:: ../../media/image8.png - :alt: Figura 8 Esempio visualizzatore lode di un’ontologia + :alt: Esempio visualizzatore lode di un’ontologia :width: 5.12986in :height: 2.59097in -Figura 8 Esempio visualizzatore lode di un’ontologia + Esempio visualizzatore lode di un’ontologia Vocabolario controllato ----------------------- @@ -54,22 +51,22 @@ La scheda di dettaglio dei vocabolari controllati contiene pressoché gli stessi elementi descritti per le ontologie. .. figure:: ../../media/image9.png - :alt: Figura 9 Esempio schermata della scheda di un vocabolario controllato + :alt: Esempio schermata della scheda di un vocabolario controllato :width: 5.54792in :height: 2.79792in -Figura 9 Esempio schermata della scheda di un vocabolario controllato + Esempio schermata della scheda di un vocabolario controllato Per i vocabolari controllati è presente un tasto aggiuntivo, 'API', che permette di accedere alla Swagger UI e quindi fruire del vocabolario controllato tramite un’apposita API. .. figure:: ../../media/image10.png - :alt: Figura 10 Interfaccia Swagger UI per vocabolario controllato + :alt: Interfaccia Swagger UI per vocabolario controllato :width: 5.29792in :height: 2.67847in -Figura 10 Interfaccia Swagger UI per vocabolario controllato + Interfaccia Swagger UI per vocabolario controllato Anche in questo caso, è presente una tabella che contiene i dettagli della risorsa semantica, con un importante differenza: il campo 'URI' @@ -79,11 +76,11 @@ Web - dove l'utente ha la possibilità di esaminare varie caratteristiche del vocabolario controllato correlate al linguaggio RDF. .. figure:: ../../media/image11.png - :alt: Figura 11 Esempio visualizzatore lodview di un vocabolario controllato + :alt: Esempio visualizzatore lodview di un vocabolario controllato :width: 5.63478in :height: 2.85652in -Figura 11 Esempio visualizzatore lodview di un vocabolario controllato + Esempio visualizzatore lodview di un vocabolario controllato Schema ------ @@ -99,11 +96,11 @@ mediante la visualizzazione estesa dei vari campi della sezione 'schemas'. .. figure:: ../../media/image12.png - :alt: Figura 12 Esempio di tabella contenuta in una scheda per gli schemi dati + :alt: Esempio di tabella contenuta in una scheda per gli schemi dati :width: 4.85714in :height: 5.03576in -Figura 12 Esempio di tabella contenuta in una scheda per gli schemi dati + Esempio di tabella contenuta in una scheda per gli schemi dati Richiesta di aggiornamento di asset semantici esistenti ------------------------------------------------------- diff --git a/docs/funzionamento-generale.rst b/docs/funzionamento-generale.rst index b1a901e..10c5116 100644 --- a/docs/funzionamento-generale.rst +++ b/docs/funzionamento-generale.rst @@ -6,13 +6,6 @@ funzionamento generale del Catalogo. Al fine di offrire una panoramica più chiara, la sequenza di utilizzo del Catalogo è sintetizzata nella figura seguente: -.. figure:: ../media/image1.png - :alt: Figura 1 Flusso di utilizzo del Catalogo - :width: 5.35086in - :height: 2.96875in - - Figura 1 Flusso di utilizzo del Catalogo - .. toctree:: :maxdepth: 3 :caption: Indice dei contenuti diff --git a/docs/funzionamento-generale/attori.rst b/docs/funzionamento-generale/attori.rst index 77cc26b..a157982 100644 --- a/docs/funzionamento-generale/attori.rst +++ b/docs/funzionamento-generale/attori.rst @@ -1,6 +1,13 @@ Attori ====== +.. figure:: ../../media/image1.png + :alt: Schema di interazione da parte dei diversi attori + :width: 5.35086in + :height: 2.96875in + + Schema di interazione da parte dei diversi attori + Gli attori coinvolti sono i seguenti: - **Contributori**: soggetti di cui all’art. 2, comma 2, CAD che diff --git a/docs/manuale-operativo/identificativi-univoci-delle-risorse.rst b/docs/manuale-operativo/identificativi-univoci-delle-risorse.rst index c62629e..2647498 100644 --- a/docs/manuale-operativo/identificativi-univoci-delle-risorse.rst +++ b/docs/manuale-operativo/identificativi-univoci-delle-risorse.rst @@ -488,11 +488,11 @@ Di seguito viene fornito un esempio di utilizzo di cURL per verificare la correttezza dei redirect nel caso di una ontologia. .. figure:: ../../media/image13.png - :alt: Figura 13 Prompt dei comandi- cURL per verifica redirect + :alt: Prompt dei comandi- cURL per verifica redirect :width: 6.5in :height: 1.22431in - Figura 13 Prompt dei comandi- cURL per verifica redirect + Prompt dei comandi- cURL per verifica redirect Nel caso d’esempio, l’URI fornito è il seguente: https://w3id.org/italia/work-accident/onto/core/, mentre il contenuto diff --git a/docs/pillole-di-semantica-dei-dati/i-pilastri-della-semantica-dei-dati.rst b/docs/pillole-di-semantica-dei-dati/i-pilastri-della-semantica-dei-dati.rst index 435c884..087129d 100644 --- a/docs/pillole-di-semantica-dei-dati/i-pilastri-della-semantica-dei-dati.rst +++ b/docs/pillole-di-semantica-dei-dati/i-pilastri-della-semantica-dei-dati.rst @@ -63,11 +63,11 @@ creando così i presupposti per collegare i dati a formare un grafo interconnesso di conoscenza (figura 14). .. figure:: ../../media/image14.png - :alt: Figura 14: Esempio di grafo interconnesso di conoscenza + :alt: Esempio di grafo interconnesso di conoscenza :width: 6.10417in :height: 2.27083in - Figura 14: Esempio di grafo interconnesso di conoscenza + Esempio di grafo interconnesso di conoscenza Lo standard RDF, pertanto, offre un modello di rappresentazione di dati semanticamente arricchiti e collegati nel Web e può essere serializzato @@ -349,11 +349,11 @@ La figura 15 mostra il grado di profondità semantico offerto dai vocabolari controllati, di diverso tipo, rispetto alle ontologie. .. figure:: ../../media/image15.png - :alt: Figura 15: Livelli di espressività semantica + :alt: Livelli di espressività semantica :width: 3.42708in :height: 2.70833in - Figura 15: Livelli di espressività semantica + Livelli di espressività semantica Dare la possibilità di interrogare i dati ----------------------------------------- diff --git a/media/image2.png b/media/image2.png deleted file mode 100644 index fbf01c3..0000000 Binary files a/media/image2.png and /dev/null differ diff --git a/preview_build/preview_configuration.py b/preview_build/preview_configuration.py index 44d26b1..834f8fb 100644 --- a/preview_build/preview_configuration.py +++ b/preview_build/preview_configuration.py @@ -31,3 +31,5 @@ # Add any paths that contain custom themes here, relative to this directory. html_theme_path = [docs_italia_theme.get_html_theme_path()] + +numfig = True