Markowik

Markowik é um aplicativo Python que converte Markdown texto formatado para o Google Code Wiki.
Markowik é capaz de converter a maioria das construções de remarcação para baixo aos seus Google Code Wiki (GCW) equivalentes. Em vez de listar todas as conversões suportadas, por favor, dê uma olhada no conjunto de testes de Markowik e seu show case.
Instalação
Execute:
pip instalar markowik
ou:
easy_install markowik
Você também pode usar Markowik sem instalação, conforme descrito no Contribute.
Linha de Comando Uso
Desde a saída de ajuda:
uso: markowik [-h] [--mx [MX [MX ...]]] [--image-baseurl URL]
& Nbsp; [- html-imagens] [--encoding ENCODING] [--quiet]
& Nbsp; INFILE [OUTFILE]
Converso Markdown para Google Code Wiki.
argumentos posicionais:
& Nbsp; arquivo markdown INFILE
& Nbsp; arquivo wiki OUTFILE (padrão: stdout)
argumentos opcionais:
& Nbsp; -h, --help mostrar esta mensagem de ajuda e sai
& Nbsp; - mx [MX [MX ...]] extensões de remarcação para ativar
& Nbsp; - URL imagem-baseurl base de URL para preceder a locais relativos de imagens
& Nbsp; - html imagens sempre usar HTML para imagens
& Nbsp; - encoding encoding codificação de entrada e de saída (padrão: UTF8)
& Nbsp; - tranquilos desativar as mensagens de informação
Extensões de remarcação pode ser dada de forma semelhante como para a ferramenta de linha de comando do Python Markdown (PyMD), com a excepção de que as extensões individuais devem ser separados por um espaço:
markowik tabelas de entrada --mx def_list
Os (ie testados) extensões suportadas atualmente são abbr, tabelas e def_list. Outras extensões em geral deve funcionar também, mas pode produzir resultados inesperados no texto wiki convertido.
Sobre a opção --html-imagens, veja as explicações abaixo na limitações.
Programático Uso
Markowik é implementado em Python. O módulo markowik fornece uma função chamada converso. Semanticamente, é semelhante à interface de linha de comando (argumentos correspondem a comandar as opções de linha). Aqui está um exemplo de uso curto:
>>> Markowik importação
>>> markowik.convert ("Alguns * * markdown texto ...", MX = ['mesas'])
texto u'Some _markdown_ ... '
Página Pragmas
GCW página pragmas pode ser definido em arquivos de origem Markdown como meta dados no formato definido pela extensão meta PyMD:
>>> Src = "" "Resumo: resumo página
... Etiquetas: alguns, rótulos
...
... Aqui começa a página * * ..
... "" "
>>> Print markowik.convert (src, mx = ['meta'])
Resumo página #summary
#labels alguns, rótulos

Aqui começa o _page_ ..
Note-se que a extensão meta tem que ser ativado explicitamente, ou seja, por padrão Markowik não reconhece pragmas página

O que é novo nesta versão:.

< ul>

O que é novo na versão 0.1.1:.

• documentação Improved
• Pequenas correções.

Requisitos :

• Python

Limitações :

• GCW pode não expressar toda marcação possível em Markdown. Isso significa que os arquivos de origem de remarcação para baixo deve ser escrito com as seguintes limitações em mente.


• bbli URLs em links e imagens:
• URLs usados ​​para links ou fontes de imagem tem que ser absoluta e deve ter um protocolo específico para ser reconhecido por GCW. Em particular, qualquer URL deve começar com http: //, https: // ou ftp: //. Markowik aborta a conversão se verificar URLs não correspondam a esses requisitos.


• Typefacing no link Nomes:
• GCW não suporta typefacing nos nomes de links. Por exemplo GCW torna o nome do link em [http://foo.com _Foo_] literalmente, ou seja, como _Foo_. No entanto, reconhece GCW typefacing em links em HTML, ou seja, & lt; a href = & quot; http: //foo.com" & Gt; & lt _Foo_; / A & gt; é enfatizado adequadamente. Por esta razão, as ligações com Markdown typefacing aninhada como [* Foo *] (http://foo.com) serão convertidas em links em HTML. Como resultado, os rótulos relação com determinados caracteres especiais que têm de ser escapou em GCW usando crase (`) marcadores também vai resultar em links em HTML.


• Nested Parágrafos:
• GCW realmente não suporta vários parágrafos aninhados (por exemplo, listas ou blockquotes). Markowik simula vários parágrafos aninhadas, separando-os com um & lt; br / & gt; (Que imita visualmente parágrafos, mas não quebra o ambiente de nidificação).


• Imagens:
• Markdown permite expressar textos alternativos e de título para as imagens. Sintaxe imagem de GCW não suporta isso. A única maneira de preservar esses textos é usar HTML simples & lt; img & gt; Tags. A opção --html-imagens permite que esta solução alternativa.
• Outra questão é que GCW espera URLs imagem terminarem com uma extensão de imagem do tipo de arquivo. Markowik adiciona extensões imagem artificial, se necessário, por exemplo http://foo.bar/image é alterado para http://foo.bar/image?x=x.png.


• Abreviaturas:
• GCW não tem marcação para abreviaturas nem suporta a tag HTML & lt; abbr & gt ;. Markowik converte abreviaturas para & lt; span & gt; -elements que tipo de imita abreviaturas (de forma limitada, é claro)
.

• HTML:
• Qualquer HTML simples ocorrendo em uma fonte Markdown acaba, literalmente, em GCW (com exceção do conteúdo das marcas de nível span). Isto significa que a fonte Markdown deve conter apenas HTML apoiada por GCW. Outra implicação é que URLs utilizados em tags HTML simples não são verificados quanto à compatibilidade GCW. Em outras palavras: quando se usa HTML bruto, você está por sua conta !