Ayuda:Cómo se edita una página

De doc.ubuntu-es
(Diferencias entre revisiones)
Saltar a: navegación, buscar
(corrijo toc)
(Modifica: añado imagen)
Línea 224: Línea 224:
 
Modifica sin miedo pero justificadamente.  
 
Modifica sin miedo pero justificadamente.  
 
* Es mejor no poner nada que un '''dato erróneo'''.
 
* Es mejor no poner nada que un '''dato erróneo'''.
* Pon un '''resumen''' (al lado de grabar): ahorrará tiempo a los bibliotecarios y quedará en el historial de la página.
+
* Pon un '''resumen''': ahorrará tiempo a los bibliotecarios y quedará en el historial de la página.
 +
El resumen de edición es un pequeño resumen de la edición que has hecho, y se pone en el recuadro que aparece en la página de edición, tal que así:
 +
[[Imagen:Resumen.png]]
 
* No '''borres''' nada si no has comprobado antes que era erróneo.
 
* No '''borres''' nada si no has comprobado antes que era erróneo.
  

Revisión de 22:28 16 feb 2008

Es muy fácil editar una página. Simplemente haz clic en la pestaña «editar» ubicada en la parte superior de todas las páginas del wiki (o haz clic en el enlace «editar» ubicado al inicio de cada sección). El hacer esto te llevará a una página con una caja de texto que contiene el texto editable de esa página. Ponte a escribir, y presiona Mostrar previsualización cuando estés listo. Revisa si ha quedado bien, corrige lo que esté mal o no te guste hasta que quede bien. Cuando estés satisfecho guarda tu edición pulsando Grabar Página. Los cambios que realices será inmediatamente visibles para otros usuarios.

Enlaces internos

Digamos que estás corrigiendo una página sobre administración de sistema, y mencionas instalar aplicaciones. Bien, probablemente hay una página de Wiki sobre como instalar aplicaciones (y si no la hay, debería haberla) y deseas hacer que la palabra sea una conexión a ese artículo. Simple: agrega corchetes dobles alrededor de ella [[como esto]] y continúa corrigiendo. También puedes seleccionar la palabra y pulsar el botón Ab. ¡Eso es todo! Si ya existe el artículo se creará un enlace —en azul— que abrirá dicho artículo. Si aún no existe, se creará un enlace —en rojo— que permitirá que alguien lo cree (al hacer clic en él se entra en la caja de edición directamente). Agrega los enlaces que creas necesarias, pero recuerda enlazar sólo la primera aparición de un término en un artículo.

Clip.png Hay algunas reglas sobre la creación de estas conexiones. El software MediaWiki considera el título de página enlazada igual al texto de su enlace, excepto que la primera letra será mayúscula. Por ejemplo, si escribes [[ejemplo de página]], se crea una conexión a la página titulada «Ejemplo de página».

Por último: a veces el texto que te gustaría convertir en un enlace simplemente no es un buen título de página. En ese caso puedes especificar ambos en los corchetes utilizando una barra vertical para separar como en como instalar un programa -> [[Instalar aplicaciones|como instalar un programa]]. Esto aparecerá como «como instalar un programa», aunque el enlace apuntará en realidad a «instalar aplicaciones».

Enlaces dentro de la misma página

También puedes hacer enlaces a una sección de la página que estás editando. Es igual que un enlace interno de wikipedia, pero en lugar de poner el nombre del artículo se pone el nombre de la sección precedido de # así: [[#sección|sección]] (si no pones |sección el enlace aparece con una fea #). Por ejemplo, el siguiente enlace va a la sección llamada enlaces internos. También se puede utilizar #top, el cual te subirá a la parte superior de la página (compruébalo aquí)

Enlazar imágenes

Edita el artículo correspondiente y crea el siguiente enlace:

[[Imagen:Nombre del archivo|Texto alternativo]]

Puedes hacerlo con el botón de imágenes que aparece en la barra de botones que está encima de la caja de edición (aunque es posible que no aparezca en tu navegador). Selecciona el nombre del archivo y el texto alternativo —separados por una barra |— y pulsa el botón. Escribirá [[Imagen por delante y ]] por detrás.

