Guia de ayuda

• Acerca del Swiki
• Navegando el Swiki
• Reglas de edicion
• Preguntas frecuentes

Acerca del Swiki

Bienvenido a este Swiki! Un swiki es un sitio colaborativo; donde se puede crear y modificar el contenido.

Navegando el Swiki

Si usted conoce como navegar en Internet, entonces, ya conoce como acceder a toda la informacion en este swiki.
Ademas podra:

Reglas de edicion

Un Swiki tiene reglas simples de edicion.
Para vincular una pagina, coloque el titulo de esta entre asteriscos * (ejm. *Mi Pagina*); Si no existe aun una pagina con ese titulo, un boton de creacion (create) aparecera contiguo al titulo; al presionarlo se creara efectivamente la pagina.
La lista que sigue presenta las alternativas de edicion; el conocerlas mejorara su uso de este swiki. Tambien puede comenzar a usarlo e ir aprendiendo con el uso todas las alternativas.

• Los renglones en blanco se conservan intactos.
• Los renglones que comiencen con ! se consideran titulos. A mas !, mas importancia tendra el titulo. Por ejemplo, !!titulo se mostrara como <h2>titulo</h2> en HTML. Hasta tres !s pueden ser usados.
• Los renglones que comiencen con _ (guion bajo) se mostraran como una linea separatoria. Se usan normalmente para separar secciones de un texto.
• Los renglones que comienzan con #s y -s, crean listas.
  • Un bloque de renglones contiguos, empezando con - son transformados en una lista normal.
  • Un bloque de renglones contiguos, empezando con # son transformados en una lista numerada.
  • Las listas pueden usarse una dentro de otra. Un renglon comenzando con #- sera un item resaltado en una lista numerada.
• Para crear una tabla, empiece cada renglon con | y separe cada celda con |s. Cada renglon sera tratado como una fila de la tabla.
• Para crear una seccion simple, empiece cada renglon con =. Se usara texto espaciado preservando los espacios en blanco.
• Para colocar un espacio libre (agregado a una pagina), empiece el renglon con +. Se mostrara una caja de texto, para permitir agregados en la pagina sin requerir permisos de edicion. Esto puede ser usado para no permitir el borrado de contenidos; simplemente agregue el + y "lockee" la pagina; a continuacion podran hacerse agregados sin posibilidad de borrar. Hay varias opciones para ser usadas en areas de adicion (agregue el caracter de la opcion a continuacion del + inicial):
  

  ^	El area de adicion permanecera arriba y los agregados a continuacion.
  _	(underscore) Los agregados se separaran por una linea. Util para individualizarlos.
  +	Las areas de agregado se autorreplicaran, es decir un area de agregado generara otra. De esta forma, es simple responder a un agregado anterior en particular.
  @	Los agregados seran registrados con fecha y hora. Esto facilita el seguimiento de discusiones.
  -	(signo menos) Las areas de agregado no se muestran en la pagina. Se mostrara un boton (add to the page here) que da acceso a una pagina de comentarios. Esto es util al ser usado en conjunto con auto-agregados (+ indicado arriba), Asi las areas de agregado no afectan la limpieza de la pagina.

