Tutorial ArchWiki (Español)
From ArchWiki
- Este es un pequeño tutorial acerca de la edición de wikis aquí en la Wiki de Arch Linux. Para más detalles, por favor mira la Help:Editing
- Si quisiera probar la información sobre edición que se explica aquí, use por favor la caja de arena para jugar.
i18n |
---|
Deutsch |
English |
Italiano |
Polish |
Česky |
Français |
Português do Brasil |
Español |
繁體中文 |
Српски |
Русский |
Contents |
Registro e ingreso
Puede leer las páginas sin necesidad de crear una cuenta o de ingresar. Para crear una cuenta (lo cual es gratis), simplemente haga click en el enlace "crear una cuenta o ingresar" en la esquina superior derecha de cualquier página. Sólo necesita un único ingreso para todos los documentos wiki.
Editando
Como todas las wikis, puede editar cualquier página que no esté protegida. Sus cambios serán visibles inmediatamente. Simplemente haga click en el enlace "editar" que aparece en la parte superior de todas las páginas.
Explique sus cambios en la caja "Sumario" entre la ventana de edición y los botones guardar y vista previa. ej: "ortografia" o "se agregó información sobre xyz".
Use el botón vista previa para verificar la edición y corregir el formato antes de grabar. Recuerde grabar su vista previa antes de seguir adelante.
Si está logged in, puede seleccionar una edición como menor marcando la casilla Esta es una edición menor para avisar a la gente que su edición no supone un cambio sustancial.
Para probar la edición, abra una nueva ventana y vaya a la caja de arena (que es el área de pruebas de edición), y pulse el enlace "editar". Añada algo y pulse "Grabar la página".
Añadir una nueva página
Para añadir una página nueva a alguna categoría (digamos "Mi nueva página" a "Una categoría") tiene que:
- "Editar" una página con su nuevo título yendo a "http://wiki.archlinux.org/index.php/Mi_nueva_pagina"
- Añadir [[Categoría:Una categoría]] a la parte superior de la nueva página
Eso es todo. Compruebe el ArchWiki_Category_Tree como ayuda para seleccionar una nueva categoría.
Diseño básico
A pesar de que el contenido de las wikis varía entre un concepto y otro, se recomienda seguir un diseño genérico para mantener la consistencia entre todos los artículos. Lo que sigue es un buen ejemplo de cómo organizar sus artículos:
- Introducción -- Un resumen de lo que va a cubrir el artículo
- Instalación -- Donde pueda aplicarse, las instrucciones sobre cómo instalar el software
- Configuración -- Donde pueda aplicarse, cómo se configura el software una vez instalado
- Resolución de problemas -- Preguntas frecuentes (FAQ) relacionadas con el software
- Pistas y trucos -- Donde pueda aplicarse, pistas avanzadas o ejemplos de uso del software
- Más recursos -- Un buen sitio donde mencionar referencias adicionales
Por supuesto, los subtítulos pueden y deben usarse bajo cada uno de estos títulos principales. Mire Títulos y subtítulos más adelante.
Formato
La mayor parte del formato se hace normalmente con las marcas de wiki, así que no tiene que aprender HTML.
Negrita y cursiva
Puede formatear palabras o frases como negrita y cursiva usando apóstrofes ('):
- ''cursiva'' se verá como cursiva. (2 apóstrofes a cada lado)
- '''negrita''' se verá como negrita. (3 apóstrofes a cada lado)
- '''''negrita cursiva''''' se verá como negrita cursiva. (2 + 3 = 5 apóstrofes a cada lado)
Títulos y subtítulos
Los títulos y subtítulos son una forma fácil de mejorar la organización de un artículo. Si puede distinguir dos o más temas distintos, puedes partir tu artículo insertando un título para cada sección.
Los títulos pueden ser creados así:
- =Título de más alto nivel= (1 signo igual)
- ==Subtítulo== (2 signos igual)
- ===Otro nivel más abajo=== (3 signos igual)
- ====Otro nivel más abajo==== (4 signos igual)
- =====Otro nivel más abajo===== (5 signos igual)
Si un artículo tiene al menos tres títulos, se creará automáticamente una tabla de contenidos (TOC-Table Of Contents en inglés). Si no quiere que se cree una TOC, añadae __NOTOC__ en el artículo. Pruebe a crear algunos títulos en la sandbox y mire el efecto que producen en la TOC.
Indentado
Para indentar un texto, coloque el símbolo de dos puntos (:) al principio de una línea. Cuantos más símbolos de dos puntos ponga, más se indentará el texto. Un fin de línea (pulsando Enter o Return) marca el final del párrafo indentado.
Por ejemplo:
Esto es un texto alineado a la izquierda. :Esto está ligeramente indentado. ::Esto está más indentado.
se mostrará así:
Esto es un texto alineado a la izquierda.
- Esto está ligeramente indentado.
- Esto está más indentado.
Listas
Para insertar una lista no numerada, use un asterisco (*). Al igual que con la indentación, cuantos más asteriscos ponga, más indentación como subniveles.
Un breve ejemplo:
*Primer elemento de la lista *Segundo elemento de la lista **Sub-elemento después del segundo elemento *¿No es divertido?
Se mostrará como:
- Primer elemento de la lista
- Segundo elemento de la lista
- Sub-elemento dentro del segundo elemento
- ¿No es divertido?
Listas numeradas
También puede crear listas numeradas. Para ello, use el símbolo de número, hash o almohadilla (#). Usando más #s conseguirá mayor nivel de indentación.
Ejemplo:
#Primer elemento #Segundo elemento ##Sub-elemento dentro del segundo elemento #Tercer elemento
Se mostrará como:
- Primer elemento
- Segundo elemento
- Sub-elemento dentro del segundo elemento
- Tercer elemento
Código
Para añadir código a la wiki, comience cada línea con un único espacio en blanco.
Enlaces
Los enlaces son importantes en las wikis para ayudar a los lectores en la navegación del sitio.
Enlaces internos
Puede usar referencias cruzadas a páginas de la wiki usando enlaces internos. Puede añadir enlaces a títulos existentes y también a títulos que piense que puedan existir en el futuro.
Para crear un enlace a otra página en la misma wiki, ponga tan sólo el título entre dobles corchetes.
Por ejemplo, si quiere crear un enlace a, digamos, la página Wikia, eso se conseguiría con:
[[Wikia]]
Si quiere usar otras palabras distintas al título del artículo como texto del enlace, puede añadir un nombre alternativo después de un caracter de tubería (|).
Por ejemplo, si quiere crear un enlace a ArchLinux, pero quiere que aparezca como "página inicial" se escribiría:
Ver la [[ArchLinux|Página inicial]]...
Esto aparecería como:
- Ver la Página inicial
Si quiere usar el plural del título de un artículo (o añadir cualquier otro sufijo) en tu enlace, puedes añadir las letras extra fuera de los corchetes.
Por ejemplo, escribirías:
Añadir preguntas a Arch Linux para [[concurso]]s.
Se mostraría como:
- Añadir preguntas a Arch Linux para concursos.
Enlaces a secciones de un documento
Para crear un enlace a una sección de un documento, simplemente añada una almohadilla (#) seguida por el título de la sección.
[[Tutorial_ArchWiki_(Español)#Enlaces|Secciones]]
aparecería Secciones.
Enlaces entre distintos idiomas
La ArchWiki te permite escribir artículos en distintos idiomas. Como los temas pueden ser los mismos en distintos idiomas, sirve de mucha ayuda el enlazar entre ellas las mismas páginas que existen en distintos idiomas. Si un artículo existe en más de un idioma, la ArchWiki tiene una caja de internacionalización que puede añadirse al artículo que contiene los enlaces al mismo artículo en otros idiomas.
Para añadir esta caja de internacionalización a un artículo, teclea al principio de este:
{{i18n_links_start}} {{i18n_entry|Deutsch|Título en alemán del artículo}} {{i18n_entry|Français|Título en francés del artículo}} {{i18n_links_end}}
Si el título es el mismo en inglés y en el otro idioma, el título en el otro idioma será:
Título (Idioma)
Por ejemplo:
Gnome Gnome (Deutsch) Gnome (Français)
Enlaces interwiki
Se puedenn utilizar los así llamados enlaces interwiki para enlazar fácilmente con artículos de otras wikis, externas a ésta, como por ejemplo la Wikipedia. La sintaxis para este tipo de enlaces es el nombre de la Wiki seguido del símbolo de dos puntos y del artículo al que se quiere enlazar enmarcado todo ello entre corchetes dobles.
Si quiere enlazar con el artículo de Arch linux en la Wikipedia puede usar lo siguiente:
[[wikipedia:Arch Linux|Arch Linux Wikipedia article]]
Enlaces externos
Si quiere enlazar con un sitio que esté fuera de Wikicities, sól tiene que teclear el URL completo a la página con la que quiere enlazar.
http://www.google.com
Normalmente es más útil que el enlace muestre algo distinto al URL, para ello usa un corchete a cada lado, con el texto alternativo después de la dirección separado por un espacio (no un símbolo de tubería). Así, si quiere que el enlace aparezca como Motor de búsqueda de Google, teclee:
[http://www.google.com/ Motor de búsqueda de Google]
Redirecciones
Para redirigir automáticamente de una página a otra, teclee #REDIRECT y a continuación ponga entre corchetes el nombre de la página destino.
Por ejemplo, puede redirigir de "Gatos" a "Gato":
#REDIRECT [[Gato]]
De esta manera, cualquiera que teclee en la caja de búsqueda cualquiera de las dos versiones irá automáticamente a "Gato".
Peticiones
¿Necesita un "HowTo" para hacer algo? ¿Quiere saber algo? ¡Formule una petición en la página Requests de la wiki!
Variables y patrones de la Wiki
Utilice {{SITENAME}} para ver el documento actual de la wiki. Por ejemplo, {{SITENAME}} aquí muestra ArchWiki.
Puede crear también sus propios patrones. Una vez creada la página Template:XXX, al utilizar la orden {{XXX}} se incluirá ese contenido en su página de trabajo. De esta manera, si tiene algo que debe ser incluido en muchas otras páginas, podría querer usar un patrón.
Páginas de discusión
Las páginas de discusión o de "charla" están para comunicarse con otros usuarios de la wiki de Arch.
Para comentar el contenido de una página cualquiera, vaya a dicha página y haga click en la pestaña "discusión" en la parte superior de la misma. Añada un nuevo comentario al final, o inmediatamente después del comentario al que se quiera responder.
Firme sus comentarios tecleando ~~~~ para insertar su nombre de usuario y una marca de tiempo.
Use indenting para dar formato a su comentario. La práctica habitual es indentar su respuesta un nivel más que que el comentario anterior al que se hace alusión.
Haga experimentos editando la página discusión de la sandbox.
Páginas de discusión de usuario
Todo el mundo dispone de una página de discusión de usuario, en la cual otras personas pueden dejat mensajes públicos. Si alguien le ha dejado un mensaje, verá una nota que dice "Tiene nuevos mensajes", con un enlace a su página de discusión de usuario.
Puede responder en la página de discusión del usuario que le dejó el mensaje o bien en su propia página de discusión debajo del mensaje inicial. Si responde a estas personas en sus respectivas páginas de discusión, ellos asimismo recibirán notificaciones.
Categorías especiales
Existen categorías especiales para ayudar con el trabajo en la ArchWiki.
El artículo no está acabado todavía como para ser utilizable
La categoría "Stub" contiene todos los artículos que han sido marcados la bandera{{stub}}. Las razones para que un artículo pueda ser categorizado como "Stub" son:
- es demasiado corto
- no explica lo suficiente
- contiene partes inacabadas
El artículo no ha sido traducido aún
La Categoría "Solicitada traducción" contiene todos los artículos que fueron marcados con la bandera{{translateme}}. Las razones para que un artículo pueda estar en esta categoría especial son:
- existen partes en él que no están en el idioma que debería estar
- el contenido no está traducido en absoluto sino simplemente copiado desde la versión en otro idioma
- el artículo original en otra lengua fue actualizado y faltan algunos fragmentos en la página traducida
El artículo contiene información potencialmente errónea o confusa
La Categoría "Exactitud discutida" contiene todos los artículos que fueron marcados con la bandera{{accuracy}}. Las razones para que un artículo esté en esta categoría especial son:
- algún usuario observó información potencialmente errónea o confusa y se está discutiendo como solucionarlo en la propia página de discusión de la entrada en cuestión.
- la página contiene información desaconsejada o desactualizada que necesita ser revisada
Esta bandera tien una explicaión detallada en el artículo Accuracy_dispute.
El artículo es ofensivo o poco relevante
La Categoría "Para su eliminación" contiene todo los artículos que fueron marcados con la bandera{{deletion}}. Las razones para que un artículo esté en esta categoría especial son:
- algún usuario observó que es demasiado corto, escrito pobremente como para ser útil.
- no es relevante para ArchWiki
- está duplicado