kramdown

kramdown es una biblioteca libre de Ruby que se puede utilizar para analizar un superconjunto de Markdown & nbsp;. Está completamente escrito en Ruby, apoya Markdown estándar (con algunas modificaciones menores) y varias extensiones que se han hecho populares por el PHP Markdown paquete extra y Maruku.
Es probablemente el más rápido convertidor de pura-Rubí Markdown disponible (noviembre de 2009), siendo 5 veces más rápido que Maruku y aproximadamente 10 veces más rápido que Bluefeather.
La sintaxis kramdown se basa en Markdown, muy fácil de escribir, de fácil lectura de marcas para escribir documentos HTML en texto plano. Desde la sintaxis básica Markdown tiene algunas deficiencias, las implementaciones (especialmente el paquete extra PHP Markdown) han intentado superar este deficiencias con sintaxis adicional. kramdown soporta todas las características de la sintaxis Markdown originales (aunque con algunas correcciones menores), así como nuevas características implementadas en el PHP Markdown paquete extra y Maruku.
Uso:
El paquete kramdown ofrece dos formas de usarlo:
* Como una biblioteca
& Nbsp; kramdown utiliza básicamente la misma API como RedCloth, BlueCloth y Maruku:
& Nbsp; require 'kramdown'
& Nbsp; Kramdown :: Document.new (texto) .to_html
& Nbsp; El segundo parámetro a la nueva llamada es un hash de opciones para (des) activar ciertas funciones. Para obtener más información echar un vistazo a la documentación de la API.
* Como una aplicación
& Nbsp; En conjunto con la biblioteca de archivos de un binario llamado kramdown se envía que se puede utilizar para convertir texto en la sintaxis kramdown a HTML. Se lee desde los archivos especificados como los argumentos de la línea de comandos o desde la entrada estándar. Por ejemplo:
& Nbsp; kramdown ruta / a / kramdown / doc / syntax.page

¿Cuál es nuevo en esta versión:

