redtape

redtape é um gerador de documentos focada que usa github markdown aromatizado para gerar documentos HTML simples e atraente. Ele integra automaticamente com o twitter de bootstrap e apresenta um estilo simples e atraente. redtape é inspirado d, mas tenta ter uma interface simples, enquanto ainda permitindo que os usuários estilo e controlar os seus documentos de saída para um alto grau de personalização.
Instalação
Se você estiver em linux ou OSX, você pode usar pip para instalar:
> Pip instalar redtape
Que instalará redtape e suas dependências.
Uso
Para usar, run rt em um documento ou diretório cheio de documentos. Se executado em um diretório, rt irá criar arquivos de html para cada arquivo de remarcação (Md, .mdown, ou extensões .markdown):
> Rt mydocument.md
> Documentação rt /
ativos
Por padrão, rt pressupõe que você tenha criado um local para servir os arquivos a partir da qual têm os ativos que o TR links para esses documentos. O layout é exatamente o mesmo que o diretório de recursos no repositório redtape: / activos / {css, img, js} / .. para cada ativo que você estará usando. Se você quiser usar os ativos padrão do redtape, você pode facilmente criar um diretório ativo adequado no diretório atual por corrida:
> rt --create-ativos
Se você estiver executando no modo de documento único ou não quiser configurar um diretório ativo na eventual acolhimento para seus documentos HTML, você pode dizer redtape para incorporar cada ativo usado em um documento usando --embed:
> Rt --embed mydocument.md
javascript
Por padrão, redtape não requer qualquer javascript para correr, e não incorporar qualquer no modo --embed. Se a opção --prettify é seleccionado, biblioteca de embelezar o Google vai ser usada para destacar fonte em vez de pygments, e se --prettify e --embed são ambos usados, ele será automaticamente incorporado.
Redtape também é adequado para uma única página manifestações javascript simples, e se --use-js está habilitado, redtape incluirá jQuery e bibliotecas javascript de bootstrap.
saída personalizando
Personalizando saída é fácil de fazer em uma variedade de maneiras. Além de mudar a CSS trunfo para documentos não incorporado, você também pode adicionar cabeçalhos e rodapés ou até mesmo usar modelos de documentos personalizados com base em modelo padrão de redtape.
cabeçalhos e rodapés
Se você tem um cabeçalho do documento personalizado ou rodapé que você deseja adicionar aos seus documentos, você pode adicionar documentos header.html e footer.html para o diretório base que estão prestando ou definir caminhos padrão a ser usado na configuração de cabeçalho e rodapé. Por padrão, eles serão colocados na parte superior e inferior do documento, respectivamente.
Um exemplo de conjunto de documentos pode ser:
> ls mydocs /
mydocs / index.md mydocs / simple.md mydocs / advanced.md
mydocs / header.html mydocs / footer.html
Renderização mydocs com mydocs rt usará o cabeçalho e rodapé para cada documento no diretório.
modelos personalizados
Se você tem exigências muito específicas, você pode escrever o seu próprio modelo de documento e ter o controle total da produção. Redtape usa o mecanismo de modelagem Jinja2, que é um sistema de templates amplamente utilizado semelhante a Django templates. Redtape executado com o argumento --context para obter uma breve ideia do que variáveis ​​estão disponíveis para o modelo.
Você também pode herdar de basic.jinja, que é o nome do modelo padrão de redtape. Este modelo define dois blocos, cabeça e no corpo, o que lhe permitiria criar um corpo documento distinto, enquanto, por exemplo, mantendo o CSS básico e funcionalidade JavaScript de redtape. Substituindo tanto vai deixar você com uma estrutura de documento padrão HTML5.
Você pode especificar um modelo personalizado para usar com -t, --template ou colocá-lo no diretório documento como custom.html ou custom.jinja

Requisitos :.

• Python