Presentación de los artículos de la base de conocimientos

La base de conocimientos (llamada también KB o FAQ) de la sección Trucos utiliza una presentación de tipo wiki para sus artículos. A continuación veremos todas las funciones con las que contamos.

1- Los títulos

• El título general se coloca entre un signo “igual” (=) al inicio y otro al final del título.
• El título de nivel 1 se coloca entre 2 signos “igual” (==).
• El título de nivel 2 se coloca entre 3 signos “igual” (===).
• etc.

Importante: la línea debe comenzar y terminar con el signo “igual”

1.1 – Ejemplo

=Título general=

==Título de nivel 1==

===Título de nivel 2===

2 – Las listas

*Viñeta de nivel 1

**Viñeta de nivel 2

***Viñeta de nivel 3

No se recomienda comenzar con una viñeta de nivel 2, ya que será precedida de una viñeta de nivel 1 vacía. Por las mismas razones tampoco se recomienda saltar de nivel.

2.1 – Ejemplo recomendado

2.1.1 – Resultado

• Prueba 1
• Prueba 2
  • Prueba 2.1
  • Prueba 2.2
    • Prueba 2.2.1
    • Prueba 2.2.2
  • Prueba 2.3
    • Prueba 2.3.1
      • Prueba 2.3.1.1
    • Prueba 2.4
    • Prueba 2.5
  • Prueba 3
  • Prueba 4

2.2 – Ejemplos no recomendados

2.2.1 – Empezar por un nivel X

2.2.1.1 – Ejemplo

****Ejemplo

2.2.1.2 – Resultado

• • • • Ejemplo

2.2.2 – Saltarse niveles de viñetas

2.2.2.1 – Ejemplo

2.2.2.2 – Resultado

• Prueba 1
• Prueba 2
  • • Prueba 2.1.1
• Prueba 3

3 – El índice

Dos underscore ("__") al inicio y al final de TOC en mayúscula crea automáticamente el índice basándose en los títulos y subtítulos y con enlaces hacia estos.

__TOC__

Por lo tanto evite poner enlaces en los títulos y subtítulos

4 – Los enlaces externos

Utiliza la siguiente sintaxis para crear un enlace externo:

[URL Texto del enlace]

Se debe dejar un espacio entre la URL y el texto. Si no se pone ningún texto, entonces la URL será utilizada como texto.

4.1 – Enlace rápido

Se puede hacer un enlace directo hacia un artículo utilizando la siguiente sintaxis:

[[Palabra clave]]

Por ejemplo [[placa madre]] creará automáticamente un enlace hacia el articulo acerca de la placa madre.

5 – Los enlaces internos

Un enlace interno está constituido de un título de nivel 1 ó 2 y el nombre de este enlace interno retoma el nombre del titulo en minúscula, sin acentos, sin caracteres especiales y sin espacio.

[#enlace-interno-hacia-el-titulo-1-o-2 enlace interno hacia el título 1 ó 2]

Como podemos observar la sintaxis es colocar entre corchetes ([]):

• La almohadilla (#)
• a continuación y sin dejar espacio el nombre del título y subtítulo
• luego dejar un espacio
• para terminar poner el texto visible del enlace interno hacia los títulos o subtítulos.

Debemos:

• sólo utilizar minúsculas y letras sin acento,
• no acentuar,
• remplazar los espacios por guiones “-“,
• no colocar enlaces en los títulos y subtítulos

Por lo tanto:

• No usar “( )”,
• Los “´” son remplazados por guiones “-“,
• Las “Ç” son remplazadas por “c”,
• ”1 – título” se convierte en “#1-titulo”

6 – Las imágenes

Para agregar una imagen, utilizar esta sintaxis:

[[Image: url_de_la_imagen]]

6.1 – Atributos

Es posible adicionar atributos suplementarios los cuales se acumularán a los ya presentes. Los atributos son separados por el signo “|” (Alt Gr + 1). Estos pueden ser puestos en cualquier orden pero el atributo ALT siempre debe ser el último.

6.2 – Lista de atributos

• Poner la imagen a la izquierda :

  [[Image: url_de_la_imagen|left]]

• Poner la imagen a la derecha :

  [[Image: url_de_la_imagen|right]]

• Poner la imagen al centro (por defecto) :

  [[Image: url_de_la_imagen]]

• Redimensionar la imagen (en pixels) :

  [[Image: url_de_la_imagen|200px]]

• Atributo ALT de la imagen, es el último atributo antes del corchete:

  [[Image: url_de_la_imagen|right|150px|Atributo ALT de la imagen]]

7 – Code

Con esta etiqueta se conserva la sangría y la fuente será una fuente de programación.

<code>Code</code>

8 – Negrita

<gras>Texto en negrita</gras>

9 – Italica

<ital>Texto en itálica</ital>

10 – Subrayar

<souligne>Texto subrayado</souligne>

PD: El artículo original fue escrito por teutates contribuidor de CommentCaMarche