Markdoc

Markdoc è eccellente per la documentazione tecnica, manuali, wiki progetto interno, o generazioni sito statico.
Per la documentazione tecnica / Manuali, Markdoc può essere utilizzato per scrivere e rendere guide scritte a mano e manuali per il software. Tale documentazione sarà normalmente separati da documentazione API generata automaticamente, e potrebbe dare una visione di livello superiore solo documentazione API. Potrebbe essere utilizzato per la documentazione del cliente per applicazioni web / desktop, o anche documentazione per sviluppatori per quadri.
Per il progetto interno wiki, wiki Markdoc costituiti da un singolo file di testo per pagina. Grazie alla combinazione di un wiki con DVCS (come Mercurial o Git), è possibile collaborare con molte altre persone. Utilizzare i DVCS per tenere traccia, condividere e unire le modifiche con l'un l'altro, e visualizzare il wiki & rsquo; s storia.
Per Static Site Generation, Markdoc converte i wiki in file HTML prime e dei media. Ciò consente di gestire un blog, sito web personale o un insieme di pagine in un wiki Markdoc, magari con stili CSS personalizzati, e pubblicare il rendering HTML di un sito web. Markdoc non deve essere installato sul sito di hosting, in quanto la risultante HTML è completamente indipendente

Caratteristiche .

• impostare Google monitoraggio di Google Analytics in una linea di configurazione.
• wiki barebone che basta guardare come directory con i file di testo in formato Markdown in loro.
• A built-in server HTTP e applicazioni WSGI per servire un wiki compilato con un singolo comando.
• continuo costruisce (via rsync) significa che il server può continuare a correre mentre Markdoc nuovamente compila il wiki. Basta aggiornare il browser per vedere i cambiamenti.
• Aggiungi sintassi Pygments alimentato evidenziando al wiki Markdoc con un parametro di configurazione singola.
• Markdoc è un software di pubblico dominio. Sarà sempre completamente gratis da usare, e si può ridistribuire (in tutto o in parte) in nessun caso (open-source, proprietarie o altrimenti) senza attribuzione o encumberances.

Requisiti :

• argparse
• CherryPy
• Jinja2
• Markdown
• Pygments
• PyYAML
• webob
• Python 2.4 o superiore
• rsync