Introducción

Esta pequeña guía le ayudará a conocer la sintaxis básica para la edición del Wiki de SLEC, en la que encontrará ejemplos prácticos para las características más usadas. En caso de que desee explorar más, por favor consulte la documentación Guía del usuario en inglés.

Si desea practicar lo estudiado, puede utilizar la zona de practicas libres, en donde puede experimentar la edición del wiki y sus resultados.

Luego de estar "ducho" :) en la edición de wikis puede empezar a coloborar en nuestro sitio siguiendo el enlace de la opción edit que se encuentra en la parte superior de la página.

Si usted sabe emplear características de este wiki que todavía no hacen parte de este documento, por favor, edítelo y ayúdenos a complementarlo para que más personas que escriban en español puedan hacer uso de estas.

Enlaces

Enlaces internos

Un enlace interno hace referencia a un link dentro del mismo wiki de SLEC y se realiza usando dobles corchetes cuadrados antes y después de la palabra a enlazar. <nowiki>enlace</nowiki> En este caso el enlace y el nombre del enlace quedarán con el mismo nombre. Si desea que el nombre del enlace quede con un nombre diferente al del enlace se debe separar el enlace del nombre con una barra vertical. <nowiki>nombre_enlace</nowiki>

Ejemplos:

Enlaces externos

Un enlace externo hace referencia a un link fuera de nuestro wiki. Este enlace se puede realizar escribiendo directamente el URL a enlazar como http://www.slec.net o si se desea dar un título al enlace, se hace separando el enlace del título del enlace por un espacio y encerrándolos por corchetes cuadrados <nowiki>[Enlace título_enlace]</nowiki>

Ejemplo:

Enlaces en la misma página

Este tipo de enlaces hace referencia a los links dirigidos a las secciones de la página que se encuentra cargada actualmente. Para ello se debe estructurar con anterioridad la página por secciones. Leer más sobre secciones

La sintaxis usada es la siguiente:

<nowiki>nombre_enlace</nowiki>

Ejemplo:

=Cómo dar formato a la página?=

Secciones

Las secciones se usan para estructurar una página en temas y subtemas. Para crear una sección nueva se debe escribir contra el margen izquierdo el signo igual (=) antes y después del nombre que se le va a dar a la sección. Al generar una nueva sección, el wiki crea un nuevo enlace contra el margen derecho, para editar unicamente la sección. <nowiki>=nombre_sección=</nowiki>

Las secciones tienen un orden jerárquico estructural para organizar la información por temas y subtemas. El nivel jerárquico de la sección depende de la cantidad de signos igual (=) que posea, entre más signos igual (=) tenga la sección, su nivel jerárquico es menor. Este nivel jerárquico afecta también el formato del texto de la sección, si es de primer nivel su texto aparecerá en letra mucho más grande que las demás. La cantidad máxima de niveles es de seis (6).

Ejemplos:

Indentación de párrafos

El uso de la indentación dentro del wiki es muy sencillo, sólo se debe iniciar el párrafo que se desea indentar con dos puntos (:) <nowiki>:Párrafo indentado</nowiki> Si desea tener una mayor indentación se agregan más dos puntos (:) al inicio del párrafo.

Ejemplos:

Resultado: :Esta línea esta indentada. ::Esta línea tiene mayor indentación. :::Esta línea tiene aún mayor indentación.

Listas

Las listas como su nombre lo indica, sirven para listar información en orden numérico o sin un orden específico, o para hacer listados de definiciones. En el sistema wiki se pude hacer uso de las listas numeradas y las no numeradas, también se pueden hacer listas de definiciones.

Listas numeradas

