Colaborar en GLASS

De GLASS

Tabla de contenidos

[editar]

Directrices básicas

Estas no pretenden ser unas directivas muy estrictas y de obligado cumplimiento sino, más bien, unas pequeñas directrices para ayudarte a colaborar en este wiki.

Así, la pincipal "regla" a la hora de añadir contenido o modificar cosas en este wiki seria la de ser respetuoso con el trabajo de los demás, tratando de ajustarte a lo que ya han escrito otros, tanto en lo que a estilo y formato se refiere, como en cuanto a contenido.

Para editar o añadir contenido al wiki es necesaro identificarse como usuario registrado.

Cuando añadas o edites contenidos, procura no dejar las cosas a medias. Utiliza para ello la opción de previsualizar para evitar publicar textos incompletos o con errores.

Antes de lanzarte a escribir, te recomendamos que leas esta sección y te des una vuelta por los diferentes capitulos que conforman GLASS. Esto te ayudara a hacerte una idea clara de cómo esta estruccturada la información y del formato utilizado en las misma.

[editar]

Creación de páginas

Antes de crear una nueva página debes seguir los siguientes pasos:

  • Búsqueda

Buscar en contenido el tema que se quiera añadir. Si éste ya existe, se revisa para posibles mejoras, o se amplia con subsecciones. En caso contrario, se añade la sección deseada al índice procurando que se aloje bajo una temática adecuada.

Es preferible añadir secciones a un tema ya existente, que abrir dos temas con el mismo asunto, ya que se estaría duplicando la información.

Nunca crearemos una pagina sin haber descartado antes por completo la posibilidad de crear una sección dentro de otra pagina.

  • Creación de la página
    • Cuando ? Sólo deberemos empezar una pagina nueva en aquellos casos que estrictamente necesarios:
      • No hay ninguna pagina en la que mi documento tenga cabida como sección
      • El documento va a ser extramadamente apmplio como para ser una simple sección de una pagina
    • Aspectoss a tener en cuenta al crear una pagina
      • Enlazarla desde la pagina principal (Portada) y desde el Índice general.
      • Escoger bien el título. Un título descriptivo facilita la búsqueda.
      • Evitar usar la palabra Howto.
      • La edición debe seguir el estilo actual del Wiki. Procura seguir los estilos ya definidos.
[editar]

Añadir secciones

Del mismo modo que cuando añadimos una pagina, al crear una nueva sección deberemos añadir un enlace a la misma desde el Índice general.

[editar]

Estilo

Esta guía no es un conjunto de Howtos.

Se trata de una guia de Administración de Sistemas GNU/Linux, sin estar orientada a ninguna distribución en especial, así que se debe evitar, en la medida de lo posible, la orientación de cualquier documento a un caso específico.

Procura ser muy descriptivo con el tema. No des muchas cosas por sentadas, cuanta más información mejor.


[editar]

Formato

El formato ya está definido. No es necesaria más inspiración.

Copia los esquemas de otras páginas y edítalas con tu contenido:

A continuación se detallan algunas etiquetas básicas a la hora de formatear el texo. Podrás encontrar una guia más completa sobre formato aquí.

[editar]

Encabezados

==Nivel 1==Encabezado de nivel 1
===Nivel 2===Encabezado de nivel 2
====Nivel 3====Encabezado de nivel 3
=====Nivel 4=====Encabezado de nivel 4
[editar]

Código o capturas de la shell

Para representar el código capturado de la shell (archivos de configuración, comandos...), tan sólo deberemos dejar un espacio en blanco al principio de cada linea. El resultado obtenido es el siguiente: 

# Si dejamos un espacio en blanco delante de cada
# Linea obtenermos esto.
[editar]

Caracteres monoespaciados

En ocasiones, nos puede interesar reslatar con tipografia monoespaciada el nombre de ficheros, paths o comandos. Para ello podemos utilizar las etiquetas <tt>Texto</tt>. El resultado obtenido es este.

[editar]

Escapar a la interpretacion como etiqueta de formato wiki

En raras ocasiones, podria ocurrir quisieramos mostrar el valor de una etiqueta wiki, en lugar de que esta fuera interpretada como tal. Para ella, podemos utilizar esta etiqueta: <nowiki>Texto</nowiki>

[editar]

Listas

Para mostrar una listas numeradas utilizaremos el caracter # y para mostrar listas no numeradas el *.

*Lista de nivel 1

**Lista de nivel 2

***Lista de nivel 3

Ejemplo:

  • Lista de nivel 1
    • Lista de nivel 2
      • Lista de nivel 3

Para más información sobre etiquetas de formato en wiki consulta este manual de MediaWiki.

[editar]

Tablas

Puedes utilizar el codigo que aparece bajo la siguiente tabla para insertar una tabla en tus documentos:

Ejemplo de tabla utilizada en GLASS
Encabezado campo 1 Encabezado campo 2
Fila 1 Columna 1 Fila1 Columna 2
Fila 2 Columna 1 Fila 2 Columna 2
Fila N Columna 1 Fila N Columna 2

