WikiTraba:Ajuda

Hemos hecho una pequeña ayuda que esperamos que te permita iniciarte en el mundo wiki. Para profundizar en el tema puedes consultar la ayuda oficial en inglés.

Primeros pasos

Qué significa Wiki

Wiki significa "rápido" en Hawaii.

El lenguaje wiki, una derivación simplificada del lenguaje html, permite la edición rápida de páginas web con un conocimiento básico de su sencilla sintaxis. Las páginas web realizadas en wiki rompen el esquema clásico de un WebMaster y muchos espectadores pasivos, pues permite la edición rápida de contenidos web por cualquier integrante de la comunidad.

La Wikipedia es el ejemplo más evidente de la importancia que está tomando este modelo de desarrollo de páginas web.

Porque un Wiki Funciona

FAQ:

Everybody can edit any page, this is scary. Doesn't that lead to chaos?

Answer:

1. Everybody feels that they have a sense of responsibility because anybody can contribute.
2. Any information can be changed or deleted by anyone. Wiki pages represent consensus because it's much easier to DeleteInsults and remove WikiSpam than indulge them. What remains is naturally meaningful.
3. Anyone can play. This sounds like a recipe for low signal - Wiki gets hit by the great unwashed as often as any other site - but to make an impact on Wiki, you need to generate real content. Anything else will be removed. So anyone can play, but only good players remain.
4. There's a strong commitment from the WikiCommunity to keeping the Wiki clean and nice - we all use it, so we all try to maintain it in a usable state. Also it's fun to participate, and people play nice when the game is fun.
5. Wiki doesn't work in real time. People take time to think, sometimes days or weeks, before they follow up some edit. So what people write is generally well-considered.