Para crear listas numeradas se usa el signo número (#) contra el margen izquierdo, seguido del texto del item. <nowiki>#texto_item</nowiki>

Ejemplos:

Resultado:

Listas no numeradas

Para crear listas no numeradas se usa el signo asterisco (*) contra el margen izquierdo seguido del texto del item. <nowiki>*texto_item</nowiki>

Los items de la lista se pueden anidar aumentando la cantidad de signos número(#) como asterisco(*).

Resultado:

Listas de definiciones

Las listas de definiciones son cómodas para algunas labores, en las cuáles se tiene una palabra clave y un texto asociado a la misma. Se usa un caracter punto y coma (;) en el margen izquierdo, un espacio para la palabra a definir, un espacio ( ), dos puntos (:), un espacio ( ) y la definición en una sola línea.

Resultado: ;hacker : Una persona que logra su cometido, buscando por su cuenta con respeto por los demás. Si ve que no existe , se toma el trabajo de crear lo que sea necesario. Los hackers son reconocidos como tales por los mismos hackers. ;cracker : Una persona que generalmente busca conseguir claves de otros, irrumpir en sitios ajenos a la voluntad de las personas, que usa artimañas para contravenir licencias y los deseos de otros de forma ilegal. ;periodista : Alguien que escucha algo y lo da por cierto, pero que no se remite a las fuentes para conocer su verdadero significado. ;ignorante : Una persona que no sabe. ;tonto : Una persona que después de enterarse que puede saber, no busca los medios necesarios para aprender y que espera que los demás hagan las cosas por él. Un ejemplo es una persona que confunde los términos hacker y cracker después de haber leído estas definiciones. :P ;lagarto : Una persona que habla mucho, hace poco y queda bien ante todos en primera instancia, pero que posiblemente después de un tiempo es notada por algunos.

Tipografía monoespaciada

Para usar textos con un tamaño de anchura fija y darle mayor realce a lo escrito, se inicia el párrafo con uno o más espacios en blanco.

Ejemplo:

sintaxis: <nowiki><aquí va uno o más espacios en blanco>Texto en realce.</nowiki>

Resultado:

Línea horizontal

Para agregar una nueva línea horizontal se usa escriben cuatro (4) o más signos menos (-) sobre el margen izquierdo.

Ejemplo: Sintaxis: <nowiki>

</nowiki>

Resultado:

Mostrar código wiki

En algunos momentos necesitamos mostrar código wiki sin que el sistema wiki lo interprete (como es el caso de esta guía, en donde se muestra sintaxis wiki de ejemplo). Para este fin se debe utilizar la etiqueta nowiki

Ejemplo:

Dando formato al texto

Cursiva

Para el uso de la cursiva se escriben dos comillas simples <nowiki>()</nowiki> antes y después del texto a aplicar este formato.

Ejemplo:

Negrita

Para aplicar el formato negrita se escriben tres comillas simples <nowiki>()</nowiki> antes y después del texto.

Ejemplo:

  • Sintaxis: <nowiki>Texto en negrita</nowiki> Resultado: Texto en negrita

Usando HTML

A continuación se describen algunas etiquetas de HTML para dar forma al texto dentro del wiki. Algunos usuarios sentirán que tienen más opciones usando html directamente, aunque la sintaxis del wiki es mucho menos dispendiosa para escribir. Si usted encuentra un tutorial o un manual en español con una licencia permisiva, por favor no dude en adicionarlo a esta sección.

Tamaño del texto

Para aumentar o disminuir el tamaño del texto se utiliza la etiqueta <nowiki>font size=(+/-)#</nowiki>.

Ejemplos:

  • Para aumentar el tamaño del texto se usa el signo más (+):

    Sintaxis: <nowiki><font size=+3>Texto</font></nowiki> Resultado: <font size=+3>Texto</font> Para disminuir el tamaño al texto se usa el signo más (-):

    Sintaxis: <nowiki><font size=-1>Texto</font></nowiki> Resultado: <font size=-1>Texto</font>

Color del texto

Para darle color al texto se utiliza la etiqueta <nowiki>font color=#RRGGBB</nowiki>. La secuencia #RRGGBB significa la mezcla de colores (Rojo, verde y azul) nesarios para encontrar el color deseado, por lo general se usa en sistema hexadecimal.

Ejemplo:

  • Para darle color azul al texto:

    Sintaxis: <nowiki><font color=#0000ff>texto</font></nowiki> Resultado: <font color=#0000ff>texto</font>

Agregar imágenes

En el sistema wiki es posible agregar varios tipos de imágenes y dar algún formato a ellas. La sintaxis usada para agregar una nueva imagen es la siguiente: <nowiki>nombre_imagen_con_extensión: <opciones></nowiki>. Para poder agregar una nueva imagen se usa la opción Upload o subir del cuadro de herramientas (Está opción aparece activa dependiendo de la configuración del servidor wiki).

Las opciones disponibles son:

  • thumb: Genera una imágen en miniatura.

  • right: Alinea la imágen a la derecha.

  • left: Alinea la imágen a la izquierda.

  • px: Se modifica la anchura de la imágen en pixeles, su altura se redimensiona automáticamente, guardando las proporciones.

La forma más sencilla de agregar una nueva imagen, es escribiendo el URL completo de la imagen.

Ejemplos:

  • sintaxis: <nowiki>http://wiki.slec.net/stylesheets/images/poweredby_mediawiki_88x31.png</nowiki> Resultado: SERVER/stylesheets/images/poweredby_mediawiki_88x31.png

    sintaxis: <nowiki>SLEC.png : left</nowiki> Resultado: Muestra la imagen SLEC.png alineada a la izquierda.

Trabajando con fórmulas matemáticas

Se pueden usar algunas etiquetas básicas para crear algunas fórmulas matemáticas usando subíndices (sub) y superíndices (sup); pero si se desea realizar fórmulas más complejas se puede usar TeX markup. Leer más acerca de TeX markup.

Ejemplos:

  • sintaxis: <nowiki>x<sub>1</sub>+x<sub>2</sub>=0</nowiki> Resultado: x<sub>1</sub>+x<sub>2</sub>=0

    sintaxis: <nowiki>f(x)=2y<sup>2</sup>+y<sup>3</sup>-20</nowiki> Resultado: f(x)=2y<sup>2</sup>+y<sup>3</sup>-20

    sintaxis <nowiki><math>\int_{-\infty}{\infty}\frac{x2}{x-2}dx</math></nowiki> Resultado: <math>\int_{-\infty}{\infty}\frac{x2}{x-2}dx</math>

Aunque todavía no está activada la características de LaTeX en nuestro wiki, está en la Lista de tareas por hacer.

=Cómo crear una nueva página?= Antes de crear una nueva página debe verificar que no exista un enlace referente al tema que desea crear.

Se puede iniciar una nueva página creando un enlace interno en el sitio desde donde quiera enlazar su nueva página. Este nuevo enlace aparecerá de color rojo, lo que quiere decir que está listo para empezar a agregarle nueva información. Para iniciar la edición de la nueva página, basta con darle clic al nuevo enlace creado.

Ejemplo:

=Usando los botones de edición del wiki= Al oprimir sobre la opción edit que se encuentra en la parte superior de la página, nos encontramos con una serie de botones que nos sirven para editar rapidamente nuestras páginas. Por lo general las funciones disponibles aquí se usan primero seleccionando el texto y luego oprimiendo el botón deseado. A continuación describiremos la función de cada uno de ellos:

=Prácticas libres en WikiSLEC= Luego de haber estudiado la sintaxis necesaria para la edición del WikiSLEC, puede ingresar a la zona de prácticas libres para editar libremente y experimentar lo aprendido con esta guía.

CategoriaAyudas

SintaxisMediaWiki (last edited 2009-07-15 15:25:49 by localhost)