El codigo par una tabla estandard como la de arriba seria este: 

{|width=65% border=1 cellspacing="0" cellpadding=9 style="margin: 1em 1em 1em 0; 
 background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; padding:10px; margin-top:12px;"
 !colspan=2|<font size="+1">Ejemplo de tabla utilizada en GLASS</font>
 |-
 !| Encabezado campo 1 || Encabezado campo 2 
 |-
 |align="center"| Fila 1 Columna 1 || Fila1 Columna 2
 |-
 |align="center"| Fila 2 Columna 1 || Fila 2 Columna 2
 |-
 |align="center"| Fila N Columna 1 || Fila N Columna 2
 |}
[editar]

Enlaces

  • Enlace a otras paginas del mismo wiki

[[Portada]] Ejemplo: Portada

  • Enlace a otras partes del mismo wiki (titulo diferente)

[[Portada|Pagina Principal]] Ejemplo: Pagina Principal

  • Enlace a una sección de la misma pagina otra pagina (titulo diferente)

[[#Formato]] Ejemplo: Salta a Formato

  • Enlace a una sección de otra pagina (titulo diferente)

[[Shell#Primeros_Comandos|Salta la sección Primeros Comandos de la pagina Shell]]

Ejemplo: Salta la sección Primeros Comandos de la pagina Shell

  • Enlaces a otras webs externas

http://www.assl-site.net Ejemplo: http://www.assl-site.net

  • Enlaces a otras webs externas (sin titulo)

[http://www.assl-site.net] Ejemplo: [1]

  • Enlaces a otras webs externas (titulo diferente)

[http://www.assl-site.net ASSL] Ejemplo: ASSL


Para más información acerca del linakado en formato wiki, consulta Links

[editar]

Iconos

En caso de querer utilizar iconos, el conjunto seleccionado es Crystal Clear de Everaldo.

Muchos de ellos ya están disponibles para referenciarlos en tus paginas sin necesidad de subirlos. Los encontraras bajo el mismo nombre pero con un añadido al inicio para refernciar su tamaño. Es decir, si el icono que queremos utilizar se llama home.png, en el wiki se llamará 48px-home.png, siempre y cuando ya haya sido subido.

Por ejemplo, para utilizar el icono que aparece a continuación, tan solo deberiamos poner [[Imagen:32px-agt_update_critical.png]] en nuestro documento. Si vemos que el lugar del icono aparece un enlace, es porque ese icono no ha sido subido aun. Para subirlo tu mismo, solo has de hacer click en el enlace y subirlo siguiendo el convenio de nombres definido anteriormente.

Imagen:32px-agt_update_critical.png Puedes utilizar un icono como este para resaltar puntos importantes en tus documentos
[editar]

Borrado y renombrado

El borrado y renombrado está limitado al grupo de edición. En caso de necesitar el borrado de alguna página, contactar con el equipo de edición.

El borrado de páginas rompe links dentro del wiki, y puede eliminar marcadores de visitantes. Así que la regla general es no borrar links a menos que se sepa que se está haciendo. Una vez dicho esto, las reglas de renombrado y borrado son:

- Una alternativa al renombre es una redirección de la página.

- En caso de eliminar/renombrar una página, se debe buscar todas las páginas que la referenciaban y modificar todos sus links. Esta tarea es obligada por la persona que borra/renombra una página.


[editar]

Comunicación

La comunicación es muy importante en cualqueir proyeto de edición colaborativa, por lo que si -tras leer estas lineas- aun tienes dudas, puedes contactar con el equipo de documentación. Para ello puedes enviar un email al wikiadmin o bien suscribirte a la lista de distribución del proyecto GLASS.

[editar]

Herramientas facilitadas por el wiki

  • Listas de seguimineto: Las listas de seguimiento permiten a los usuarios registrados ver los cambios que se han producido en aquellas páginas que han sido marcadas previamente para su seguimiento. Para marcar una página para su futuro seguimiento, tan sólo hay que pulsar sobre la pestaña vigilar que aparece en la parte superior de la página. Posteriormente, desde la sección lista de seguimiento, un usuario puede ver los cambios que se han producido en las paginas que habiamos seleccionada para ser vigiladas.
  • Paginas de discusión: Otra opción disponible para discutir sobre una página en cuestión, es dejar un comentario en el area de discusión de dicha página. Los comentarios que alli viertas servirán para debatir sobre el contenido de la página asociada.
[editar]

Herraminetas adicionales de comunicación

  • También existe una lista de correo exclusiva para GLASS.
  • Como usuario registrado del wiki, podras editar una página de información relativa a tu usuario. Pudes utilizar la misma para,si lo deseas, dejar información sobre ti: intereses, conocimientos, historial académico, forma de contacto (mail, jabber,blog etc). De esta manera, otros editores y/o visitantes podrán ponerse en contacto contigo.
Obtenido de "http://glass.assl-site.net/index.php/Colaborar_en_GLASS"
Herramientas personales