Translation(s): English - Español - Français - Indonesia - Русский

(!) Discusión

Esta página ofrece instrucciones a aquellos que desean editar el contenido de http://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 HelpContents, en el panel lateral. La referencia de sintaxis 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 por omisión en la plantilla HomepageTemplate).

Suscribirse a páginas

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 «Mail me my account data»).

Guía de estilo / WikiEtiquette

Hay al menos cinco tipos básicos de página 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 GoodStyle.

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 HelpOnLinking de moinmoin

Enlaces internos

Enlaces internos (dentro de este wiki)

  1. [[FooPage]] es la sintaxis preferente.

  2. [[PáginaPadrede/FooPage|FooPage]] se usa con frecuencia para acortar los enlaces.

  3. [[EditorGuide|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 [[PageName|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 HelpOnMacros), y use después [[#bar|Capitulo Bar]] o [[Foo#bar|Capítulo Bar]] (tomando Capítulo Bar como el título verdadero 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:

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

Disambiguation : Esta página trata acerca de Debian Conferences.
Si busca Debian configuration management system, 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 es ú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.

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.

Sección a pie de página

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

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 formato «avanzado» (usando tablas, «include», etc...)

Imágenes, multimedia y datos adjuntos

Véase también: moinmoin HelpOnLinking.

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

## attachments:
##  openlogo-100.jpg  Copyright 1999 "Software in the Public Interest" from 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 padre (en caso de que la imagen se reutilice en otras páginas). Adjunte la versión inglesa de la imagen en las páginas traducidas (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»

A tag is a WikiName that has special meaning to the community. It is used to group pages, by searching for the tag and seeing all the pages that have it. Under MoinMoin wiki, one should use Categories.

Currently used wiki tags:

  • FixMe - Here is something that needs to be fixed.

  • ToDo - Here is something that needs help to finish.

  • CleanMe - WikiTag related about last migration from Kwiki engine to current MoinMoin engine

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 el WikiTag apropiado al caso.

Estas etiquetas se han diseñado para los editores de wiki, no visitantes, así que no los haga demasiado intrusivos; 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: HelpOnPageCreation de moinmoin.

Renombrar una página

Las buenas URI no cambian.(w3). Aún así, es a veces 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 histórico de la página. En lugar de esto, use Fusionar y dividir páginas.

¡Una vez más, si hay versiones traducidas, actualícelas también!

Fusionar y dividir páginas

Reorganizar páginas es siempre una buena idea, y le animamos a ello:

Intente respetar el histórico 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 (redirige automáticamente el navegador a la página correcta).

No abuse de esta herramienta.

Ejemplo : 

#redirect DestinationPage
go to [[DestinationPage]]

Tenga en cuenta que #refresh no se ha activado en este wiki.

Véase también: HelpOnProcessingInstructions de moinmoin.

Categorías

Ayuda de moinmoin del wiki: Usando categorías.

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 Headers 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 (p. ej., «sincronizar» las versiones):

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) Si, véase TitleIndex

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 (OrphanedPages esta roto; los enlaces con la forma [[PageName|Link Label]] 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 RecentChanges (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, versión 1.7 (wiki información de configuración). Actualmente, se ejecuta en una máquina patrocinada por Dembach Goo Informatik GmbH & Co KG (hardware, alojamiento y conexión a Internet). Ac