Markdoc

Markdoc é excelente para documentação técnica, manuais, wikis projeto interno, ou gerações site estático.
Para documentação técnica / Manuais, Markdoc pode ser usado para escrever e tornar guias escritas à mão e manuais para o software. Essa documentação será normalmente separada da documentação da API gerada automaticamente, e pode dar uma visão de alto nível do que sozinho documentação da API. Ele pode ser usado para a documentação do cliente para aplicações web / desktop, ou mesmo documentação do desenvolvedor para frameworks.
Para o Project Interno Wikis, wikis Markdoc consistem em um único arquivo de texto simples por página. Ao combinar uma wiki com um DVCS (tais como Mercurial ou Git), você pode colaborar com várias outras pessoas. Use os DVCS para acompanhar, compartilhar e mesclar as alterações com o outro, e visualizar o wiki & rsquo; s história.
Para estático Geração Site, Markdoc converte wikis em arquivos HTML puro e meios de comunicação. Isso permite que você gerencie um blog, site pessoal ou uma coleção de páginas em um wiki Markdoc, talvez com estilos CSS personalizados, e publicar o HTML renderizado para um site. Markdoc não precisa ser instalado no site de hospedagem, já que o HTML resultante é completamente independente

Recursos :.

• Configurar o Google Analytics em uma linha de configuração.
• wikis barebones que apenas olham como diretórios com arquivos de texto Markdown-formatados em-los.
• A built-in servidor HTTP e aplicação WSGI para servir um wiki compilado com um único comando.
• constrói contínuo (via rsync) significa que o servidor possa continuar funcionando enquanto Markdoc re-compila a wiki. Basta atualizar seu navegador para ver as alterações.
• Adicione sintaxe pygments-powered destacando a sua wiki Markdoc com um único parâmetro de configuração.
• Markdoc é software de domínio público. Ele sempre estará completamente livre de usar, e você pode redistribuí-lo (em parte ou no todo) sob quaisquer circunstâncias (open-source, proprietária ou não) sem atribuição ou encumberances.

Requisitos :

• argparse
• CherryPy
• Jinja2
• Markdown
• pygments
• PyYAML
• WebOb
• Python 2.4 ou superior
• rsync