Markowik

Markowik es una aplicación de Python que convierte Markdown texto con formato de Google Code Wiki.
Markowik es capaz de convertir la mayoría de las construcciones de rebajas a sus Google Code Wiki (VCG) equivalentes. En lugar de enumerar todas las conversiones soportadas, por favor eche un vistazo a banco de pruebas de Markowik y su vitrina.
Instalación
Carrera:
PIP instalar markowik
o:
easy_install markowik
También puede utilizar Markowik sin necesidad de instalación, como se describe en Contribute.
Uso de línea de comandos
Desde la salida de la ayuda:
uso: markowik [-h] [--mx [MX [MX ...]]] [URL --image-baseurl]
& Nbsp; [- html imágenes] [CODIFICACIÓN --encoding] [--quiet]
& Nbsp; INFILE [OUTFILE]
Convertir Markdown a Google Code Wiki.
argumentos posicionales:
& Nbsp; archivo rebaja INFILE
& Nbsp; archivo wiki OUTFILE (por defecto: stdout)
argumentos opcionales:
& Nbsp; -h, --help muestra este mensaje de ayuda y termina
& Nbsp; - mx [MX MX [...]] extensiones de rebajas para activar
& Nbsp; - URL base URL de la imagen-baseurl a anteponer a ubicaciones relativas de las imagenes
& Nbsp; - html imágenes siempre utilizan HTML para las imágenes
& Nbsp; - codificación codificación CODIFICACIÓN de entrada y salida (por defecto: UTF8)
& Nbsp; - los mensajes de información desactivar tranquilas
Extensiones de rebajas se pueden administrar de manera similar como para la herramienta de línea de comandos Python Markdown (PyMD), con la excepción de que las extensiones individuales deben estar separados por un espacio:
markowik tablas input --mx def_list
Los (es decir probados) extensiones soportadas actualmente son abbr, mesas, y def_list. Otras extensiones generalmente deben trabajar también, pero pueden producir resultados inesperados en el texto wiki convertido.
En cuanto a las opciones --html-imágenes, consulte las siguientes explicaciones de Limitaciones.
Uso Programático
Markowik está implementado en Python. El módulo markowik ofrece una función llamada converso. Semánticamente, es similar a la interfaz de línea de comandos (argumentos clave corresponden a las teclas opciones de la línea). He aquí un ejemplo de uso corto:
>>> Markowik importación
>>> markowik.convert ("Algunos * * rebaja de texto ...", mx = ['tablas'])
texto u'Some _markdown_ ... '
Página pragmas
GCW página pragmas se pueden establecer en los archivos fuente de rebajas como meta datos en el formato definido por la extensión meta PyMD:
>>> Src = "" "Resumen: Resumen de una página
... Etiquetas: algunos, etiquetas
...
... Aquí comienza la página * * ..
... "" "
>>> Markowik.convert impresión (src, mx = ['meta'])
#summary resumen de la página
#labels algunos, etiquetas

Aquí comienza la _page_ ..
Tenga en cuenta que la extensión meta tiene que ser activado explícitamente, es decir, por defecto Markowik no reconoce página pragmas

¿Qué hay de nuevo en esta versión:.

< ul>

¿Qué hay de nuevo en la versión 0.1.1:.

• Documentación mejorada
• Correcciones menores.

Requisitos :

• Python

Limitaciones :

• AGC no puede expresar todo marcado posible en Markdown. Esto significa que los archivos de origen de rebajas deben ser escritos con las siguientes limitaciones en mente.


• bbli URLs en enlaces e imágenes:
• URL utilizadas para enlaces o fuentes de imagen tiene que ser absoluta y deben tener un protocolo específico para ser reconocido por la VCG. En particular, cualquier URL debe comenzar con http: //, https: // o ftp: //. Markowik aborta la conversión si encuentra URLs no cumplan esto.


• Typefacing en Enlace Nombres:
• VCG no soporta typefacing en los nombres de enlace. Por ejemplo AGC hace que el nombre de enlace en [http://foo.com _Foo_] literalmente, es decir, como _Foo_. Sin embargo, la VCG reconoce typefacing en enlaces HTML, es decir, & lt; a href = & quot; http: //foo.com" & Gt; _Foo_ & lt; / A & gt; se enfatiza correctamente. Por esta razón los enlaces de rebajas con typefacing anidada como [* Foo *] (http://foo.com) se convertirán en enlaces HTML. Como resultado, las etiquetas de enlace con ciertos caracteres especiales que tienen que ser escapó en la VCG usando comillas invertidas (`) marcadores serán también resultar en enlaces HTML.


• anidados Párrafos:
• VCG realidad no admitir varios párrafos anidados (por ejemplo, en listas o blockquotes). Markowik simula varios párrafos anidados separándolas con una & lt; br / & gt; (Que visualmente imita párrafos, pero no se rompe el ambiente de anidación).


• bbli Imágenes:
• Markdown permite expresar textos alternativos y título de las imágenes. Sintaxis imagen de la VCG no soporta esto. La única manera de preservar estos textos es utilizar la versión HTML simplificada & lt; img & gt; las etiquetas. La opción --html-imágenes permite esta solución.
• Otra cuestión es que la VCG espera URL de imagen para terminar con una extensión de imagen tipo de archivo. Markowik añade extensiones imagen artificial si es necesario, por ejemplo, se cambia http://foo.bar/image a http://foo.bar/image?x=x.png.


• Abreviaturas:
• VCG no tiene marcado para abreviaturas ni tampoco apoya la etiqueta HTML & lt; abbr & gt ;. Markowik convierte abreviaturas a & lt; lapso & gt; -elementos que tipo de imita abreviaturas (de forma limitada, por supuesto)
.

• HTML:
• Cualquier HTML plano se produce en una fuente de rebajas termina, literalmente, en la VCG (con la excepción del contenido de las etiquetas de nivel de intervalo). Esto significa que la fuente de rebajas sólo debe contener HTML con el apoyo de la VCG. Otra implicación es que las URL utilizadas en etiquetas HTML sin formato no se comprueba la compatibilidad de la VCG. En otras palabras: cuando se utiliza HTML puro usted está en su propia