note

_quarto.yml

@@ -4,6 +4,7 @@ project:
     - "lg.csl"
     - "rawdata/LG-Open-Data_v.1.0.docx"
   render:
+    - "ndr.qmd"
     - "!note.md"
     - "!debug/*"
 language:
@@ -41,6 +42,9 @@ book:
         - capitolo-5.qmd
         - capitolo-6.qmd
         - capitolo-7.qmd
+    - part: "Note"
+      chapters:
+        - ndr.qmd
     # - part: "Test"
     #   chapters:
     #     - debug/raw-html-cr.qmd
@@ -60,7 +64,7 @@ book:
   repo-actions: [edit, issue]
 
   page-footer:
-    border: false
+    border: true
     background: light
     left: |
       A cura dell'[associazione onData](https://ondata.it).
@@ -72,6 +76,7 @@ book:
 format:
   html:
     lang: "it-IT"
+    toc-depth: 4
     theme:
       - cosmo
       - styles.scss

capitolo-4.qmd

@@ -2,7 +2,7 @@
 
 L'[art. 6](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art6) del Decreto stabilisce che pubbliche amministrazioni, organismi di diritto pubblico, imprese pubbliche e private, che rientrano tra i soggetti destinatari di cui al **[par. -@sec-soggetti-destinatari]** rendano disponibili per il riutilizzo i propri dati, e relativi metadati, nel rispetto delle regole tecniche definite con le presenti Linee Guida.
 
-Questo capitolo definisce le modalità e i formati per i dati da rendere disponibili come dati di tipo aperto e, in particolare, per le specifiche categorie di dati individuate da Direttiva e Decreto, ovvero dati dinamici, dati della ricerca e serie di dati di elevato valore (di cui, rispettivamente, agli [artt. 6](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art6), commi 5, 6, [9-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art9bis) e [12-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art12bis) del Decreto).
+Questo capitolo definisce le modalità e i formati per i dati da rendere disponibili come dati di tipo aperto e, in particolare, per le specifiche categorie di dati individuate da Direttiva e Decreto, ovvero dati dinamici, dati della ricerca e serie di dati di elevato valore (di cui, rispettivamente, agli artt. [6](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art6), commi 5, 6, [9-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art9bis) e [12-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art12bis) del Decreto).
 
 ## Requisiti comuni {#sec-requisiti-comuni}
 

index.qmd

@@ -11,6 +11,8 @@ Nell'estate del 2023 l'Agenzia per l'Italia Digitale (AgID) ha annunciato la pub
 
 > Hanno l'obiettivo di **supportare** le **pubbliche amministrazioni** e gli altri soggetti interessati al processo di **apertura** dei **dati** e di **riutilizzo** dell'**informazione del settore pubblico**, attraverso **indicazioni** volte ad implementare le **disposizioni** e le **modalità** disciplinate dalle norme indicate.
 
