%RPLC-TITULO-DEL-DIALOGO |
Buscar [QUE_BUSCAR]:
|
PHP Markdown Extra Es una extensión del lenguaje de marcación Markdown que permite incluir tablas, listas de definiciones (con elementos dl dt y dd) y asignar ids y clases a algunos elementos como Hx e img.
Como la biblioteca que lo interpreta es mucho más pesada que la que interpreta a Markdown el motor de soporte que incluye Sintetice exige que el texto a interpretar contenga una marca de inicio que le permite decidir qué intérprete usa así:
Si el texto a interpretar inicia con la marca [EXTRA] ejecuta la librería de soporte para PHP Markdown Extra si inicia con cualquier otra cadena ejecuta el intérprete para Markdown. Esto hace que si no se piensa incluir tablas ni hacer asignación de clases no se deba poner la marca inicial para ganar en velocidad de ejecución.
Es importante indicar que los bloques requieren uso explícito de líneas intermedias. Las terminaciones usando dobleespacio que son correctamente procesadas por el intérprete ligero, no lo son por el intérprete extra. Se debe validar las presentaciones logradas antes de dar por terminada una edición.
Listas de definiciones
Luego de una línea en blanco usar secuencias de la forma:
Linea de nombre a definir o encabezado //se mostrará como dt
: Línea de texto de definición //se mostrará como dl
: Otra línea de definición // nótese que se dejó una líne en blanco intermedia
Tablas Basta con usar barras verticales | entre celdas, Una línea de la tabla en cada renglón y se exige usar grupos de guiones en la línea que separa los encabezados como se ilustra a continuación.
Encabezado1 | Encabezado2 | ...
----------- | ----------- | ...
celda 1.1 | celda 1.2 | ...
...
| -------: |
para alinear a derecha su columna, e iniciar y terminar con dos puntos :-----:
para indicar que va centrada. Asignar ids y clases
Al escribir textos muy largos suele aparecer la necesidad de crear enlaces dentro del mismo que lleven de un punto a otro (p.ej: de una tabla de contenidos a las secciones a las que hace referencia y regresar de ellas a la tabla) para ello, se emplea una marca cuya sintaxis es: { #iddelelemento .clase1 .clase2 atributo=valor }
colocada a la derecha del mismo. De momento esta característica solo aplica para Encabezados, bloques de código cercados, enlaces e imágenes.
Notas al final del bloque (pseudonotas de pie de página)
Marcar la posición de la nota usando la sintaxis: texto antes del marcador[^1]
y renglones abajo (puede ser enseguida) en una línea independiente usar el marcador seguido del texto de anotación ej: [^1]: Este es un comentario.
Texto que llama a la nota 3[^3]
[^3]: Desarrollo de la nota 3.
Sintetice todavía no soporta escritura html dentro de las áreas de texto. De modo que por ahora, mientras se cura la paranoia de sus desarrolladores, sólo puede usarlo para documentar otros lenguajes. En el futuro mejoraremos los filtros y ofreceremos ese soporte.