Buonasera a tutti,
durante una serie di test sull’installazione di QGIS server + Lizmap Web Client, abbiamo notato che le istruzioni di installazione riportate sul manuale di Lizmap non sono del tutto corrette. Per ora abbiamo fatto una pull request per integrare la loro documentazione ma ci chiedevamo se non fosse in qualche modo possibile richiamare direttamente la documentazione di QGIS nel manuale Lizmap.
Ovviamente la cosa più semplice sarebbe mettere un link alla pagina specifica della documentazione di QGIS, ma ci chiedevamo se ci fosse un modo di integrare proprio un manuale dentro l’altro senza dover passare da una pagina web all’altra (per esempio utilizzando i submodule di git?).
In realtà oltre a questa pull request di un nostro collaboratore, quello che secondo me avrebbe senso fare sarebbe per esempio usare la guida di Qgis Server [1] dentro a quella di lizmap [2] per le parti che riguardano l’installazione di qgis server al fine di evitare doppioni di difficile manutenzione.
Per questo stavamo ragionando appunto sulla possibilità di “embeddare” la parte di manuale di QGIS su Lizmap, ma non sappiamo se sia tecnicamente possibile. Da alcuni test fatti su un nostro manuale riusciamo a fare qualcosa usando i submodule di git. Tuttavia questa soluzione si porta dietro alcuni problemi. Un esempio sono i problemi sulle immagini che in questo caso non servirebbero, ma che ci fanno temere di esserci persi dei pezzi.
La ragione della nostra domanda era proprio legata al fatto che i submodule non ci sembrano il massimo della soluzione.
Secondo me sarebbe strategico trovare un modo di integrare le documentazioni dei vari SW tra di loro perchè aiuterebbe a ottimizzare gli sforzi lato “developer” e fornirebbe un qualcosa di realmente usabile all’utente finale
Vediamo se qualcuno il lista ha mai tentato di fare qualcosa di simile… se no rimarrà un sogno nel cassetto
R
---- Attivato mer, 10 giu 2020 22:47:22 +0200 Paolo Cavallini cavallini@faunalia.it ha scritto ----
Mah, i submoduli di Git sono spaventevoli.
Concordo che questa duplicazione è sbagliata, ho già provato a dargli una pulita
In realtà oltre a questa pull request di un nostro collaboratore, quello che secondo me avrebbe senso fare sarebbe per esempio usare la guida di Qgis Server [1] dentro a quella di lizmap [2] per le parti che riguardano l’installazione di qgis server al fine di evitare doppioni di difficile manutenzione.
Per questo stavamo ragionando appunto sulla possibilità di “embeddare” la parte di manuale di QGIS su Lizmap, ma non sappiamo se sia tecnicamente possibile. Da alcuni test fatti su un nostro manuale riusciamo a fare qualcosa usando i submodule di git. Tuttavia questa soluzione si porta dietro alcuni problemi. Un esempio sono i problemi sulle immagini che in questo caso non servirebbero, ma che ci fanno temere di esserci persi dei pezzi.
durante una serie di test sull’installazione di QGIS server + Lizmap Web Client, abbiamo notato che le istruzioni di installazione riportate sul manuale di Lizmap non sono del tutto corrette. Per ora abbiamo fatto una pull request per integrare la loro documentazione ma ci chiedevamo se non fosse in qualche modo possibile richiamare direttamente la documentazione di QGIS nel manuale Lizmap.
Ovviamente la cosa più semplice sarebbe mettere un link alla pagina specifica della documentazione di QGIS, ma ci chiedevamo se ci fosse un modo di integrare proprio un manuale dentro l’altro senza dover passare da una pagina web all’altra (per esempio utilizzando i submodule di git?).
Ho poche esperienze con i git submodules (da cui mi tengo alla larga il
più possibile), ma un'alternativa esiste (non l'ho mai approfondita) i
git subtree.
però personalmente credo che sia molto facile incasinare con questi
strumenti di git qualcosa che dovrebbe rimanere semplice.