Traducción(es): English - Español - Français - Indonesia - Русский

(!) Discusión


Esta página ofrece instrucciones a aquellos que desean editar el contenido de wiki.debian.org.

Dispone también de una Guía rápida de edición para editores noveles.

Para una información general del formato usado en el wiki moinmoin, lea las páginas de AyudaDeContenidos (en inglés) en el panel superior. La referencia de sintaxis (en inglés) es muy útil y práctica. Puede experimentar en WikiSandBox.

Si está en desacuerdo con alguna información que se muestra a continuación, escriba un comentario, e inicie una discusión en la página de discusión.

Cuenta personal

Su WikiHomePage

Puede usar la plantilla HomepageTemplate al crear una página personal. Estas son algunas ideas en cuanto al contenido, recogidas de varias páginas personales.

Asegúrese de tener la etiqueta CategoryHomepage al final de su página personal (presente de forma predeterminada en la plantilla HomepageTemplate).

Suscribirse a páginas

Puede suscribirse a las páginas relevantes a sus temas de interés.

Pérdida de contraseña

Si pierde su contraseña de wiki.debian.org, diríjase a la página recoverpass y siga las instrucciones (introduzca su cuenta de correo, después seleccione «Envíame los datos de mi cuenta»).

Guía de estilo / WikiEtiquette

Hay al menos cinco tipos básicos de páginas de wiki:

Los elementos para un buen estilo según el tipo de página se explican con más profundidad en cada página individual.

Intente ser equilibrado a la hora de escribir. Esto incluye un equilibrio visual, pero intente también evitar su predilección por una u otra cosa, sea objetivo. Si ve que sus comentarios son controvertidos, fírmelos, para que así otros se sientan más libres de mostrar públicamente su desacuerdo.

Véase también la página BuenEstilo (en inglés).

Enlaces

No abuse de los enlaces. Si hay demasiados, el lector no sabrá cuales son útiles. Puede desplazar algunos enlaces a la sección a pie de página al final de la página (una vez más, no demasiados).

Cuando el enlace apunta a una página escrita en otra lengua, añada "(en $lenguaje)", por ejemplo: ?Algo (en francés).

Véase también la sección AyudaSobreEnlaces (en inglés) de moinmoin.

Enlaces internos

Enlaces internos (dentro de este wiki):

  1. [[CualquierPágina]] es la sintaxis preferente.

  2. [[PáginaPrimariaDe/CualquierPágina|CualquierPágina]] se usa con frecuencia para acortar los enlaces.

  3. [[LaGuíaDelEditor|la guía del editor]] se puede usar para introducir el nombre del enlace dentro de una oración con palabras en minúscula.

  4. No «renombre» el enlace usando [[NombreDeLaPágina|Otro título]] (si ve necesario hacer esto, implica que la página tiene un nombre incorrecto).

En cualquier caso, asegúrese de que la etiqueta del enlace tiene sentido para los visitantes, y que el enlace no conduzca a ningún lugar inesperado (preferentemente, la etiqueta del enlace debería ser igual al título de la página, aunque esto no se aplique siempre en las páginas traducidas).

