%RPLC-TITULO-DEL-DIALOGO

   
Buscar [QUE_BUSCAR]:
%RPLC-CONTENIDO-DEL-DIALOGO

Documentación de ayuda

:  
:  
 
:  
Elija el tipo de filtro que desea aplicar a la lista de artículos de ayuda
Busque y elija un propósito para el que pueda haber ayuda escrita.
Busque y elija el tipo de objeto a usar como filtro
Busque y elija el tópico de documentación a usar como filtro
:  
Elija el campo en que desea buscar. Fije una condición de búsqueda y escriba un texto breve. No use comillas ni caracteres especiales. Se admiten letras tildadas y ñ

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.

Adiciones a la sintaxis de Markdown

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   | ...  
    ...  
    • alineación de las columnas en las tablas
      En la línea de separación de encabezados poner : al final de los guiones en una celda | -------: | 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.  

Limitaciones

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.