• Para crear un link, coloquelo entre * (asteriscos).
  • Si la pagina existe en el Swiki (e.g. *Existing Page's Name*), un link a esa pagina se mostrara.
  • En caso de no existir ninguna pagina con ese titulo, el link se mostrara con un boton de agregado (create) a continuacion; presione el boton para crear una pagina con ese titulo.
  • Si el link es externo (xejm. *http://www.smalltalking.net*), se mostrara un link a la pagina externa.
  • Si el link es una imagen (su direccion termina con '.gif', '.jpeg', '.jpg', o '.png'), la imagen sera mostrada dentro de la pagina.
  • Si el link es una direccin de email (e.g. *[email protected]*), un vinculo para contactarse por email se mostrara.
  • Usted puede agregar vinculos a posiciones dentro del mismo texto marcando la posicion con una linea que comienza con @, como por ejemplo @Mi Seccion. Luego podra crear un link a esa seccion usando * y un @. O sea, *Mi Pagina@Mi Seccion* direccionara a la seccion 'Mi Seccion' dentro de la pagina de titulo 'Mi Pagina'.
  • Ud. tambien puede colocar un alias usando un >. Es decir, puede crear un link como: *Mi Alias>Mi Pagina*. El link se vera como Mi Alias, pero direccionara a la pagina 'Mi Pagina'. Para las imagenes el alias se usara como texto alternativo en el link.
• Use todo el codigo HTML que necesite. Aqui se encuentra una lista de comandos utiles:
  • Para resaltar un texto coloquelo entre <b> y </b>.
  • Para inclinar un texto coloquelo entre <i> y </i>.
  • Para subrayar un texto coloquelo entre <u> y </u>.
• Si desea colocar codigo HTML de tras fuentes dentro de su pagina... Hagalo colocandolo entre <html> y </html> y el swiki lo dejara inalterado.
• Para compartir codigo fuente en el Swiki, coloquelo entre <code> y </code> y el swiki lo dejara inalterado.
• Para hacer referencia a un documento atachado/adjunto (con la opcion [Attachments] indicada arriba), coloque el nombre entre *+ y +*. Por ejemplo, *+miArchivo.html+* creara un link al archivo atachado de nombre 'miArchivo.html'. Si el archivo es una imagen se mostrara incluida de la pagina.
• Existen tres caracteres (&, <, >) que tienen un "significado especial" en HTML. El Swiki agrega a estos dos mas (*, @). Para poder mostrar estos caracteres en un texto, debera usar un alias. He aqui la tabla de alias a ser usada para mostrar caracteres especiales:
  

  &	se correspone con	&
  <	se correspone con	&lt;
  >	se correspone con	&gt;
  *	se correspone con	&star;
  @	se correspone con	&at;

  Estos alias deben usarse tambien en los titulos.

Preguntas frecuentes

• Como creo una pagina nueva?
• Como borro un archivo atachado?
• Que es un conflicto de edicion (Edit Conflict) y que debo hacer en ese caso?
• He estropeado incidentalmente una pagina. Como puedo arreglarla?
• Porque no se me muestra una imagen en la pagina?
• Como coloreo un texto?
• Como puedo centrar un texto?

Como creo una pagina nueva?

Posicionese en una pagina desde donde desea que su nueva pagina este accesible. Edite esa pagina. Coloque en el texto un link a la nueva pagina, por ejemplo: *Mi Nueva pagina*. Cuando guarde la pagina, un boton de creacion de link (create) aparecera junto al texto Mi Nueva pagina. Presionelo para crear su pagina nueva. De esta forma usted creara la pagin ay asegurara que esta disponible desde la pagina que edito.

Como borro un archivo atachado?

La respuesta corta es no es posible. Lo que usted puede hacer es guardar un archivo con el mismo nombre con el contenido correcto. Si efectivamente necesita borrarlo consulte a quien mantiene el servidor donde esta el Swiki.

Que es un conflicto de edicion (Edit Conflict) y que debo hacer en ese caso?

Un conflicto de edicion ocurre cuando el servidor detecta que la pagina que usted desea cambiar ha sido cambiada por otra persona al mismo tiempo. Si usted guarda sus cambios se perderia el aporte de la otra persona. En ese caso se le mostraran ambas versiones y usted podra compaginar la pagina conteniendo ambos contenidos (esto debera hacerlo manualmente). Los conflictos de edicion son muy poco frecuentes. NO use el boton de vuelta atras cuando esto le ocurra, pues segun el modelo de interfaz de web, su informacion puede perderse si lo hace.

He estropeado incidentalmente una pagina. Como puedo arreglarla?

Cada version de una pagina es guardada. Estando en la pagina estropeada, use la opcion de "historia". Busque la ultima version en al que la pagina estaba bien. Ahora entre a editar la pagina en otra ventana, y copie el contenido de esta version en la pagina actual. Guarde la pagina corregida.

Porque no se me muestra una imagen en la pagina?

Hay varias situaciones en las que puede ocurrir esto. Asegurese que la iamgen esta en el formato correcto (GIF, JPEG, o PNG); otros formatos como (BMP, PDF, pict) no son soportados. Verifique ademas que el archivo tiene la extension correcta ('.gif', '.jpeg', '.jpg', o '.png') de no ser asi el servidor no la considerara una imagen; Tenga en cuenta que no es posible cambiar el formato de una imagen cambiandoi solamente la extension de su archivo.

Como coloreo un texto?

Es posible usando HTML. Una forma comun es usando el tag FONT. Por ejemplo, usted puede colorear su texto de verde colocando <font color="green">mi texto verde</font>.

Como puedo centrar un texto?

Coloque lo que desea centrar entre <p align=center> y </p>.

El Swiki ha sido construido usando Squeak, un Smalltalk con licencia liberal. La fuente de inspiracion fue el WikiWikiWeb de Ward Cunningham (Squeak + Wiki = Swiki). La forma en que esta construido es obra de Mark Guzdial del Laboratorio de Software Colaborativo, Instituto de Tecnologia de Georgia.