From Mageia wiki
Jump to: navigation, search



Introducción

El objetivo de esta página es ayudarle en la escritura, la modificación o la traducción de las páginas del Wiki de Mageia. Es preferible ser parte del equipo de documentación de Mageia. Mageia utiliza el wiki para cubrir tres necesidades:

  1. Ayudar a los equipos a coordinar sus acciones (informes, planificación, normas, listas de tareas a realizar, etc.). Todas estas páginas pertenecen a la categoría “Doc”.
  2. Dar informaciones sobre los versiones de Mageia a todos los usuarios finales. A menudo, son las erratas y las notas de versiones que pertenecen a la categoría “Mageia n”, por ejemplo Erratas de Mageia 6
  3. Dar documentación complementaria a los usuarios finales. Todas estas páginas pertenecen a la categoría “Documentation”.

Por el momento, el wiki esta en su mayoría en inglés, sin embargo, se añadirá una función multilenguaje, (ver abajo la sección, por escribir).

Requerimientos

Generalidades

Para escribir, modificar o traducir páginas en el Wiki de Mageia, siga estas sencillas reglas.

  1. Crear una cuenta aquí para obtener los derechos
  2. Unirse al equipo de documentación de Mageia
  3. Suscribirse a la lista de correo doc-discuss@ml.mageia.org explicando lo que quiere hacer. Es la mejor manera de coordinar nuestras acciones, compartir nuestras ideas y recibir ayuda. Puede usar el IRC #mageia-doc en Freenode (in inglés).
  4. Se le sugiere prestar atención a su estilo de escritura, su ortografía y su sintaxis. No tenga miedo de pedir ayuda si es necesario, no mordemos.
  5. Prestar atención a la disposición. Las capturas de pantalla deben ser legibles sin ser demasiado grandes (600 px es generalmente suficiente).
  6. Leer y cumplir con la Codigo de Conducta de Mageia.

Para qué sirve el Wiki

  • Es una documentación colaborativa de buena cualidad sobre los proyectos de Mageia:
    • Difundir el proyecto Mageia, su espíritu y sus objetivos, los equipos y los procesos internos,
    • Ofrecer una clara documentación sobre el desarrollo de las instalaciones/migraciones y ayuda para configuraciones de pequeñas y grandes infraestructuras informáticas,
    • Documentar las herramientas y las programas entregados o que pueden ser instalados en Mageia,
  • Explicar la arquitectura de la comunidad; permitir el acceso a la ayuda para los contribuidores y permitirles unirse a la comunidad, así como participar fácilmente de acuerdo con sus habilidades y necesidades.
  • Artículos con informaciones útiles y trucos.
  • Escribir para todos: usuarios finales, usuarios avanzados y administradores.
  • Para aplicaciones de escritorio o servidor.
  • Para la comunidad.

Para qué no sirve el Wiki

  • Duplicar información ya existente como:
  • Un sitio de alojamiento para las paginas de proyectos individuales,
  • Una F.A.Q., página de preguntas y repuesta o cualquier otro tipo de soporte (consulte el sitio oficial o los sitios dedicados para acceder a estas herramientas),
  • Documentación online o documentación offline.

Presentación de una página Wiki

Sin estar conectado

Así luce la pagina antes de ingresar:

Wiki-es-1.png

Descripción:

  1. La página del Wiki en sí,
  2. La página de discusión, donde los contribuidores pueden explicar sus trabajos, compartir ideas y resolver problemas,
  3. Pestaña de lectura,
  4. Ver el lenguaje utilizado par crear la página,
  5. Una lista cronológica de todos los cambios, le permite cancelarlos,
  6. Se necesita estar conectado al wiki para hacer estos cambios,
  7. El motor de búsqueda wiki
  8. En esta caja de herramientas, el enlace “Páginas especiales”, es interesante, le da estadísticas y el enlace “Categorías” da todas las categorías (ver abajo como añadir categorías a una página).

Estando conectado

