Grazie a tutti, ora indaghiamo! Ciao, Bruno
-- Bruno Bossola CTO - meterian.io Scan your website now! <https://www.meterian.com/webscanner.html> Scan your project now! <https://www.meterian.com/projectscanner.html> On Tue, 11 Feb 2020 at 11:12, 'emanuele.ma...@gmail.com' emanuele.ma...@gmail.com [it-torino-java-jug] < it-torino-java-jug@yahoogroups.com> wrote: > > > Ciao, > se ti può essere utile, qualche anno fa avevo usato MkDocs ( > https://www.mkdocs.org/) con questa estensione ( > https://squidfunk.github.io/mkdocs-material/) per gestire la nostra > documentazione e mi ero trovato molto bene.. > Con l'exec-maven-plugin avevamo facilmente automatizzato la generazione > del site da maven e la creazione di un pacchetto di documentazione che > veniva poi incluso come dipendenza e servito nei nostri portali. > Ciao, Emanuele. > > Il giorno mar 11 feb 2020 alle ore 10:20 Uberto Barbini > uberto.g...@gmail.com [it-torino-java-jug] < > it-torino-java-jug@yahoogroups.com> ha scritto: > >> >> >> Credo ci sia anche un plugin per generare un intero sito di >> documentazione (statico) da asciidoc. Anche io mi sono trovato molto bene. >> >> Uberto >> >> On Tue, 11 Feb 2020 at 08:23, Roberto Franchini ro.franch...@gmail.com >> [it-torino-java-jug] <it-torino-java-jug@yahoogroups.com> wrote: >> >>> >>> >>> >>> >>> On Tue, Feb 11, 2020 at 9:03 AM bruno bossola bboss...@gmail.com >>> [it-torino-java-jug] <it-torino-java-jug@yahoogroups.com> wrote: >>> >>>> >>>> >>>> Ciao a tutti, >>>> >>>> Qualcuno può consigliare un tool gratuito x realizzare un sito di >>>> documentazione che sia più facilmente mantenibile? Oltre al codice, servono >>>> anche le istruzioni per l'uso ;) >>>> >>>> >>>> >>> Ho usato sia https://www.gitbook.com/ che https://asciidoctor.org/ >>> >>> gitbbook non lo avevo scelto, mi sono adeguato. E' pensato per scrivere >>> libri, puoi generare html e pdf, usa MK >>> >>> ascidoctor l'ho scelto. Penso sia migliore per documentare progetti sw, >>> anche perche' puoi includere snippet di codice direttamente dai sorgenti, >>> e' sufficiente annotare i sorgenti stessi: niente piu' codice obsoleto/non >>> funzionante nella documentazione >>> Ovviamente usa AsciiDoc come formato. >>> Un progetto a caso che lo usa: >>> https://junit.org/junit5/docs/current/user-guide/ >>> Con il plugin maven generi sia html che pdf. >>> >>> Ho una conf di maven che permette anche il jetty:run, te la metto su >>> github per 2 birre al BrewDog >>> >>> FRANK >>> -- >>> Roberto Franchini >>> "The impossible is inevitable" >>> https://github.com/robfrank/ >>> https://twitter.com/robfrankie >>> https://www.linkedin.com/in/robfrank >>> >>> > > -- > > > >