• 2 menores cambios:
• Ha añadido un analizador de Github sabores de rebajas (que se soluciona GH # 68 de Arne Brasseur que proporcionó la implementación inicial)
• atributos HTML son ahora de salida para las líneas horizontales

Correcciones
• 5 errores:
• La codificación correcta en la cadena de resultado se establece ahora, incluso cuando se utiliza la opción de plantilla
• Fijo GH # 72, GH # 74: Todos los modos de establecer un ID de cabecera ahora sigue el mismo esquema que cumple con los ID de HTML (excepto que los puntos no están permitidos) (reportado y parche inicial por Matti Schneider)
• Fijo GH # 73: La plantilla HTML por defecto ahora tiene un DOCTYPE y establece correctamente la codificación (parche inicial por Simon Lydell)
• Fijo GH # 67: URLs de elementos de enlace se han escapado en el convertidor de látex para evitar problemas (parche de Henning Perl)
• Fijo GH # 70: Cualquier versión de la biblioteca stringex es ahora compatible (reportado por Simon Lydell)

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

• 2 pequeños cambios:

Marcadores
• Footnote ahora se pueden repetir (resuelve GH # 62 y # 63 GH por Theodore Pak que proporcionó la revisión inicial)
• El paquete siglas LaTeX se utiliza ahora para abreviaturas (resuelve GH # 55 por Tim Besard que proporcionó la revisión inicial)

Correcciones
• 3 errores:
• Fijo GH # 60: Los números son ahora reconocidos, además de caracteres de palabra al convertir guiones bajos (parche por Trevor Wennblom)
• Fijo GH # 66: elementos HTML, y ahora se convierten correctamente por el conversor LaTeX (parche de Henning Perl)
• Fijo GH # 57: Mejor manejo cita inteligente cuando subrayados son directamente antes o después de las comillas (reportado por Bill Tozier)

¿Qué es nuevo en la versión 1.0.2:

• La página de pruebas se ha actualizado para incluir tiempos relativos en el punto de referencia de modo que sea posible evaluar mejor el rendimiento de kramdown (solicitado por posmoderno).
• El kramdown Wiki ahora contiene un listado de las bibliotecas que se extienden kramdown (idea por posmoderna).

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

• 4 pequeños cambios:
• Nuevos transliterated_header_ids opción para transcribir el texto del encabezado en ASCII antes de generar un ID de cabecera, que es útil para la lengua como el vietnamita (fijo GH # 35, solicitada por Ky Anh)
• La entidad comilla & quot; ahora consigue convertido a su equivalente personaje cuando entity_output = as_char.
• Una advertencia es ahora de salida para IALs / ALD que no contienen atribuyen DEFINICIÓN.
• salida de pie de página HTML se cambia para usar la clase en lugar de rel lograr (X) HTML 4/5 compatibilidad

Correcciones
• 3 errores:
• Fijo GH # 38: Codificación problema en 1.9 / 2.0 debido a codificaciones incompatibles - la cadena de origen se convierte ahora en UTF-8 antes de analizar y convertir de nuevo después de la conversión (reportado por Simon Lydell)
• Fijo RF # 29647: abreviaturas no-palabra primer carácter en el arranque de plomo de texto a excepción (reportado por Stephan Dale)
• Fijo RF # 29704: ID especificado en conectores de estilo atx fueron no siempre detecta correctamente (reportado por Kyle Barbour)

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

• 1 cambio menor:
• Nuevos link_defs opción para definitorias pre definiciones de enlace

Fix
• 1 error:
• errores planteados fijos en las cabeceras ATX sin texto

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

• Sólo los elementos HTML que no deben contener un cuerpo ( similares) se emiten en esta forma, todos los demás elementos ahora utilizan una etiqueta de cierre explícito (resuelve entre otros temas las cosas con)
• Especificación de un bloque IAL antes de una lista de definición ahora funciona correctamente
• Solución del problema de GH # 30: Cuerpo vacío para una definición en una ventaja de lista de definición a una excepción (reportado por Mark Johnson)

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

• 2 grandes cambios:
• Idioma Código está especificado a través .language-CODELANG lugar de lang = 'CODELANG'
• Soporte implementado para cambiar el idioma en la línea de partida bloque código vallada (parche inicial por Bran)
• 1 cambio menor:
• Conectores con un ID se puede impedir que muestra en la tabla de contenido mediante la asignación de la clase .no_toc a ellos (parche de Tim Bates)

Fix
• 1 error:
• numérico en lugar de las entidades HTML simbólicos son ahora la reserva predeterminado (parche por Gioele Barabucci)

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

• 2 pequeños cambios:
• atributos HTML sin valores son ahora soportados (correcciones de bug # 29490 RF reportado por Nat Welch)
• atributos HTML nombres están siempre convertidas a minúsculas para la consistencia

Correcciones
• 5 errores:
• Fijo Documento # method_missing para aceptar el nombre de clase snake_cased (parche por tomykaira)
• Corregido el problema de falta REXML constante en los más antiguos de Ruby versión 1.8.6 (reportado por Dave Everitt)
• Solución del problema de RF # 29520: declaración matemáticas Válido inline no desencadena bloque matemático más (reportado por Gioele Barabucci)
• Solución del problema de RF # 29521: La salida de matemáticas HTML es ahora siempre XHTML compatibles (reportado por Gioele Barabucci)
• atributos id vacíos ahora se manejan mejor por los HTML y kramdown convertidores (reportados por Jorg Sommer)

Fix
• 1 Documentación:
• Fijo declaración opciones no válidas en el ejemplo en la página de referencia rápida (reportado por Jorg Sommer)

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

• Se ha añadido un convertidor que extrae el TOC de un documento (solicitado por Brendan Hay). Tenga en cuenta que esto sólo es útil si utiliza kramdown como una biblioteca!
• Se ha corregido un error tipográfico: Debe --output y no --ouput (parche por posmoderna)
• convertidor HTML fija a las etiquetas span vacíos correctamente salida (parche de John Croisant)
• Solución de error RF # 29350: análisis sintáctico de las etiquetas HTML con el caso coinciden ahora trabaja
• Solución de error RF # 29426: El contenido de las etiquetas de estilo se trata como texto sin formato ahora
• convertidor HTML ahora utiliza rel en lugar de rev ser HTML5 compatible (parche por Joe Fiorini)
• Fijo de Ruby 1.9.3 advertencias relacionadas
• Fijo analizador HTML para evitar un cambio de aplicación de la matriz # delete_if en Ruby 1.9.3

Requisitos :

• Rubí