Diferencias

Muestra las diferencias entre dos versiones de la página.

--- es:manual:items:markdown [2025/01/20 10:01] – root
+++ es:manual:items:markdown [2025/01/20 10:30] (actual) – root
@@ Línea 1: / Línea 1: @@
 ===== Markdown =====
-{{wpes>Markdown}} es una forma sencilla de escribir texto estructurado que puede convertirse directamente al {{wpes>HTML|lenguaje HTML}}, que es el que usan las páginas web. A diferencia de HTML, Markdown es simple y no usa etiquetas de marcado, si no simples caracteres que indican el formato, de manera que resulta mas fácil y rápido escribir un texto. Por ejemplo, para crear una tabla en Markdown podría escribirse simplemente:
+{{wpes>Markdown}} es una forma sencilla de escribir texto estructurado que puede convertirse directamente al {{wpes>HTML|lenguaje HTML}}, que es el que usan las páginas web. A diferencia de HTML, Markdown es simple y no usa etiquetas de marcado, si no simples caracteres que indican el formato, de manera que resulta mas fácil y rápido escribir un texto. Por ejemplo, para crear la tabla:
-|Left-Aligned  |   Center Aligned        |    Right Aligned|
-|Linea 1         |    **Negrita**           |           Columna 3|
-|Linea 2         |    //Italica//         |           Columna 3|
-|Linea 3         |   <del>Tachado</del>   |           Columna 3|
-|Linea 3         |   [[https://dot.com|dot.com]]       |           Columna 3|
+|Alineado izquierda  |   Centrado                     |  Alienado derecha|
+|Fila 1              |    **Negrita**                 |         Columna 3|
+|Fila 2              |    //Italica//                 |         Columna 3|
+|Fila 3              |   <del>Tachado</del>           |         Columna 3|
+|Fila 4              |   [[https://www.siette.org|siette.org]]  |         Columna 3|
+En Markdown bastaría con escribir el siguiente texto:
 <code>
-| Left-Aligned  | Center Aligned  | Right Aligned |
+|  Alineado izquierda  |   Centrado         | Alienado derecha|
-|:------------- |:---------------:| -------------:|
+|:-------------------- |:------------------:| ---------------:|
-| Row 1         | **Bold**        | Cell 3        |
+| Fila 1               | **Negrita**        |   Columna 3     |
-| Row 2         | *Italic*        | Cell 6        |
+| Fila 2               | *Italica*          |   Columna 3     |
-| Row 3         | ~~Strike~~      | Cell 9        |
+| Fila 3               | ~~Tachado~~        |   Columna 3     |
-| Row 3         | [Link](dot.com) | Cell 9        |
+| Fila 3               | [Link](siette.org) |   Columna 3     |
 </code>
@@ Línea 26: / Línea 26: @@
 <thead>
 <tr class="header">
-<th style="text-align: left;">Left-Aligned</th>
+<th style="text-align: left;">Alineado izquierda</th>
-<th style="text-align: center;">Center Aligned</th>
+<th style="text-align: center;">Centrado</th>
-<th style="text-align: right;">Right Aligned</th>
+<th style="text-align: right;">Alienado derecha</th>
 </tr>
 </thead>
 <tbody>
 <tr class="odd">
-<td style="text-align: left;">Row 1</td>
+<td style="text-align: left;">Fila 1</td>
-<td style="text-align: center;"><strong>Bold</strong></td>
+<td style="text-align: center;"><strong>Negrita</strong></td>
-<td style="text-align: right;">Cell 3</td>
+<td style="text-align: right;">Columna 3</td>
 </tr>
 <tr class="even">
-<td style="text-align: left;">Row 2</td>
+<td style="text-align: left;">Fila 2</td>
-<td style="text-align: center;"><em>Italic</em></td>
+<td style="text-align: center;"><em>Italica</em></td>
-<td style="text-align: right;">Cell 6</td>
+<td style="text-align: right;">Columna 3</td>
 </tr>
 <tr class="odd">
-<td style="text-align: left;">Row 3</td>
+<td style="text-align: left;">Fila 3</td>
-<td style="text-align: center;"><del>Strike</del></td>
+<td style="text-align: center;"><del>Tachado</del></td>
-<td style="text-align: right;">Cell 9</td>
+<td style="text-align: right;">Columna 3</td>
 </tr>
 <tr class="even">
-<td style="text-align: left;">Row 3</td>
+<td style="text-align: left;">Fila 3</td>
-<td style="text-align: center;"><a href="dot.com">Link</a></td>
+<td style="text-align: center;"><a href="siette.org">Link</a></td>
-<td style="text-align: right;">Cell 9</td>
+<td style="text-align: right;">Columna 3</td>
 </tr>
 </tbody>
 </table>
 </code>
+Evidentemente es mucho mas fácil e intuitivo usar Markdown, teniendo en cuenta que a partir del texto en Markdown puede generarse automáticamente el código HTML usando alguna herramienta de conversión como [[wpes>pandoc]].
+Todos los textos en Siette, para el enunciado, las respuestas, las ayudas y los refuerzos se espera que estén escritos íntegramente en HTML, pero pueden incluir un nuevo par de etiquetas: ''<MARKDOWN>'' y ''</MARKDONW>'' entre las cuales se sitúe un texto escrito en el formato de Markdown. Siette convertirá ese texto a HTML y lo incrustará sustituyendo este trozo de código.
+==== Preguntas generativas ====
+Las etiquetas **<MARKDOWN>**, al igual que otras etiquetas de Siette, pueden usarse también si se trata de una pregunta generativa, ya que la paginas es procesa previamente si usa  [[es:manual:items:generativos:jsp|código JSP]] incrustado, ya sea dentro o fuera del bloque de etiquetas **<MARKDOWN>**.
+==== Alternativas a la etiqueta <MARKDOWN> ====
+Es evidente que editar directamente el código HTML es tedioso, por lo que la opción mas sencilla es usar un editor de HTML. Siette incluye un botón para invocar al [[es:help_items_content#editor auxiliar]] [[https://www.tiny.cloud/|TinyMCE]] en los campos en donde se usa texto en HTML.
+No obstante, si las preguntas provienen de un texto previamente escrito en Markdown, el uso de las etiquetas **<MARKDOWN>** evitará tener que volver a teclear el código y bastará con una operación de copiar y pegar.
-Evidentemente es mucho mas fácil e intuitivo usar Markdown, sobre todo