-💡 Il documento è pubblicato - ad oggi 17 agosto 2024 - [**soltanto come PDF**](https://www.agid.gov.it/sites/agid/files/2024-05/lg-open-data_v.1.0_1.pdf): per **diffonderlo** e **condividerlo**, in modo più **ampio** ed **efficace**, ne abbiamo creato [una **versione HTML**](prefazione.qmd), **consultabile** e **condivisibile** da **qualsiasi terminale**.
+Il documento è pubblicato - ad oggi 17 agosto 2024 - [**soltanto come PDF**](https://www.agid.gov.it/sites/agid/files/2024-05/lg-open-data_v.1.0_1.pdf).
 
-[👉 Leggile](prefazione.qmd){.btn-action-primary .btn-action .btn .btn-success .btn-lg}
+💡 Allora ne abbiamo creato [una **versione HTML**](prefazione.qmd), **consultabile** e **condivisibile** da **qualsiasi terminale**, per **diffonderle** e **condividerle**, in modo più **ampio** ed **efficace**.
+
+[👉 Leggile](prefazione.qmd){.btn-action-primary .btn-action .btn .btn-primary .btn-lg} [ℹ️ Note](ndr.qmd){.btn-action-primary .btn-action .btn .btn-secondary .btn-lg}

ndr.qmd

@@ -0,0 +1,59 @@
+# Note di redazione {.unnumbered}
+
+Queste note sono a cura dell'associazione onData, non sono parte delle linee guida e non sono vincolanti.
+
+## Introduzione {.unnumbered}
+
+Per noi dell'assocazione onData **tutti i documenti pubblici di riferimento** - come queste [linee guida](prefazione.qmd) - dovrebbero essere **resi disponibili** in lettura anche su [**Docs Italia**](https://docs.italia.it/).
+
+Per tante ragioni:
+
+- consente un processo di pubblicazione e di modifica di tipo **collaborativo**, in cui tutti possono proporre contributi e suggerimenti ai documenti;
+- è un **luogo unico** che offre una visione di insieme sui progetti pubblici in corso;
+- i documenti cambiano e si arricchiscono nel tempo ed è possibile vederne l'**evoluzione**;
+- i documenti di Docs Italia hanno un indice ben strutturato, un motore di ricerca efficace e sono di facile lettura, anche sullo smartphone.
+
+**Scegliendo** come unica modalità di pubblicazione il file **PDF**, **tutto questo non è possibile**.
+
+Con un PDF è molto **scomodo** fare anche il **passaparola** e **inviare** in chat, in un'e-mail, in una condisivione su un social network, ecc. il **link** a uno dei requisiti delle linee guida. Senza impazzire a sfogliare 150 pagine di PDF o fare una ricerca di testo in questo, magari in un terminale mobile scomodo (per un PDF).
+
+Mentre con questa versione HTML, si prende ad esempio il link al [requisito 2](capitolo-4.qmd#req-2){.testo-rosso} e si scrive in chat:
+
+> Guarda che bello, il requisito 2 delle linee guida open data dice che i dati devono essere pubblicati in formato CSV, non quell'orrendo di PDF <https://ondata.github.io/linee-guida-opendata/capitolo-4.html#req-2>
+
+E chi lo riceve visualizzerà subito il requisito 2 nel suo contesto, come in @fig-link-req, e potrà approfondire la lettura.
+
+:::{.column-page-inset-right}
+![Esempio di pagina aperta sul requisito 2](./immagini/link_requisito.png){#fig-link-req fig-alt="Esempio di pagina aperta sul requisito 2" align="center"}
+:::
+
+Un altro elemento che ci ha spinto a creare questa **versione alternativa a quella ufficiale** è una cosa **vecchia come il web**: la **navigazione ipertestuale**.<br>
+Queste linee guida sono ricche di richiami a fonti esterne, come i *link* agli articoli del [Decreto Legislativo di riferimento](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36) per queste linee guida. E sarebbe **prezioso** avere il **_link_** ipertestuale agli **articoli citati**.<br>
+Questo (molto spesso) non avviene nel documento ufficiale e non è un aspetto che dipende dal formato PDF.<br>
+
+[È possibile inserire i *link* ai singoli articoli di un Decreto, grazie al prezioso [Normattiva](https://www.normattiva.it/staticPage/faq#19)]{.aside}
+Sotto un esempio dell'inizio del [capitolo 4](capitolo-4.qmd). Nella prima immagine il [documento ufficiale](https://www.agid.gov.it/sites/agid/files/2024-05/lg-open-data_v.1.0_1.pdf) in cui non c'è alcun *link* ipertestuale agli articoli citati, mentre nella seconda immagine (relativa a questo progetto) ci sono quelli per i citati articoli [6](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art6), [9-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art9bis) e [12-bis](https://www.normattiva.it/uri-res/N2Ls?urn:nir:stato:decreto.legislativo:2006-01-24;36~art12bis) del "Decreto Legislativo 24 gennaio 2006, n. 36".
+
+
+
+
+
+:::{.column-page-inset-right}
+::: {#fig-ipertesto layout-ncol=2}
+
+![Linee guida ufficiali](immagini/doc_hyperlink.png){#fig-doc_hyperlink .lightbox group="my-gallery"}
+
+![Questa versione](immagini/ondata_hyperlink.png){#fig-ondata_hyperlink .lightbox group="my-gallery"}
+
+l'inizio del capitolo 4
+:::
+:::
+
+## Come abbiamo lavorato {.unnumbered}
+
+Abbiamo iniziato provando a trasformare il documento PDF ufficiale in un formato testuale, adatto poi a essere trasformato in `HTML`. Ma per la "ricchezza" in termini di struttura e contenuti, non riuscivamo a ottenere un risultato soddisfacente.
+
+Abbiamo allora **chiesto** ad **AgID** di inviarci il **documento** nel **formato** in cui **nativamente** è stato **redatto** (il PDF è infatti qui un formato di esportazione).<br>Ci hanno allora inviato il file [`LG-Open-Data_v.1.0.docx`](rawdata/LG-Open-Data_v.1.0.docx), ovvero il documento in formato Microsoft Word.
+
+Lo abbiamo **convertito** in un **formato testuale** più adatto a essere trasformato in `HTML`, ovvero in [Markdown](https://omni.wikiwand.com/en/articles/Markdown) (`.md`), utilizzando [Pandoc](https://pandoc.org/).<br>
+A partire da questo formato, abbiamo creato un [**progetto Quarto**](https://quarto.org/) e lo abbiamo esportato in `HTML`.