«Nombre_del_archivo» es el nombre que tiene la imagen incluyendo su extensión, la cual se usa para indicar el formato de la imagen agregada (.jpg, .png, etc.).

El «Texto alternativo» debería contener una breve descripción de la imagen, o un epígrafe. Este texto se presenta en un texto flotante o si la imagen no se carga. Es también importante para las personas ciegas que usan lectores de pantalla o para los navegadores basados en texto]].

Sólo falta refrescar la página correspondiente para comprobar el enlace. Recuerda respetar las mayúsculas y minúsculas en el enlace de la imagen.

Subir imágenes

No abuses de la subida de imágenes, puede sobrecargar el servidor. Para subir imágenes, ve a Subir archivo en menú herramientas del lateral iaquierdo, en Nombre de Origen, dale a selecionar y escoje de tu disco duro la imágen que quieres subir. En Nombre de destino, puedes poner el nombre original o utilizar un nombre distinto. Utiliza siempre nombres descriptivos de la imágen (nada de 39fk4.png). En descripción, puedes añadir un comentario si lo crees necesario acerca de la imágen. Cada imágen tendrá su propia página donde se incluirá su descripción y otros aspectos. Dale a Subir el archivo y en pocos segundos tendrás tu imágen disponible con el código [[Imagen:Nombrearchivosubido]]. No olvides poner la extensión.

Enlaces externos

El wiki detecta automáticamente los enlaces externos que empiecen por http://. Por ejemplo, un enlace a otra web: http://www.gnu.org