Para enlazar dentro de una página, debe definir el anclaje usando <<Anchor(bar)>> (véase AyudaSobreMacros (en inglés)), y use después [[#bar|Capitulo Bar]] o [[DirecciónDelCapítulo#bar|Capítulo Bar]] (tomando Capítulo Bar como el título del párrafo).

Enlaces a sitios externos

La manera preferente de enlazar con recursos externos es:

(Evite usar  [[http://www.foo.com|etiqueta del enlace]] , ya que esconde el nombre URL, a menos que el contexto sea claro, como por ejemplo «John Doe ofrece un script llamado test.sh»)

Use el formato InterWiki para enlazar con paquetes de Debian, fallos, RFC y artículos de Wikipedia.

Enlaces desde sitios externos

Si una página (importante) se ha enlazado desde un sitio externo a Debian, es una buena idea etiquetarla con CategoryPermalink para que así nadie la elimine inadvertidamente.

Formato

Secciones del encabezamiento

El material que pertenece al área del encabezamiento (opcional) al inicio de la página incluye:

No emplee la macro <<Include()>> en las traducciones. ¿Porqué? Porque esto sobrecargaría el servidor del Wiki si se usa en cada página. La página Frontpage es la única excepción. Para comprobar si cumple con el formato, puede consultar la plantilla predeterminada - DefaultTemplate .

A veces, el nombre de una página puede ser ambiguo. Si no lo puede evitar, inserte algo similar a lo siguiente:

Desambiguación : Esta página trata acerca de Debian Conferences.
Si busca Sistema de gestión de la configuración de Debian, véase debconf.

A menudo, el contenido de una página wiki de Debian también se trata en alguna parte de la documentación oficial de Debian (o en alguna otra ubicación a la que se hace referencia). Aún así, la página wiki puede ser útil en términos de colaboración. Una buena práctica es añadir un enlace a la documentación relacionada al inicio de la página.

Ejemplo de presentación de enlace a alguna página oficial, relacionado con el tema actual.

La licencia del logo es Portal/IDB#debian-official-doc-modif-fpiat.

Secciones de tabla de contenidos

Si una página crece demasiado, quizá desee añadir una tabla de contenidos. Véase el ejemplo al inicio de la página.

Secciones FAQ

Una sección de FAQ típica puede tener el siguiente formato:

Q. ¿Como hago XXXX?
A1) Puede hacer XXXX mediante X.
A2) Puede hacer XXXX si hace Y.

Ejemplo (observe el espacio al principio de las líneas):

 Q. ¿Como hago XXXX? :: A1) Puede hacer XXXX mediante X.
 :: A2) Puede hacer XXXX si hace Y.

Secciones a pie de página

El material que debe ir en un área (opcional) a pie de página incluye:

Puede consultar la plantilla DefaultTemplate para comprobar si cumple con el formato.

Fragmentos de página

No sólo se puede reutilizar el código, sino también el contenido de la página. Si ve que un párrafo tiene que repetirse a lo largo de varias páginas, puede reutilizar con «include» un fragmento de página cada vez. (¡No abuse de esto para evitar la reduplicación de información!).

Dispone de un ejemplo en InstallingDebianOn y InstallingDebianOn/PageFragments/Philosophy. Observe como la página está dentro de una tabla (pero no use esto para forzar las limitaciones de formato de moinmoin: véase el formato complejo).

Formato avanzado/Formato complejo

Evite usar un formato "avanzado" (usando tablas, «include», etc...):

Imágenes, multimedia y datos adjuntos

Véase también: AyudaSobreEnlaces (en inglés) de moinmoin.

Añada toda la información de los créditos y el copyright al final de la página, así como las imágenes que quiera adjuntar, ejemplo:

## datos adjuntos:
##  openlogo-100.jpg  Copyright 1999 "Software de Interés Público " de http://www.debian.org/logos/openlogo-100.jpg

Ubicación de los datos adjuntos

Es una buena idea adjuntar la imagen a la página primaria (en caso de que la imagen se reutilice en otras subpáginas). Para las páginas traducidas, adjunte la imagen en la página inglesa (imágenes internacionalizadas/localizadas se deberían adjuntar a las páginas internacionalizadas/localizadas).

Capturas de pantalla

Si desea incluir una captura de pantalla, puede que desee almacenarla en http://screenshots.debian.net/. Después, inserte esto:

Ejemplo:

Posición de la imagen

http://www.debian.org/logos/openlogo-nd-75.jpg

Es posible mover las imágenes a la derecha de la página gracias al float:right de CSS:

||<tablestyle="float:right; width:100px; background:transparent; margin: 0 0 1em 1em;" style="padding:0.5em; border-style:none;"> {{http://www.debian.org/logos/openlogo-nd-75.jpg}} ||

Etiquetas de «Necesita mejora»

Una etiqueta es un NombreWiki (en inglés) que tiene un significado especial para la comunidad. Se utiliza para agrupar las paginas, ya que al buscar la etiqueta se pueden ver todas las páginas que la tienen. Bajo MoinMoin (en inglés) wiki, hay que utilizar las Categorías.

Actualmente se utilizan las siguientes etiquetas:

Nota: no use las instrucciones de procesamiento de #deprecated, ya que impide una modificación futura de la página (p. ej., para arreglar enlaces rotos). Si necesita etiquetar una página como necesitada de mejora, use la EtiquetaWiki apropiado al caso.

Estas etiquetas se han diseñado para los editores de wiki, no para visitantes, así que no las haga demasiado intrusivas; en vez de insertar una etiqueta de aviso al inicio de la página, insértela a pie de página.

Páginas

Convenciones de los nombres URL de las páginas

Crear una página

Antes de crear una página, pregúntese lo siguiente:

Si decide continuar:

Véase también: AyudaSobreCreaciónDePáginas (en inglés) de moinmoin.

Renombrar una página

Las buenas URI no cambian (w3). Aún así, a veces es una buena idea renombrar una página cuando su nombre no refleja fielmente su contenido.

Antes de renombrar una página:

Si decide renombrar la página:

Nota: ¡Si renombrar una página requiere una página de redirección, puede que signifique que la página no se debería renombrar!

Borrar una página

Lea los consejos acerca de renombrar una página, ya que también sirven en esta situación.

Si piensa que se debería eliminar una página, puede:

No sea rudo: evite copiar y pegar el contenido de una página existente a otra nueva, para borrar después la página obsoleta. Esto provoca la perdida del historial de la página. En lugar de eso, use fusionar y dividir páginas.

¡Una vez más, si hay versiones traducidas, intente mantenerlas actualizadas!

Fusionar y dividir páginas

Reorganizar páginas es siempre una buena idea. Le animamos a:

Intente respetar el historial de la página:

Nota para traductores: si no puede fusionar/dividir páginas traducidas, añada direcciones (comentarios) en la versión traducida para que los traductores se puedan mantener al día.

Páginas de redirección

En ocasiones, puede desear crear una página de redirección (la cual, redirige automáticamente el navegador a la página correcta).

No abuse de esta herramienta.

Ejemplo :

#redirect PáginaDeDestino
go to [[PáginaDeDestino]]

Tenga en cuenta que #refresh no está habilitado en este wiki.

Véase también: AyudaEnInstruccionesDeProcesamiento (en inglés) de moinmoin.

Categorías

Ayuda de moinmoin del wiki: usando categorías (en inglés).

La lista de categorías que se emplean en este wiki: CategoryCategory.

Portales

Los portales son páginas centrales que contienen enlaces a diferentes artículos. Complementan la relación estructural que ofrece CategoryCategory y el motor de búsqueda integrado.

Los portales se deberían basar en la plantilla PortalTemplate.

Convertir una página en portal

Para convertir su artículo en un portal, añada la etiqueta CategoryPortal a pie de página y busque el portal adecuado al que añadirlo.

Evite crear portales llenos de enlaces rotos.

Base de datos de imágenes

Los iconos y logos de portal más usados se pueden almacenar en Portal/IDB. Esto es útil para portales traducidos y para dar consistencia al trabajo artístico.

Traducción

La parte superior de cada página enlaza con la versión de la misma página en otras lenguas; véase las secciones del encabezamiento y la plantilla predeterminada para ver un ejemplo.

Los principios:

Sincronizar traducciones

Cuando vaya a sincronizar una página para que coincida con otra en otra lengua:

Traductores Wiki

Las personas que participan en la traducción de las páginas de http://wiki.debian.org deberían añadir la etiqueta CategoryWikiTranslator a su página personal.

Participar en http://wiki.debian.org

Todo el mundo puede ayudar a mejorar wiki.debian.org:

Debian necesita también de gente con conocimientos no solo de informática (legales; «marketing»; organización de eventos; colecta de fondos; relaciones públicas y mucho más). Véase también http://www.debian.org/intro/help.

Promocionar wiki.debian.org

Las formas más sencillas, a la par que eficientes, de promocionar este wiki son usarlo usted mismo y hacer que sea útil a otros contribuyendo con información (tenga en cuenta las normas de contenido).

Cuando se le haga una pregunta en la lista de correos, foro, o canal IRC:

FAQ

P) ¿Puedo ver una lista de todas las páginas en este wiki?

A) Sí, véase ÍndiceDeTítulo

Q) ¿No sería más útil una wiki organizada?
A) Puede, pero una wiki estructurada es una contradicción en si misma. Importa más dotarla de información de calidad.
Q) ¿Hay manera de ver solo los artículos huérfanos (orphan)?

A) No (PáginasHuérfanas esta roto; los enlaces con la forma [[NombreDePágina|Etiqueta del enlace]] no se consideran). Pero una página huérfana es un problema sólo si hay páginas que no enlazan con ella, pero que deberían (así que los puede arreglar), o si la página no aparece en las búsquedas (asegúrese de que la página incluye las palabras clave apropiadas).

Q) ¿De qué manera puedo seguir los cambios?
A) Usando dos funciones accesibles en el menú superior:
  • El enlace a la página CambiosRecientes (limitado a una semana para visitantes, 90 dias para usuarios registrados).

  • La opción «Subscribirse», la cual demanda una notificación por correo cuando la página se ha modificado.

Información técnica

Este Wiki se ejecuta con software moinmoin (en inglés), versión 1.9 (información de configuración del wiki). Actualmente, se ejecuta en una máquina patrocinada por Dembach Goo Informatik GmbH & Co KG (incluyendo hardware, alojamiento y conexión a Internet).