(quoted from WhyWikiWorks at Ward's original Wiki system, the Portland Pattern Repository, WhyWikiWorks)

Organización

La WikiTraba, como cualquier proyecto Wiki, no es más que una colección de artículos organizados en categorías. En la Portada se listan todas las categorías, dentro de las cuales se listan los artículos correspondientes. También se dispone de una caja de búsqeda de artículos en el menú de la izquierda.

Usuarios

En principio no es necesario darse de alta para editar páginas wiki. Sin embargo, es recomendable hacerlo pues permite identificar qué cambios ha realizado cada usuario, y da ciertos derechos extra como la posibilidad de subir imágenes al servidor.

Para darse de alta o identificarse hay que seguir los links de la esquina superior derecha registre/entrada, o bien utilizar la combinación de teclas

[ALT-o] (mantener la tecla ALT oprimida, mientras se teclea el caracter "o")

Sólo es necesario introducir un nombre de usuario y una contraseña.

Casa usuarios tiene una página personal, visitable en el artículo User:nombreusuario. Por ejemplo User:Acrida

Buscar artículos

Para buscar información sobre un tema en concreto podemos hacerlo mediante la caja de búsqueda del menú de la izquierda, o bien navegando a través de las categorías de la Página principal.

Modificar un artículo existente

Cualquier artículo de La WikiTraba es susceptible de ser editado por cualquier usuario identificado o no. Para ello hay que entrar en el artículo (por ejemplo en Firefox) y pulsar el botón "edit" situado en la parte superior.

A veces, si más de un Usuario editan el mismo artículo a la vez, pueden presentarse conflictos; en tal caso apareceran 2 cajas de edición, la de arriba es la que quedara grabada y la de abajo es la que contiene tus modificaciones. Bastara con copiar desde la inferior a la definitiva (la caja de edición superior) lo que acabas de editar para que queden incorporados tanto los cambios tuyos como los de los demás.

Iniciar un nuevo artículo

Lo primero es asegurarse que el tema que quiere tocarse no se refleja en ningún otro artículo, para no duplicar información. Una vez asegurado esto, se puede crear un artículo clicando sobre el enlace Nova pàgina del menú de la izquierda, y luego eligiendo el título que queremos darle. Si no te aparece el link en el menú, recarga la página sin usar el caché (en Firefox y M$IE se hace con Ctrl+F5).

Para darle una categoría y una infobox al nuevo artículo, lo más fácil es editar un artículo ya existente de la misma categoría, copiar y pegar la sintaxis correspondiente, y luego modificarla a conveniencia.

Si estás en el índice de una categoria, te aparecerá un recuadro donde podrás escribir el nombre de un nuevo artículo, y dándole a Crear ya se creará ese artículo dentro de esa categoria.

Títulos de artículo

Los títulos de artículo admiten cualquier carácter, aunque es mejor no poner acentos o espacios(aunque si son imprescindibles no pasa nada, pues los motivos son básicamente estéticos). Hay que tener en cuenta que los títulos son sensibles a las mayúsculas, así que por ejemple MediaWiki es distinto a Mediawiki. Una restricción técnica es que la primera letra la convierte siempre a mayúscula automáticamente, lo que a veces resulta molesto. En estos casos lo aconsejable es incluir el template correspondiente.

Los títulos se muestren en el encabezado de la página y también en la barra de direcciones (al final de la dirección). Algunas páginas especiales presentan un prefijo seguido de dos puntos (son los denominados namespaces). Es el caso por ejemplo de los templates o las páginas de usuario, entre otras.

Asignar artículos a categorías

Es muy importante que cada artículo esté asignado a una categoría, pues es la forma de mantener el proyecto con un cierto orden. Para hacerlo, la primera frase que hay que poner en cualquier página que editemos es:

[[Categoria:nombredecategoria]]

siendo "nombredecategoria" una categoria ya existente (en la Portada tenéis todas las categorías linkadas) o una nueva categoría. Sin embargo, antes de iniciar nuevas categorías, debería someterse el tema a discusión.

Una vez un artículo es asignado a una categoría, ya aparecerá indexado en la página de la categoría correspondiente linkada desde la Portada.

Páginas de discusión

En la parte superior de cada artículo aparece un enlace "discussion" que nos conduce a una página de discusión sobre el contenido de dicho artículo. El objetivo es el consenso, no la derrota del enemigo.

Para firmar un mensaje (cosa que queda fea en los artículos, pero está bien en las páginas de discusión), podemos usar el penúltimo botón que aparece justo arriba del recuadro donde editamos. O simplemente escribiendo [[Usuari:nombreusuario|nombreusuario]]

Tabla de contenidos

A partir de 4 títulos en un artículo, el sistema situa automáticamente al inicio un Tabla de Contenido (TOC), como sucede en este artículo. Dicha tabla contiene enlaces a cada uno de los títulos. Para forzar que se presente una TOC aunque no se llegue a los cuatro títulos, debe incluirse el texto

__FORCETOC__

donde se quiera que aparezca la tabla.

Templates

Los templates son una forma de mostrar una misma información en distintos artículos. Primero se crea el template en una página independiente (con el prefijo Template:), y luego se inserta en el lugar deseado de los artículos que se quiera (con el nombre del template enclausado en dobles corchetes: {{nombretemplate}}).

Templates básicos

Un ejemplo es el template que advierte que un artículo es incompleto. Para insertarlo en un artículo pondremos:

{{Stub}}

Lo que se traducirá en la aparición del siguiente aviso:

Aquest article està inacabat i és clarament insuficient. Si-us-plau, ajuda'ns a completar-lo o aporta idees per millorar-lo.

Otra aplicación de los templates es la posibilidad de elaborar menús navegables que agrupen varios artículos afines, como en este ejemplo.

Templates con variables

Los templates permiten la inclusión de variables para mostrar un aspecto personalizado en cada uno de los artículos donde se muestran. Debido por ejemplo a las restricciones que no permiten que la primera letra de un título de artículo sea minúscula, podemos usar el este template para indicar que en realidad el título de un determinado artículo no debería empezar en mayúscula (un ejemplo). Si editamos el template vemos que tiene un número 1 entre triple corchete, indicando que ahí irá una variable. En el artículo correspondiente incluimos el template como siempre con doble corchete, y le pasamos el valor de la variable después de una barra vertical. En este caso la variable es el nombre correcto que debería tener el artículo. Por ejemplo:

{{minuscula|aMule}}

se mostrará como:

El títol d'aquest article comença amb una lletra majúscula degut a restriccions tècniques en el software que controla la WikiTraba. El títol correcte és aMule.

Cajas de resumen (Infobox)

Un caso más complejo de templates con variables son las cajas de resumen o Infobox. Cada categoría de la WikiTraba tiene una caja de información que se presenta en cada uno de los artículos de esa categoría como una forma de resumir la información que contienen. Por ejemplo todos los artículos de la categoría Software libre presentan una InfoBox donde hay el icono del programa, el área a la que pertenecen y la página web original del proyecto (p.ej:R).

Para rellenar una InfoBox, lo más simple es editar otro artículo de la misma categoría y copiar la parte inicial donde se incluyen las variables necesarias separadas, como en el caso anterior, por barras verticales.

 {{Infobox Soft
 | nom=R
 | web=[http://www.r-project.org r-project]
 | logo=Rlogo.jpg
 | area=Estadística
 }}

Infobox del artículo de R, puede obtenerse editando el artículo y esta ubicada al comienzo del mismo.

Luego vamos al artículo que estamos creando, pegamos y modificamos los datos necesarios. En este caso las variables tienen para facilitar su edición.

Para editar el template de una Infobox, hay que ir al enlace: Template:Infobox_XXX, por ejemplo Template:Infobox_Soft. Se puede observar que se trata de una tabla convencional con variables en su interior (enclausadas en un triple corchete).

Links permanentes y citar páginas

Para tener siempre guardado un enlace a la versión que estamos visualizando de una página, podemos pulsar el link Enllaç permanent del menú de la izquierda, y copiar la dirección de la página a la que nos conduce.

Para obtener una cita de la versión que estamos visualizando de una página, podemos pulsar el link Citar aquest article del menú de la izquierda, lo que nos conducirá a una pantalla donde se presenta la cita de la página en cuestión en distintos formatos. Otra forma de hacerlo es ir a una página especial donde podremos buscar la página que queremos citar.

Mantenerse al día

Hay dos formas de conocer los cambios que se van introduciendo en la WikiTraba:

• El enlace " Canvis recents " del menú de la izquierda, que presenta los cambios que se van realizando, quién los realiza y las diferencias concretas que ha introducido. (los usuarios registrados, pueden beneficiarse de una pagina de Canvis recents que permite desplegables por temas, y otros tipos de ordenación para un mejor control de los cambios)

• Por RSS, pulsando el icono naranja que aparece en Firefox cuando se entra en " Canvis recents ", o con un lector externo si se usa M$-IE (supongo que siguiendo el link RSS o Atom que aparece en el menú de la izquierda en la página " Canvis recents ".

Sintaxis básica

La sintaxis wiki pretende ser una simplificación de la sintaxis html comunmente usada para la construcción de páginas web. A continuación se explican algunas de las características del lenguaje wiki que pueden ser útilies para la edición de artículos. Sin embargo, podemos usar también lenguaje html convencional en los artículos (por ejemplo para cambiar el color del texto, etc.). Un resumen de algunos comandos wiki está en este fichero pdf. Puedes probar la sintaxis en nuestra página de pruebas.

Títulos

Los títulos dentro de un artículo se consiguen con el signo igual:

=Título mayor=
==Título medio==
===Título menor===

Los "Títulos medio" son los estándard, como los de este ejemplo

Enlaces internos

Es fundamental que los artículos de un proyecto wiki contengan tantos vínculos a otros artículos del mismo proyecto (la WikiTraba en este caso) como sea posible, para aumentar la coherencia interna y la búsqueda de información.

Para incluir un enlace interno a otro artículo de la WikiTraba debe teclearse:

[[nombredelarticulodedestino]]

Si el nombredelarticulodedestino no existe aún, el enlace aparecerá en color rojo para indicar que es un concepto que debe ser editado porque se considera imporante pero aún no contiene información.

Si se quiere que un enlace interno muestre un texto alternativo en lugar del nombre literal del artículo de destino, debe teclearse:

[[nombredelarticulodedestino | textoalternativo]]

Nota: La barra vertical se consigue con la combinación AltGr-1.

Hay que tener en cuenta que como ya se ha dicho los títulos son sensibles a las mayúsculas, así que en los enlaces internos hay que escrbir el título exactamente igual al original. Una excepción es la primera letra, que siempre es mayúscula pero en el enlace puede ponerse en mayúscula o en minúscula. Los acentos, espacios y otros carácteres especiales pueden ponerse tal cual en el enlace interno.

Enlaces externos

Los enlaces externos son enlaces a páginas web externas a la WikiTraba, y se identifican porque presentan una doble flecha a su derecha. Para incluir un enlace de este tipo debe teclearse simplemente:

http://dirección

Si se quiere que aparezca como una cita hay que escribir:

[http://dirección]

Se observa que sólo incluye un corchete, a diferencia de los enlaces internos que incluyen doble corchete.

Un enlace como el descrito se mostrará así: [1]. Para que el enlace muestre un texto alternativo:

[http://dirección textoalternativo] 

que aparecerá textoalternativo. Se observa que en este caso, a diferencia de los enlaces internos, no es necesaria una barra vertical ( | ) cuando se quiere incluir un texto alternativo.

Si el enlace externo corresponde a una imagen (en cualquiera de sus extensiones habituales), dicha imagen va a ser mostrada en el lugar donde se inserte el enlace:

[http://dirección/imagen.jpg]

Enlaces interwiki

Una mezcla entre los enlaces internos y los externos son los llamados interwiki, que son enlaces a páginas de otros proyectos wiki. Se escriben y se muestran como los enlaces internos, pero apuntan a páginas externas a la WikiTraba. Por ejemplo para poner un link a la página Elephant de la WikiPedia podemos usar el clásico enlace externo:

[http://en.wikipedia.org/wiki/Elephant Elefante]

que se mostrará como:

Elefante

o bien usar un enlace interwiki. Para hacerlo usamos la misma sintaxis que para los enlaces internos pero usando las siglas wp correspondientes a la WikiPedia:

[[wp:Elephant|Elefante]]

que se mostrará como:

Elefante

Negrilla, subrayado, etc.

Las siguientes expresiones:

'''Texto en negrita'''
 <ins>Texto subrayado</ins> o <u>Texto subrayado</u>
 <del>Texto tachado</del> o <strike>Texto tachado</strike>
 ''Texto en cursiva''

se muestran como:

Texto en negrita
Texto subrayado o Texto subrayado
Texto tachado o Texto tachado
Texto en cursiva

Listas

Si editando utilizas asteriscos:

* item1
* item2
** item3

Obtienes listas así:

• item1
• item2
  • item3

mientras que si utilizas almohadillas:

# item1
# item2
## item3

Obtienes listas asá:

1. item1
2. item2
   1. item3

Tablas

Las tablas deben empezar con el código:

{|

y terminar con:

|}

Después del código de inicio se pueden insertar algunos parámetros de la tabla como por ejemplo el grosor del borde y la alineación de la tabla, entre muchos otros:

{|border=1 align=center

Como en el código HTML convencional, debe indicarse primero el inicio de las filas y luego el de las columnas (o más bien el de cada columna dentro de la fila en la que estamos).

El inicio de una nueva fila se indica con:

 |-

Y el de una columna con:

 |

Detrás del signo de inicio de columna se pueden especificar parámetros, como por ejemplo la alineación de la celda o comandos para la unión de filas o columnas mediante las palabras clave:

rowspan
colspan

Por ejemplo el código:

 {|border=1 align=center
 |-
 |3
 |4
 |5
 |-
 |colspan=2 align=center|8
 |9
 |} 

generará la siguiente tabla:

3	4	5
8		9

mientras que el código:

 {|border=1 
 |-
 |3
 |align=center|4
 |align=right|5
 |-
 |rowspan=2|9
 |12
 |13
 |-
 |2
 |3
 |} 

va a generar:

3	4	5
9	12	13
	2	3

Cuadros y líneas

Introduciendo un espacio antes de una línea, se consigue crear cuadros como los que se presentan en este artículo para mostrar el código wiki.

El codigo wiki se mostraria aquí

Para mostrar una línea de separación usaremos cuatro guiones:

----

que generará

---

Cómo incluir imágenes

Las imagenes pueden incluirse como enlaces externos o bien subiendo la imagen al sistema i luego creando un enlace interno de un tipo especial:

• Para subir la imagen debemos estar identificados como usuarios, y luego pulsar "Carrega" en el menú de la izquierda.

• Luego volvemos al artículo que estamos editando y situamos, donde queramos que se muestre la imagen, el siguiente texto:

[[Imatge:nombreimagen.extensión]]

Para hacerlas del tamaño que queramos, por ejemplo de 100 píxels:

[[Imatge:nombreimagen.extensión|100px]]

La alineación puede ser left, center o right:

[[Imatge:nombreimagen.extensión|100px|left]]

Para encuadrarlas:

[[Imatge:nombreimagen.extensión|thumb|100px|left]]

y para darles un texto alternativo:

[[Imatge:nombreimagen.extensión|100px|left|Este texto aparecerá debajo de la imagen]]

Para generar una tabla con varias imagenes, aunque en este caso no se puede elegir el tamaño:

<gallery>
 Imatge:nombreimagen.extensión|Este texto aparecerá debajo de la imagen
 Imatge:nombreimagen.extensión|Este texto aparecerá debajo de la imagen
 </gallery>

Puedes ver un ejemplo de todo esto.

Nota: Podemos subir imágenes svg sin problemas de compatibilidad con ciertos navegadores, pues el propio sistema las convierte a formato png para mostrarlas.

Cómo incluir videos

Se pueden subir como cualquier otro tipo de archivo, pero lo mejor para que se visualicen directamente es incluirlos desde servicios como YouTube o Google Video. Para ello, usaremos la sintaxis:

{{#ev:nombre_servicio|código_video}}

donde nombre_servicio puede ser youtube o googlevideo, y código_video el código interno del video en cada uno de esos servicios.

Por ejemplo la sintaxis:

{{#ev:youtube|5yxmTsphpjk}}

incluirá el siguiente y asombroso video:

Cómo subir otros tipos de archivos

En sus incios el software que soporta la WikiTraba sólo permitía subir archivos de imagen. Sin ambargo actualmente permite subir también otros tipos de archivo comunes (.tar.gz, .zip, .pdf, .ppt, .doc, etc.) de la misma forma que se suben imágenes, es decir a través del link del menú de la izquierda. En algunas ocasiones se pedirá que se acepte un mensaje de advertencia si el formato de archivo es poco común.

Una vez subidos los archivos, debemos incluirlos en los artículos correspondientes mediante el siguiente texto:

[[Media:nombrearchivo.extensión | nomrequequeremosqueaparezca]]

Introducir fórmulas y simbolos matemáticos

La introducción de fórmulas matemáticas se realiza mediante la sintaxis del sistema TeX. Dicha sintaxis debe incluirse entre los tags math, por ejemplo:

<math>\int_{-N}^{N} e^x\, dx</math>

que generará la siguiente integral:

$\int_{-N}^{N} e^x\, dx$

Encontrarás distintos ejemplos en esta página.

Introducir programas de R

Se pueden insertar programas (inputs) de R entre los tags:

<R>''input''</R>

y cuando se consulte la página se mostrará el output correspondiente. Por ejemplo:

<R>1:20</R>

generará:

 [1]  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20

Se puede usar cualquier función de R, de las más simples a las más complejas, incluso para generar gráficos. El output puede ser plano como en el ejemplo anterior, o más elaborado (formato html, etc.). Incluso se puede crear formularios para que el usuario introduzca uno o más parámetros.

Puedes consultar una descripción de las opciones y algunos ejemplos (esa diapo y las 3 siguientes).

Insertar un mapa

Cuando se edita una página, en la parte superior aparece el link 'make a map'. Pulsándolo aparece un mapa, centrado por defecto en el centro de Barcelona (cuidado, puede no funcionar con navegadores antiguos). Podemos desplazar el mapa manteniendo pulsado el botón izquierdo del ratón, o bien buscando el sitio concreto con el buscador. También podemos elegir el nivel de zoom y otras propiedades. Para destacar un punto, hacemos click encima suyo, le damos un nombre y apretamos 'save & close'. Una vez terminado, debemos copiar la sintaxis generada al área de edición. Por ejemplo este código:

 <googlemap lat="41.394670593198065" lon="2.1712911128997803" zoom="17" type="map">
 41.39468669015332, 2.1713125705718994, [[Usuari:Acrida|la casa del señor administrador]]
 </googlemap>

generará el siguiente mapa:

Una vez se ha insertado un mapa (por ejemplo el de La Palma), lo podemos modificar con el mismo sistema, es decir editando la página y pulsando 'make a map'. Nuevamente debemos copiar la sintaxis generada al área de edición.

Los usuarios podrán desplazarse por los mapas mostrados, modificar el tipo que desean visualizar, y pulsar sobre los puntos rojos para ver su etiqueta.

Más información sobre el uso de esta función aquí.

Añadir referencias

Se pueden añadir referencias bibliográficas a los artículos a partir de su número de identificación en PubMed (PMID) si se trata de un artículo, su número ISBN si se trata de un libro, o bien escribiendo la referencia completa a mano. Para hacerlo hay que usar los tags cite (que inserta la referencia en el sitio deseado) y biblio (que genera la bibliografía en el orden que los artículos se han citado en el texto). A continuación se muestra un ejemplo (editar para ver la sintaxis):

Aquí cito un artículo [1], aquí un libro [2] i aquí un par de artículos [1, 3]

Referencias

1. Casajuana J. [Ten minutes, less!]. Aten Primaria. 2001 Mar 31;27(5):297-8.

   el mejor artículo de la historia

2. Moyses Szklo, F. Javier Nieto. Epidemiology. Sudbury, Mass.: Jones and Bartlett, 2004. ISBN:076374722X
3. autor Titol. Ciutat, any. O el que sigui.

Nota: Las palabras clave pmid e isbn deben ser escritas en minúscula

Más opciones aquí o en la Sandbox.

Escapar la sintaxis wiki

Si escribimos una sintaxis wiki entre los tags nowiki, la sintaxis no será interpretada sino impresa directamente en pantalla (usado repetidamente en esta página).