Después haber entrado tu nombre de usuario y contraseña, nuevas herramientas estarán disponibles:

Si no ha cambiado sus preferencias de idioma.

Wiki-es-2.png


Si cambio sus preferencias de idioma

Wiki-es-2-1.png


Descripción:

  1. Opciones de configuración. <login> (aquí Cmoifp), es tu página de usuario, un lugar donde puedes presentarte. Puede también servir como página para probar tu trabajo en el wiki. "Talk"/“Discusión” es la página de discusión de tu propria página. "Preferences"/“Preferencias” es la pestaña que te permite de personalizar la interfaz (es decir, el idioma preferido). Las otras pestañas no necesitan explicaciones.
  2. Lista desplegable con dos opciones: “Mover” o “Vigilar/No vigilar”.
  3. En la Herramienta, "Upload files"/“Subir archivos” para subir archivos (generalmente imágenes o capturas de pantalla) en el wiki. Es muy importante de leer lo que dice esta página.

Sintaxis principales

Generalidades

Aquí están los comandos básicos para iniciar una página y/o hacer pequeñas modificaciones. Para mas informaciones, los enlaces abajo y motores de búsqueda son tus amigos. Te recordamos que el wiki funciona con MediaWiki.

Títulos

En nuestro wiki, el nombre de la página aparece automáticamente como título de la página (actualmente como “Wiki > Nombre de página”). Sin embargo, si deseas un título (algo) diferente), limite el uso del párrafo de 1er nivel “=” sólo al título de la página. En este caso, utilices los títulos de 2do nivel “==” y posteriores, para el contenido de tu página en lugar del primer nivel “=” y posteriores. Es tu criterio el utilizar o no un espacio blanco entre las etiquetas y el contenido. El wiki ignorará los espacios al presentar una página.

Lo que escribe Lo que obtiene
= Título primer nivel = Título primer nivel
== Título segundo nivel == Título segundo nivel
=== Título tercer nivel === Título tercer nivel
==== Título cuarto nivel ==== Título cuarto nivel
===== Título quinto nivel ===== Título quinto nivel
====== Título sexto nivel ====== Título sexto nivel

Dar formato al texto

Notepad.png
¡Recuerde esto!
Hay un formato especial para comandos, menús, paquetes, programas y archivos.


Lo que escribe Lo que obtiene
' 'itálica' ' itálica
' ' 'negrita' ' ' negrita
' ' ' ' ' itálica y negrita' ' ' ' ' itálica y negrita
tags <s> y </s> para tachar el texto tags <s> y </s> para tachar el texto
{{cmd|nombre del comando}} nombre del comando
{{menu|menú -> submenús }} menú -> submenús
{{file|nombre del archivo}} nombre del archivo
{{pkg|nombre del paquete}} nombre del paquete
{{prog|nombre del programa}} nombre del programa
<pre> texto en modo de presentación</pre>
  texto en modo de presentación

Las líneas
:pueden ser
::sangradas
:::sobre varios niveles

Las líneas

pueden ser
sangradas
sobre varios niveles
<span style="color: red;">texto en color rojo</span> texto en color rojo
<span style="color: blue;">texto en color azul</span> texto en color azul
<span style="color: green;">texto en color verde</span> texto en color verde
<span style="color: orange;">'''texto negrito en color naranja'''</span> texto negrito en color naranja
<span style="color:#FF00FF;">texto en cualquier color</span> texto en cualquier color
Insertar la etiqueta derecha <br> para obtener un salto de línea Insertar la etiqueta derecha
para obtener un salto de línea

Enlaces y anclas

Lo que puede hacer Lo que escribe Lo que obtiene
Enlazar una pagina del wiki de Mageia (e.j.: la pagina de bienvenida).
(1) Sin nombre
(2) Con el nombre "Bienvenido"

[[Main_Page]]
[[Main_Page|Welcome]]

[1]
Bienvenido
Enlazar una URL (e.j.: La documentación oficial de Mageia.).
(1) Sin nombre
(2) Con el nombre "Documentación"