El mismo enlace se puede hacer poniendo dentro de los corchetes tanto la dirección web como el título del enlace, separadas por un espacio. Este ejemplo: Página principal de GNU, se ha conseguido de esta manera: [http://www.gnu.org Página principal de GNU]

Redirecciones

Si deseas redireccionar el tráfico de una página hacia otra (alguna con un mejor título, por ejemplo), puedes usar el comando "#REDIRECT: [[nombre de página]]" al comienzo de la descripción de la página.

Cómo crear una nueva página

Básicamente hay dos formas:

  1. Mientras editas el texto de una página existente puedes poner algo entre corchetes como, por ejemplo, [[mi página]]. Cuando guardes la página que estás editando aparecerá un enlace a una página que no existe (en rojo). Pulsa sobre él e irás a una nueva página que puedes editar. Reemplaza el texto "Escribe aquí el contenido de la página" con el texto que desees.
  2. Teclea el título de tu nueva página precedido de la cadena "http://doc.ubuntu-es.org/" en el campo "URL" de tu navegador y pulsa la tecla Enter. Si todo resulta bien, llegarás a una página nueva con el título que usaste y podrás empezar a editarla.

El modo recomendado es el primero. Se recomienda esto para que las páginas no queden sueltas, sino que haya algún vínculo hacia ellas y sea más fácil que el usuario las encuentre, incluso que las visite aunque no haya planeado hacerlo.

Algunas recomendaciones

Cómo escribir con formato en una página

A continuación hay varias secciones para demostrar los diversos efectos posibles usando el Wiki, tales como negrita, itálica/cursiva, listas numeradas, etc.

Pulsa en la pestaña editar de esta página (¡la que estás leyendo ahora!) para ver cómo se consiguieron estos efectos. Si no pulsas en editar no entenderás lo que ha pasado.

Sangrado de párrafos

Esta línea está sangrada (se pone dos puntos [:] al inicio de línea)
Ésta lo está todavía más (se ponen dos caracteres de dos puntos [::] al inicio)
¿Quién sabe hasta dónde podríamos llegar? (se ponen tres signos de dos puntos [:::] al inicio)
Esta línea se ha sangrado usando un espacio inicial (repetidamente)
              pero como no se han usado los dos puntos (:)
     al comienzo de la línea, aparece como una fuente monoespaciada
 generándose, además, el recuadro punteado.

Secciones

Puedes estructurar una página en secciones. Para ello sólo tienes que poner el título de la sección entre signos = (= así =). Los espacios entre los signos de = y el título no se tienen en cuenta, es igual poner =esto= que = esto =

El número de = define el nivel de jerarquía de la sección, veámoslo con un ejemplo:

=Sección 1=
==Sección 1.1==
=Sección 2=
==Sección 2.1==
===Sección 2.1.1===
===Sección 2.1.2===
==Sección 2.2==
=Sección 3=

El número de = también afecta al formato del título de la sección. No se debe empezar por el nivel 1, ya que se muestra igual que el título de la página. Esta misma página empieza por el nivel dos.

Si quieres hacer un enlace a una sección, pulsa aquí para ver cómo hacerlo.

En las secciones suele aparecer un pequeño enlace [editar] en la esquina superior derecha, para editar sólo esa sección. Así, cuando alguien necesite corregir un pequeño detalle de esa sección (una falta de ortografía, por ejemplo), no necesitará recorrer todo el código para encontrarlo. En el caso de que, por tener la página un diseño especial, no convenga que aparezcan esos enlaces, puedes eliminarlos poniendo __NOEDITSECTION__.

Tipos de letra

Esta línea está en cursiva (Usando la comilla simple dos veces, es decir, ''así'').

Y ésta también (Usando la etiqueta HTML <i>: <i>ejemplo</i>).

Cualquiera de ellas sirve pero se aconseja usar el estilo wiki ('').

Más cómodo es seleccionar el texto que quieras poner en cursiva y pulsar el botón I.

Esta línea está en negrita (Usando la comilla simple tres veces, es decir, '''así''').

Al igual que ésta (Con etiquetas HTML <b>: <b>ejemplo</b>).

Como en el caso de la cursiva, se aconseja el método wiki. Lo puedes hacer fácilmente seleccionando el texto y pulsando el botón B del editor. Para que aparezca texto en fuente monoespacio, por ejemplo para escribir elementos de código que quieras separar del resto de la explicación, debes utilizar los elementos HTML <tt> o <code> (<code> además resalta el texto levemente mediante un color de fondo).

Para escribir en una fuente que no sea Arial (predeterminado) o Courier New (códigos fuente, etc.) hace falta escribir una etiqueta HTML. La más sencilla, <font face="Times New Roman">lo que se quiera poner</font>, aunque teniendo en cuenta que el elemento HTML font ha sido desaconsejado en los nuevos estándares sería mejor que utilizases <span style="font-family:'Times New Roman'">aquí el contenido</span>

Listas

Las listas numeradas se escriben utilizando la sintaxis “#texto”, con el “#” pegado al margen izquierdo. Este es un ejemplo de una lista numerada:

  1. Ítem 1
  2. Ítem 2
    1. Se pueden anidar poniendo dos “#” seguidos.
  3. Ítem 3
#Nota, esta línea no está numerada porque no está alineada a la izquierda.

Las listas no numeradas se realizan utilizando la sintaxis “*texto”. Aquí está una lista no numerada:

  • Un punto
  • Otro punto
    • Podemos tener también sublistas (usando varios * seguidos)
      • Y seguir, y seguir...

Las listas de definición se generan empezando la línea (sin espacios antes) con el signo de punto y coma (;). El resto de elementos de la lista se generan poniendo el signo de dos puntos (:) ya sea en la misma línea del título de la lista de definición si sólo pones un elemento o en una nueva línea (pero sin dejar ninguna línea de espacio entre ellas). Tenlo en cuenta por si necesitas incluir los dos puntos como signo de puntuación dentro del título de la lista, pues tendrás que sustituirlos por su codificación en HTML que es &#58;:

Este es el título de la lista de definición 
Este es un elemento.
este es otro elemento.
y este otro.

Mostrar código

Hay tres formas de mostrar código:

  1. Usar la etiqueta <nowiki>. Esta línea es un ejemplo con la etiqueta <nowiki>; se pueden usar signos >, < y & libremente.
  2. Usar la etiqueta <code>. Esta línea es un ejemplo con la etiqueta <code>.
  3. Usar la etiqueta <pre>.
Esta línea es un ejemplo con la etiqueta <pre>.

La diferencia entre <code></code> y <pre></pre> es que la etiqueta pre preserva los saltos de línea, mientras que la etiqueta code no lo hace. Además, el formato de pre es distinto.

La utilidad de nowiki es poder insertar caracteres que no sean interpretados como código wiki, pero conservando el estilo de párrafo y el tipo de letra del texto; se ha usado en esta página por ejemplo para mostrar cosas como [[ésta]] sin crear un enlace wiki. Una forma cómoda de usar <nowiki> es seleccionar el código que quieras mostrar y pulsar el botón Button nowiki.png

Tablas

Hay dos modos de crear tablas:

  • Con marcas especiales del wiki Ayuda:Tabla
  • Con los elementos habituales de HTML: <table>, <tr>, <td> o <th>.

En este wiki preferimos el uso de marcas wiki. Si encuentras alguna tabla hecha con tags de html, puedes trasformarla usando este conversor automático

Leyenda
Encabezado 1 Encabezado 2 Encabezado 3
celda 1 celda 2 celda 3
celda 1 celda 2 celda 3

Éste es un ejemplo de tabla flotante mediante marcas wiki:

Cuyo código es:

{| border="1" style="float: right; margin: 0 0 1em 1em;"
|+ Leyenda
! Encabezado 1 !! Encabezado 2 !! Encabezado 3
|-
| celda 1 || celda 2 || celda 3
|-
| celda 1 || celda 2 || celda 3
|}

También se puede dar formato más sobrio con el uso de plantillas o clases.

Encabezado 1 Encabezado 2 Encabezado 3
celda 1 celda 2 celda 3
celda 1 celda2 celda 3
{| class="wikitable" align=right
!Encabezado 1!!Encabezado 2!!Encabezado 3
|-
|celda 1||celda 2||celda 3
|-
|celda 1||celda2||celda 3
|}

Algunos consejos

Practica editando en zona de pruebas.

Prohibido

  • La propaganda: éste es un trabajo desinteresado y gratuito hecho con esfuerzo y no lucrativo.
  • El insulto, por razones obvias. Somos muchos con historias, vivencias, cultura y lugares diferentes... y distintas ideas.
  • La copia. No se puede copiar ni textos ni imágenes si tienen derechos de autor a menos que estos mismos derechos autoricen tal copia, y su modificación y redistribución de manera compatible con la licencia del wiki.
  • Firmar los artículos. Sí deben firmarse los comentarios que se escriban en las votaciones y en la discusión de artículos y de páginas de otros usuarios.
  • En imágenes las notas de copyright, autorización, autoría y enlaces de los pies de foto.

Evita

Escribir:

  • «Actualmente», pues pasado un tiempo queda obsoleto. Es mejor poner la fecha. Ejemplo: sustituir "La moneda actualmente es el euro" por "desde 1999 la moneda es el Euro".
  • «Ahora»: tal vez mañana ya no lo sea.
  • Comparaciones: "Las mejores playas del mediterráneo" (Casi seguro que esto no sea cierto o cuanto menos sostenible en el tiempo).
  • Exageraciones: "Podemos ver todas las aves" (algunas faltarán).

Modifica

Modifica sin miedo pero justificadamente.

  • Es mejor no poner nada que un dato erróneo.
  • Pon un resumen: ahorrará tiempo a los bibliotecarios y quedará en el historial de la página.

El resumen de edición es un pequeño resumen de la edición que has hecho, y se pone en el recuadro que aparece en la página de edición, tal que así: Resumen.png

  • No borres nada si no has comprobado antes que era erróneo.

Para una información más detallada, consulta http://es.wikipedia.org/wiki/Wikipedia:Cómo_se_edita_una_página

Fuentes

Wikipedia:Cómo se edita una página.

Herramientas personales