<div dir="auto"><div dir="auto">Nello stesso modo funziona Hugo, che come Sphinx e tanti altri, è uno static site generator</div><div dir="auto"><a href="https://themes.gohugo.io/hugo-theme-techdoc/" target="_blank" rel="noreferrer">https://themes.gohugo.io/hugo-theme-techdoc/</a></div><div dir="auto">Si crea una struttura di sottocartelle per suddividere argomenti, capitoli, sottocapitoli etc... il tutto scritto in markdown preferibilmente.</div><div dir="auto">Hugo crea il sito statico corrispondente al template scelto.</div><div dir="auto"><br></div><div dir="auto">MediaWiki però è molto comodo considerate tutte le estensioni esistenti che la comunità col tempo ha sviluppato.</div><div dir="auto">Trovo comodissimo lo strumento di ricerca, indispensabile se non si è molto ordinati nella creazione delle voci.</div><div dir="auto"><br></div><div dir="auto"><br></div><div dir="auto">Omar</div><div dir="auto"><br></div><div dir="auto"><br></div><div dir="auto"><blockquote style="font-family:sans-serif;margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br><br></blockquote><blockquote style="font-family:sans-serif;margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br></blockquote><blockquote style="font-family:sans-serif;margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br><br>On 2020-01-21 at 18:39:22 +0100, Marco Cavallini wrote:<br>> > [...]<br>> > Il tutto deve essere editabile da interfaccia web e consultabile da<br>> > browser, meglio se OpenSource.<br>> > [...]<br>> Il kernel linux usa Sphinx<br>> <a href="http://www.sphinx-doc.org/en/master/" rel="noreferrer noreferrer noreferrer" target="_blank">http://www.sphinx-doc.org/en/master/</a><br>> <br>> Una comoda alternativa è ReadTheDocs<br>> <a href="https://readthedocs.org/" rel="noreferrer noreferrer noreferrer" target="_blank">https://readthedocs.org/</a><br><br>che poi sono circa la stessa cosa, o sbaglio? readthedocs non è<br>semplicemente una piattaforma per pubblicare documenti realizzati con<br>sphinx?<br><br>È una soluzione che uso anche io, ma credo che manchi l'interfaccia web<br>per la modifica, a meno che esistano tool che non conosco (e nel caso<br>quali sono?)<br><br>Come alternativa, anche questa che uso, file reStructuredText (lo stesso<br>formato di sphinx) dentro ad un repository su un gitlab selfhostato.<br><br>Ha lo svantaggio di richiedere un gitlab, che è un discreto malloppone<br>(da noi è già presente per altri motivi), ma a quel punto è comodo da<br>usare sia per chi preferisce scrivere nell'interfaccia web che per chi<br>preferisce usare il suo editor, offre la visualizzazione via web<br>(rendering automatico dei file reST), ma anche un modo comodo per avere<br>una copia locale di tutto quanto.<br><br>Ci sono un po' di ticket aperti per chiedere a gitlab di supportare<br>alcuni dei costrutti di sphinx, in modo da permettere l'unione delle due<br>cose (file in gitlab, editabili online, con preview veloce sul<br>repository e pubblicazione nei vari formati (html, pdf, epub) tramite<br>sphinx), che sarebbe una soluzione ideale, ma ancora non funziona<br>completamente.<br><br><a href="https://gitlab.com/gitlab-org/gitlab/issues/36219" rel="noreferrer noreferrer noreferrer" target="_blank">https://gitlab.com/gitlab-org/gitlab/issues/36219</a><br><br><a href="https://gitlab.com/gitlab-org/gitlab/issues/26687" rel="noreferrer noreferrer noreferrer" target="_blank">https://gitlab.com/gitlab-org/gitlab/issues/26687</a><br></blockquote></div></div>