[http://www.mageia.org/fr/doc/]
[http://www.mageia.org/fr/doc/ Documentation]

[2]
Documentación
Añadir un ancla llamada "ancla1" a la palabra "texto" un <span id="ancla1">texto</span> dentro de la pagina un texto en la pagina
Crear un enlace a "ancla1" presione [[#ancla1|aquí]] para ir a ancla1 presione aquí para ir a ancla1
Crear un enlace a la ancla "Hardware" de la pagina "Documentation" del wiki vea [[Documentation#Hardware|aquí]] vea aquí

Listas

Lo que escribe Lo que obtiene

* lista sin orden, primer linea
* lista sin orden, segunda linea
** lista sin orden, tercer linea
** lista sin orden, cuarta linea

  • lista sin orden, primer linea
  • lista sin orden, segunda linea
    • lista sin orden, tercer linea
    • lista sin orden, cuarta linea

# lista ordenada, primer linea
# lista ordenada, segunda linea
## lista ordenada, tercer linea
## lista ordenada, cuarta linea
##* quinta linea dentro de la cuarta
# regreso a la lista ordenada

  1. lista ordenada, primer linea
  2. lista ordenada, segunda linea
    1. lista ordenada, tercer linea
    2. lista ordenada, cuarta linea
      • quinta linea dentro de la cuarta
  3. regreso a la lista ordenada

Tablas

Hay muchas opciones en MediaWiki para dibujar tablas (vea esta pagina para más información). Sin embargo, para una tabla sencilla, puede usar el siguiente ejemplo.

  • En la primer linea, cambie el "1" en "border=" por el grosor de borde que quiera (en pixeles), cambie "center" por "left" o "right" (sin las ") y cambie "800" por el ancho deseado.
  • En la segunda linea, puede incluir de forma opcional titulos de columna, separados por "!!".
  • En el resto, añada o elimine celdas de la tabla (denotedas con "|"). "|-" se utiliza para crear el renglón actual.

Lo que escribe (puede copiar/pegar para crear una tabla en su pagina):

{|border="1" class="wikitable" style="text-align:center; width:800px;"
! Primer Columna!! Segunda Columna!!Tercer Columna
|-
|columna1 - cellda1
|columna2 - cellda1
|columna3 - cellda1
|-
|columna1 - cellda2
|columna2 - cellda2
|columna3 - cellda2
|-
|columna1 - cellda3
|columna2 - cellda3
|columna3 - cellda3
|}

Lo que obtiene:

Primer Columna Segunda Columna Tercer Columna
columna1 - cellda1 columna2 - cellda1 columna3 - cellda1
columna1 - cellda2 columna2 - cellda2 columna3 - cellda2
columna1 - cellda3 columna2 - cellda3 columna3 - cellda3

Imágenes

Notepad.png
¡Recuerde esto!
Las capturas de pantallas no deben tener mas de 800px.


Lo que escribe Lo que obtiene
[[image:wiki3.png]] Wiki3.png
[[image:wiki3.png|100px]] Wiki3.png
[[image:wiki3.png|center|100px]] Wiki3.png
[[image:wiki3.png|right|80px]] Wiki3.png
[[image:wiki3.png|center|100px|thumb|none|Leyenda aquí]]
(Sin el opción "none", el texto se distribuye alrededor de la imagen.)
Leyenda aquí


Plantillas

Entre otras cosas, las plantillas se puede utilizar para destacar algo importante. Las plantillas le permitirán hacerlo de forma rápida y consistente.

Notepad.png
¡Recuerde esto!
Para escribir una nota, escriba {{note-es|Texto ...}}



Warning.png
¡Advertencia!
Para escribir una advertencia, escriba {{warning-es|Texto ...}}



Dragon.png
¡Mucho cuidado!
Para dar un truco, escribe {{dragons-es|Texto ...}}



Info.png
Información:
Para dar informaciones, escriba {{information-es|Texto ...}}



Para señalar una página como borrador, escriba {{Draft-es}} al inicio de la página, y obtendrá este cartel:

Esta página es un borrador

Requiere mejoras. Si quiere mejorarla, sólo ingrese y presione en la pestaña Edit.

Por favor, quite la plantilla {{Draft-es}} cuando esté seguro de que la página está completa y es correcta.


Konsole.png
[root@computer ~]# Para mostrar un comando que debe ser escrito en una consola como root, escriba {{root console|linéa de comando}}
[root@computer ~]# _


Konsole.png
[user@computer ~]$ Para mostrar un comando que debe ser escrito en una consola como usuario normal, escriba {{Console|linéa de comando}}
[user@computer ~]$ _


Categorías

La etiqueta especial que más utilizara es Category :

Sintaxis: [[Category:nombre de la categoria]]

Ejemplo: [[Category:Documentation]]

El wiki esta configurado de tal forma que si pone esa etiqueta en cualquier parte del código, se creara un enlace a la Categoría Documentation, que automáticamente aparecerá encerrado en una bonita caja al final de la pagina. Su pagina también aparecerá automáticamente en el indice de la categoría "Documentation" sin necesidad de trabajo extra de su parte. Utilizamos "Doc" para documentos internos del equipo de documentación (Doc Team), "Documentation" para documentos de interes general y varias subcategorias. Lo mejor es siempre utilizar "Doc" o "Documentation" y añadir otras Categorías según se requiera.

Notepad.png
¡Recuerde esto!
Si bien es posible colocar las etiquetas Category en cualquier sitio, es mejor colocarlas al inicio del documento - si, al INICIO del documento, con algunos espacios en blanco antes del inicio de la pagina. Esto es importante ya que evita que las etiquetas sean borradas accidentalmente al editar una pagina y facilita encontrarlas dentro de paginas muy largas.


Utilice tantas categorías como se requiera. La lista de Categorías disponibles se puede encontrar aquí.

Firma

Actualmente no hay necesidad de firmar una pagina, ya que el historial proporciona esa información, pero en ocasiones querra firmar algo. Esto es muy util en la pestaña Discussion. También es una forma conveniente de enlazar a su pagina de usuario (donde podra probar su paginas antes de publicarlas en el wiki).

Lo que escribe Lo que obtiebe
~~~ lebarhon
~~~~ lebarhon 17:32, 23 June 2014 (UTC)
~~~~~ 17:32, 23 June 2014 (UTC)

Enlaces utiles

https://es.wikipedia.org/wiki/Ayuda:Edición

https://www.mediawiki.org/wiki/Help:Tables/es

https://www.mediawiki.org/wiki/Help:Images/es

https://es.wikipedia.org/wiki/Ayuda:Tablas

https://es.wikipedia.org/wiki/Wikipedia:Manual_de_estilo


Como modificar una pagina

Generalidades

Todo lo que tiene que hacer es presionar sobre el enlace Edit al inicio de la pagina (haciedo editable la pagina completa) o presionar el enlace Edit a la derecha del titulo de cada sección (para editar solo esa sección). Esos enlaces lo llevaran a la pagina de edición y le mostraran el codigo wiki de la pagina actual.

En la esquina superior izquierda hay un menu para formatos basicos.
Wiki4.png
Se muestra un mensaje de ayuda cuando el apundor del ratón pasa sobre uno de los iconos.

Al final de la pagina hay una sección llamada Summary (Resumen) para que comente acerca de sus cambios. Por favor llene este espacio para que otros contribuidores puedan seguir más facilmente lo que se ha hecho cuando esten en la pagina history.

También puede especificar dos opciones:

  • This is a minor edit para informar a otros de que los cambios realizados son menores (basicamente cualquier cambio que no altere el contenido o la apariencia de una pagina).
  • Watch this page le permite ser informado por correo de las modificaciones a una pagina (excepto las modificaciones menores).

Y finalmente estos tres botones:

  • Save page para guardar su trabajo (atajo de teclado : Alt-Shift-S)
  • Show preview para tener una idea de la apariencia de la pagina antes de guardarla (Alt-Shift-P)
  • Show changes para ver con claridad las diferencias entre lo realizado y la pagian que esta editando.

Se recomienda ampliamente que siempre previsualice las pagina ANTES de guardar las modificaciones realizadas para evitar errores.

No dude en añadir algunos comentarios en la pestaña "Discussion".

Cancelar una modificación y regresar a un estado previo

Esto es llamado revertir.

Como crear una pagina

1. Asegurece de que esa pagina o una similar que pueda ser expandida/completada no exista
2. Informe a la lista de correos - tal vez alguien ha trabajado o tenga planes de trabajar en dicha pagina
3. Encuentre un buen titulo (vea la sección más abajo). Esto es importante ya que renombrar una pagina no es facil.
4. Ingrese en el wiki
5. Escriba el titulo en el cuadro de busquedas (punto 7 en esta captura) y presione en "Search", acepte crear la pagina presionando sobre el titulo.
6. La nueva pagina se abre en modo edición. Si gusta puede copiar/pegar este ejemploen la nueva pagina:


{{draft-es}}

[[Category:Documentation]]

== Introducción ==

7. Añada otras categorias y/o quite la categoria "Documentation" de ser necesario
8. Siempre incluya una sección "Presentación"/"Introdución" que explique el contenido de la pagina
9. Vea Como modificar una pagina

Nombre de la pagina y de las secciones

  • Trate de poner las palabras adecuada en los motores de búsqueda
  • Trate de no usar títulos más largos de lo necesario
  • Escriba los títulos con los espacios usuales entre palabras, (deje que el wiki se encargue de los " _ ")
  • No crear paginas en subcarpetas, e.j. Topic/FAQ
  • Use un lenguaje natural para los nombres
  • Utilice letras mayúsculas solo en la primer palabra del titulo de la pagina o sección: "Algo así"
    • Excepciones: nombres propios, y los títulos/capítulos de las guias de la documentación formal que se estén convirtiendo a XHTML/XML
    • Ejemplos: "Únase a Nombre Provecto"; "Preparando un dispositivo USB"; "FAQ sobre SELinux"

Como traducir una pagina

En ausencia de un wiki multi idioma

En este caso, solo existe el domino [en] y hospeda a todos los lenguajes.

  • Avise a la lista de correos que esta por traducir una pagina del wiki
  • Cree una nueva pagina con un titulo compuesto por la traducción del titulo original seguido por -xy. xy que son las letras simbólicas del lenguaje,
    • Ejemplo: El titulo de esta pagina traducido al Francés debe ser "Comment écrire une page wiki-fr", en Aleman "Erstellen einer Wiki Seite-de",
  • Añada un enlace a cada traducción existente de la pagina a su traducción y and vice-versa. Cada enlace deberá estar en el lenguaje que le corresponda. Esto significa: English, Español, Français, Deutsch, ... Para las paginas en Ingles, Español, Francés y Alemán, existen carteles para cada lenguaje.
  • Realice capturas que se parezcan lo más posible a las originales. Añada texto de ser necesario,
  • Añada la categoría del lenguaje (N.T. esto lo hace automáticamente el cartel de idiomas) categoría si existe, si no pregunte en la lista de correo, y igual para otras categorías.

Una vez que se tenga un wiki multi idioma

Se escribirá cuando exista lebarhon 12:59, 8 June 2014 (UTC)

Administración del wiki

Se escribirá cuando exista una fuente oficial katnatek 19:17, 1 May 2019 (UTC)

  • Como archivar una pagina
  • Como borrar imágenes
  • Como renombrar una pagina
  • Sobre el mantenimiento del wiki:
    • tips para revisar si una pagina fue importada de otro lugar y como revisar su licencia
    • Cuando mover o eliminar una pagina
    • Que hacer con las paginas marcadas como borradores
    • etc.