Re: [Python] [OT] Documentazione online
Puoi usare sphinx-doc[1], lo stesso software in uso per la documentazione di Python (e molti altri progetti). Lo uso sporadicamente ma è davvero un gioiellino, per il versioning puoi affidarti a qualche software come mercurial o git. Scrivi la documentazione su file di testo usando il formato rst[2], poi lanci il comando per la generazione della documentazione in formato html, epub, tex, pdf... Modificando il template, che richiede davvero pochi sforzi, puoi mettere un link alle varie versioni della documentazione (precedentemente generate in html). Saluti Infrid [1] http://sphinx-doc.org/ [2] http://docutils.sourceforge.net/rst.html ___ Python mailing list Python@lists.python.it http://lists.python.it/mailman/listinfo/python
Re: [Python] [OT] Documentazione online
Il 14 novembre 2013 21:12, Infrid deb...@infrid.com ha scritto: Puoi usare sphinx-doc[1], lo stesso software in uso per la documentazione di Python (e molti altri progetti). Lo uso sporadicamente ma è davvero un gioiellino, per il versioning puoi affidarti a qualche software come mercurial o git. Io uso la combinazione: Sphinx - bitbucket - readthedocs. Quando invio su bitbucket.org una modifica alla documentazione, readthedocs compila i file .rst producendo e visualizzando la nuova versione della documentazione nei diversi formati. Come esempio puoi vedere: https://readthedocs.org/projects/pygraph/ che prende i sorgenti da: https://bitbucket.org/zambu/pygraph Ciao -- Daniele www.fugamatematica.blogspot.com giusto! nel verso forse è perché non guardiamo le cose Quando non ci capiamo, ___ Python mailing list Python@lists.python.it http://lists.python.it/mailman/listinfo/python
Re: [Python] [OT] Documentazione online
Il giorno 14 novembre 2013 21:33, Daniele Zambelli daniele.zambe...@gmail.com ha scritto: Io uso la combinazione: Sphinx - bitbucket - readthedocs. Grazie ad entrambi, sono preziosi consigli per me. Ciao. Daniele ___ Python mailing list Python@lists.python.it http://lists.python.it/mailman/listinfo/python
Re: [Python] [OT] Documentazione online
Ciao Daniele, In data martedì 12 novembre 2013 19:15:23, Daniele Palmese ha scritto: Ciao a tutti, volevo sapere quali software per la gestione e distribuzione online di documentazione consigliate. Nello specifico dobbiamo controllare la distribuzione di diverse versioni di un manuale per l'utilizzo di un WS. Pochissimi i requisiti necessari: - Controllo versione; - Accesso a contenuti personalizzati per utente. Sono ben accetti tutti i suggerimenti. Plone: http://plone.org Fabry -- Fabrizio Reale Chief Technology Officer http://linkedin.com/in/fabrizioreale Redomino Srl http://redomino.com HQ Largo Valgioie 14, Turin IT Phone +39 0117499875 ___ Python mailing list Python@lists.python.it http://lists.python.it/mailman/listinfo/python
[Python] [OT] Documentazione online
Ciao a tutti, volevo sapere quali software per la gestione e distribuzione online di documentazione consigliate. Nello specifico dobbiamo controllare la distribuzione di diverse versioni di un manuale per l'utilizzo di un WS. Pochissimi i requisiti necessari: - Controllo versione; - Accesso a contenuti personalizzati per utente. Sono ben accetti tutti i suggerimenti. Grazie e scusate l'OT. Daniele ___ Python mailing list Python@lists.python.it http://lists.python.it/mailman/listinfo/python