[bglug] Software Web per Documentazione Aziendale

[Steevie]

On Wed, 22 Jan 2020 at 11:51, Elena ``of Valhalla''
<valhalla-l@trueelena.org> wrote:
>
> On 2020-01-21 at 18:39:22 +0100, Marco Cavallini wrote:
> > > [...]
> > > Il tutto deve essere editabile da interfaccia web e consultabile da
> > > browser, meglio se OpenSource.
> > > [...]
> > Il kernel linux usa Sphinx
> > http://www.sphinx-doc.org/en/master/
> >
> > Una comoda alternativa è ReadTheDocs
> > https://readthedocs.org/
>
> che poi sono circa la stessa cosa, o sbaglio? readthedocs non è
> semplicemente una piattaforma per pubblicare documenti realizzati con
> sphinx?
A voler essere precisi, Sphinx è un markup language, RTD una
piattaforma (che uso anch'io) per compilare e pubblicare
automaticamente documentazione salvata su github/gtlab/bitbucket.
RTD permette di modificare il codice sorgente "via Web" rimandando
all'interfaccia del repo.

> Come alternativa, anche questa che uso, file reStructuredText (lo stesso
> formato di sphinx) dentro ad un repository su un gitlab selfhostato.
Per completezza, RST è la base di sphinx, che aggiunge numerosissime
"facilities" (direttive, ruoli, crossref) ed è inoltre estendibile con
plugin per aggiungere ulteriori funzionalità.

Ciao,
Stefano

-- 
Stefano David, PhD