¡¡¡ Artículo en preparación !!! La última edición fue de Zorroargh el 19.08.2023
Breve guía técnica para el uso de colaboradores informados y gestores documentales. Consulte también la Guía de escritura(EN) (básica) y, de manera más general, la ayuda general del Wiki.
Contenido
Trabajo en Equipo
Nunca olvide que cualquier documento (con la excepción de las páginas protegidas, accesibles solo para administradores) puede ser modificado en cualquier momento por cualquier persona. Vea a continuación las buenas prácticas a adoptar (Modificaciones y luego Validación del contenido estable).
Para escribir con varias personas, es mejor usar un PAD. Más información sobre el formato de archivo(EN).
Páginas de discusión
A menudo es útil, práctico o esencial dejar un mensaje para los demás. Sin embargo, una página de «Discusión» está asociada con cada documento cuando se lo crea, por ejemplo aquí: Discusión:Guía Técnica de la Wiki ([[Discusión:{{FULLPAGENAME}}]).
En cualquier caso, debemos tratar de mantener algo legible, por lo que cada tema comenzará con un título (De esta manera: ==Título del tema abordado==). Es mejor tener cincuenta temas pequeños separados, cada uno con un título, que un solo paquete de cincuenta temas. Esto facilita respuestas discriminadas en su consideración, realización, etc.
Al final del asunto, siempre firmar con ~~~~. Esto permite saber de inmediato quién publicó el mensaje y cuándo.
Tradicionalmente, las respuestas se realizan mediante sangría (indentación) como en los correos electrónicos. Esto se hace comenzando la línea con un : más que la parte anterior. Obviamente cada respuesta, cada giro será firmado. Esto es muy útil para alguien que hará las mismas preguntas más tarde y que, por lo tanto, verá esta discusión como un elemento de «Base de conocimientos».
Finalmente, puede ser útil agregar un ✓ al título para indicar que el tema está cerrado (De esta manera: ==Título del tema abordado {{OK}}==). Si el tema necesita ser reabierto, podemos reemplazar el ✓ con un ✗ (De esta manera: {{KO}}).
Desafortunadamente, las personas concernidas por el interrogatorio no son necesariamente advertidas. De hecho, el número de artículos seguidos, es decir que pueden notificar tan pronto como haya una modificación, está limitado para no explotar la base. Por lo tanto, es bueno advertir a la persona o personas que puedan estar interesadas indicando el enlace a la discusión. También en este caso, aunque sea muy breve, el título y la firma, son bienvenidos.
Tutoría
En la primera lectura, se puede darse cuenta de que si el Wiki es fácil de escribir, es difícil de administrar con todas sus reglas de usabilidad y eficiencia, sus tradiciones basadas en la experiencia de los predecesores, etc. Es porque el wiki también tiene su «Lore» (tomado del inglés que significa «tradición oral»).
¿De verdad quiere invertir en la wiki? Por lo tanto, no teme en ser tutorado. No hay timidez o vergüenza… Todos hemos comenzado, y tal vez, esperamos, se volvera a su vez tutor. ¿No conoce a nadie? Intente ponerse en contacto con «veteranos» en https://chat.ryzom.com/channel/pj-ryzom_wiki o póngase en contacto con ellos desde Especial:UsuariosActivos.
Traducciones
Hay cuatro reglas que coexisten :
- Forja (parte de desarrollo), Carta de comportamiento en el juego, Carta gráfica, Categorías fundamentales:
- todo debe estar traducido al inglés para que sea accesible a la mayor cantidad de personas posible, la mayoría de las cuales entienden, más o menos, el inglés escrito.
- Carta de comportamiento en el juego, Carta gráfica, modelos de gestión Wiki, Categorías fundamentales:
- todo debe ser traducido a todos los idiomas.
- Lore, Crónicas, Animaciones públicas:
- todo debe estar traducido al menos a los tres idiomas «nativos» de Ryzom: DE, EN y FR.
- El resto y especialmente las partes de juego de roles:
- no hay reglas, solo prevalece el interés de los jugadores y los traductores.
Modificaciones
Con la excepción de los documentos archivados y los documentos con el estado oficial de «documento definitivo» (Lore, crónicas), todo se puede mejorar y esta es una de las riquezas de los wikis.
Sin embargo, es necesario respetar ciertas reglas de convivencia constructiva.
En primer lugar, es necesario evaluar si las modificaciones son profundas o no. No hay reglas y es más una intuición del momento, pero si la modificación es profunda, es aconsejable comenzar mirando el historial de la página (botón Historial al lado, a la derecha, del botón Editar). Si el contenido (no la forma, la apariencia, la ortografía ...) no ha evolucionado durante algún tiempo, se puede suponer que su autor lo dejó para tal y que el documento puede haber envejecido, lo que puede necesitar una actualización. Un ejemplo se muestra en las imágenes laterales.
Podemos considerar que una actualización es profunda tan pronto como elimina párrafos, o incluso líneas fundamentales para el desarrollo del tema. En este caso, es apropiado dejar un mensaje en la página «Discusión del usuario:<el_ultimo_autor>». Mientras esperaba su respuesta (al menos una semana), es aconsejable mantener en la página modificada el texto original pasado en el comentario. La forma más fácil de pasar un texto como comentario es precederlo con <!-- y seguirlo con -->. Pero a veces hay problemas, especialmente si ya hay otros comentarios. En este caso, se pueden usar el martillo y el burilen marcando el texto con <noinclude><includeonly> y </includeonly></noinclude> ¿Por qué tal complicación? Porque siempre debemos respetar los escritos de un autor y su paternidad intelectual, incluso en el libre. De lo contrario, corremos uno de los siguientes riesgos.
Guerra de ediciones
Extracto de Wikipédia Guerra de ediciones :
« Una guerra de ediciones representa una situación que surge en los sitios web de edición abierta. Ocurre frecuentemente que en páginas hechas en wiki, como Wikipedia, los usuarios se deshacen sus cambios recíprocamente en un intento de imponer su versión preferida de una página, ya que cada vez que alguien edita una página la versión anterior se almacena en el historial. Los conflictos de edición se originan cuando hay poco o ningún control sobre la edición.
[…]
Si una página en particular ha estado afectada por una guerra de ediciones y hay muchos editores implicados, la página será protegida por los administradores, de manera que entonces solo ellos pueden editarla. Para proponer una corrección al artículo, la página debe ser discutida y aprobada por un administrador. Pero ni siquiera a este se le permite hacer cambios importantes a una página afectada por una guerra de ediciones cuando dichos cambios no reflejan el consenso.»
No hay que confundir con conflicto de edición. Extracto de Wikipédia Ayuda:Conflicto de edición :
« Un conflicto de edición […] tiene lugar cuando dos personas editan simultáneamente una página, pero una de ellas pulse el botón de «Publicar cambios» antes que la otra, siendo la edición de la segunda incompatible con la primera. En ese caso, el trabajo de la segunda no se graba, y corre el riesgo de perderse. Es importante señalar que si dos personas distintas editan simultáneamente secciones diferentes de un mismo artículo no se daría conflicto de edición, pues ambas ediciones no serían incompatibles. »
Trabajar en paz
Por supuesto, los incidentes de trayectoria y la torpeza nunca se evitarán al 100%, por lo que lo más prudente es seguir las siguientes recomendaciones (extraídas y adaptadas de la Ayuda de Wikipedia: Ayuda:Conflicto de edición) :
« Para evitar conflictos de versiones, la forma más fácil es evitar modificaciones demasiado largas.
Sin embargo, esto no siempre es posible. Es por eso que se recomienda, al modificar profundamente una página, agregar de antemano la banda {{WIP|~~~~}} que se muestra de la siguiente manera :
¡¡¡ Artículo en preparación !!! La última edición fue de Zorroargh el 19.08.2023
-- Zo'ro-Argh Woren Siloy 28 mai 2019 à 14:19 (CEST)
Una vez que la página se haya publicado con esta banda, se puede editarla tranquilamente. Mejor limitar el número de cambios utilizando la vista previa para realizar ajustes (esto ahorra tiempo y evita saturar la página con cambios recientes).
Cuando se ha terminado, no olvidar quitar la plantilla {{WIP}}. »
El borrador
Otro método para trabajar en paz es hacerlo en su propio espacio de usuario. Este espacio es [[Utilisateur:Zorroargh/Brouillons/...]].
Los documentos que prepara allí no son accesibles para los motores de búsqueda (excepto explícitamente). ¡Incluso Google no tiene que ir allí!
Validación del contenido estable
Normalmente, en los wikis de Ryzom, todas las páginas son libres de tratamiento siempre que no haya vandalismo. Sin embargo, los jugadores pueden necesitar documentos fiables. Esto se refiere esencialmente a :
- La carta de comportamiento a lo largo del juego, incluyendo esta wiki.
- La Lore que establece las características fundamentales del juego (los homins no hablan klingon, los Karavan no vuelan sobre dragones de fuego y los Kami no brotan de una lámpara de aceite). Estas características se detallan en su portal dedicado.
- Otros documentos pueden considerarse sensibles para el mantenimiento como las reglas de categorización o las ampliamente utilizadas que pueden cambiar la apariencia, o incluso la legibilidad, de los documentos.
- Finalmente, los colaboradores, ya sean desarrolladores, jugadores (RP o no), animadores u otros, pueden encontrar útil solicitar la validación de su trabajo.
La Lore
Página oficial
Texto escrito por los y transcrito o traducido por «enciclopedistas».
Se coloca en la parte superior de la página el banner {{Official Lore}} con el logotipo de la Lore que mostrará la imagen
Por ejemplo, la plantilla misma: Plantilla:Official Lore
Creación por usuarios no loristas
Para solicitar una validación del equipo de la Lore, se coloca en la parte superior de la página el mismo banner {{Official Lore}} que quedara invisible hasta la aprobación y validación de la pagina por un Lorista o un administrador de la Wiki. Lo cual se hace dando protección máxima a la pagina.
Mientras tanto, la pagina queda registrada en Categoría:To be check. Pasara a Categoría:Official Lore tan pronto como se valide.
Mostrar la wiki en el juego
Al equipo de desarrollo le gusta usar nuestros documentos para mostrarlos en el juego con el fin de ayudar, iluminar y animar al jugador en sus misiones. Nuestros textos a veces son un poco largos para ser leídos en el juego, por lo que se ha proporcionado una herramienta para indicar qué partes son interesantes, o incluso esenciales. También hace posible eliminar todos los adornos de la wiki que no se pueden procesar en el juego o que hacen que sea más difícil de leer.
Para mostrar solo una o más partes de la página wiki, solo use las plantillas IGstart et IGend. La función de estos dos modelos es mostrar solo la parte del texto incluida entre {{IGstart}} y {{IGend}}. Todo lo demás es invisible en el juego.
Ejemplo:
Si abrimos la página Elyps(FR), veremos su página completa presentada en el wiki. Entre las banderas de traducción en la parte superior y el banner del portal y las categorías asociadas en la parte inferior, la página trae mucha información. Ahora, lo que le interesa al jugador es cómo usar los Elyps en el juego. No importa para él conocer la historia, y muchos otros detalles que deben satisfacer la curiosidad del jugador fuera del juego o para el RP. Una imagen a continuación muestra esta parte vista por el jugador en el juego.
Si abrimos la página Elyps en modificación, notaremos que todo el texto anterior {{IGstart}} no se muestra en el juego. Del mismo modo, todo el texto que sigue a {{IGend}} tampoco lo es. Solo lo que se muestra entre {{IGstart}} y {{IGend}}.
En resumen y en imágenes
El jugador descubre la palabra "Elyps". Así que hará clic en la palabra para averiguar de qué se trata.
La página wiki es demasiado larga para el uso de IG.
Solo la parte enmarcada en azul es útil.
Pero necesita un tratamiento especial, porque Ryzom no interpreta ni el HTML ni el código Mediawiki.
Este trabajo de selección y procesamiento se realizará escribiendo en el código wiki antes y después de la parte elegida el par { {IGstart}} y {{IGend}}.
Que da el resultado final.
Categorías
Todos los datos, artículos, imágenes, modelos, portales..., deben ser categorizados.
El uso de categorías
Las categorías son muy útiles para catalogar los documentos y facilitar su búsqueda. Debe entenderse que una categoría se asemeja a un conjunto en el sentido matemático del término, en otras palabras :
- un artículo puede pertenecer a varios conjuntos ;
- un conjunto de elementos se puede incluir completamente en otro ;
- es inútil declarar que un artículo pertenece a dos conjuntos si uno de ellos está completamente incluido en el otro.
Ejemplo: un calcetín rojo puede pertenecer a las categorías: calcetines, objetos de color rojo, ropa roja, ropa. Normalmente, declarar que este calcetín pertenece a la ropa roja, es suficiente. Pero también podríamos decir que pertenece a calcetines y objetos de color rojo sin hacer referencia a la ropa roja. En estos dos casos, es inútil declarar que pertenece a la ropa.
La elección de las categorías a veces se puede vincular a las herramientas que le permiten buscar en una categoría y que a menudo se muestran en los portales. Por ejemplo :
Todos los artículos correspondientes se pueden encontrar aquí...ᐒᐁᐘ
Las categorías básicas de este wiki
Se supone que las wikis, vinculadas al universo Ryzom, comparten datos comunes a los lenguajes básicos del juego. Estos datos comunes se agrupan en cuatro árboles detallados en el articulo Categorización. Solo se detallan las «grandes ramas» para dejar la libertad de organización de los datos a cada grupo lingüístico. Pero estos troncos y sus «grandes ramas» son esenciales, especialmente para los traductores que desean navegar fácilmente entre grupos de artículos.
¡Ojo! En Común, las categorías distinguen entre mayúsculas y minúsculas.
Plantilla (Template)
Una Plantilla es una página especial de Wikipedia, y en el software libre denominado MediaWiki que la misma utiliza, que contiene un fragmento de código diseñado para ser insertado en otras páginas de Wikipedia.
Una plantilla se utiliza para reproducir el mismo mensaje en varias páginas, o el mismo diseño, a veces dependiendo de los parámetros .
Es un elemento pre-escrito, más o menos complejo, destinado a ser incrustado en una página para obtener instantáneamente el resultado visual deseado (formateo, visualización de elementos específicos, etc.). Las pancartas en la parte superior de los artículos, las infoboxes, la exhibición de los siglos ... son modelos.
Todas las plantillas están ordenadas en la Categoría:Plantillas. Atención: las plantillas no son estrictamente idénticas para todos los idiomas, pero intentemos armonizarlos lo más posible.
Aspecto visual y carta gráfica
El aspecto visual debe recordar la identidad del juego. Por ejemplo: los «infoboxes» recuerdan los «ámbares de memoria» (RP) o las interfaces del Karavan (HRP). Los iconos en general se refieren más o menos explícitamente al universo del juego.
Una carta gráfica tiene dos funciones (al menos) :
- una función de identificación, recordando el espíritu del sitio (por ejemplo, utilizando los colores emblemáticos de las naciones, las facciones) ;
- una función ergonómica, al permitir evitar el "efecto sorpresa", es decir, evitar comportamientos diferentes de una página a otra, de una traducción a otra.
Por estas dos razones, es necesario atenerse a él tanto como sea posible.
Bandas, sellos e indicadores de cabecera
Las plantillas de encabezado o párrafo se utilizan para alertar al lector sobre cómo debe interpretarse la página que está consultando (desactualizada, en proceso de escritura, etc.), así como para resaltar anuncios importantes sobre el artículo.
Para que sea más fácil encontrarlos, se agrupan en la categoría Categoría:Plantilla:Banda, por ejemplo: WIP, Obsoleto, Borrador...
Las plantillas de pie de página se utilizan para informar al lector sobre información adicional que podría interesarle después de leer la página.
Más informaciones en la presentación de la Categoría:Portal Link explicando la relación entre esas bandas y los portales.
Cuerpo de página
Las plantillas de cuerpo de página se utilizan para complementar o resaltar información relacionada con la página actual. El resaltado puede ser diverso, como la visualización de inserciones grandes o varios formatos tipográficos.
Portal
Los portales en nuestra wiki sirven como páginas de inicio para los diversos intereses principales del juego. Se enumeran en el panel {{Portal bottom}}
Ryzom: La Lore • El juego OOC
Atys: El mundo de Atys • Flora • Fauna
Naciones: Fyros • Matis • Tryker • Zoraï
Facciones: Kami • Karavan • Merodeadores • Rangers • Trytonistas
Encyclopedia: Crónicas • La Gran Biblioteca • EntresijosOOC
Todos los portales tienen una estructura similar, pero su apariencia varía en función de la complejidad de los datos que presentan. En general, un portal comprende, de arriba a abajo :
- varias pestañas de subtemas, la la página de inicio general posiciona la lectura en la primera de ellas; en algunos casos, puede haber una segunda fila de pestañas ;
- el enlace hacia la categoría asociada ;
- un resumen ;
- unas cuantas informaciones en una sola pagina o en varios «paneles de visualización»: a la izquierda el «Documento del día» ocupando a veces toda la pagina, a la derecha pequeñas «informaciones adicionales» mayormente técnica ;
- al final, el panel que resume los principales portales de la Wiki de Ryzom (
{{Portal bottom}}).
Asociar un artículo a la categoría de un portal
Para asociar un artículo a un portal, basta con añadir en la parte inferior del texto del artículo en cuestión un bloque de instrucciones del siguiente tipo :
{{clear}}{{Last version link}}
<noinclude>{{Portal|xxx|yyy}}
[[Category:yyy]]</noinclude>
dónde:
- «clear» asegura que la barra de navegación al portal esté por debajo de la última imagen;
- «last version link» permite marcar la fecha y hora de la página y agrega una una pequeña flecha discreta que permite encontrar el original de una inclusión;
- «{{Portal|xxx|yyy}}» asocia uno o más portales con el documento. La adición del banner de navegación al portal también coloca el artículo en categorías "ocultas", categorías que no se mostrarán al lector, porque son inapropiadas, pero que se indican con un [+] colocado después de la última categoría mostrada. El uso de este comando se detalla en el artículo Categorización y en la Categoría:Portal Link.
- «noinclude» se puede establecer para no contaminar la inclusión(EN).
Paneles de visualización
Los portales no se fabricaron en un día y, por lo tanto, su modelo se ha refinado con el tiempo. En general, intentamos incluir documentos utilizando el código {{:DOCUMENTO}} donde DOCUMENTO=Nombre del documento a incluir. Asi, solo es necesario mantener el esqueleto de los portales y contentarse con incluir información que pueda actualizarse rápidamente.
Documento del día
A veces es bueno tener una documentación que ofrezca una visión general de los temas presentados reunidos en el portal. Esto se puede destacar de la siguiente manera :
| Un documento diferente incluido… | Código sugerido |
|---|---|
| cuando sea necesario | {{:Artículo destacado/<nombre del portal>/<titulo (presentación, generalidades, etc.)>}} |
| todos los días de la semana | {{:Pagina destacada/<nombre del portal>/Semana/{{CURRENTDOW}}}} |
| todos los días del mes | {{:Pagina destacada/<nombre del portal>/Mes/{{CURRENTDAY2}}}} |
La técnica de elección aleatoria ha sido condenada por Mediawiki, como demasiado cara. Actualmente, preferimos una opción limitada (día de la semana o mes). Esto requiere crear uno por uno los redireccionamientos a las páginas que queremos resaltar. Entonces, por ejemplo, la Pagina destacada/GBA/Semana/2 (2 del mes o martes) se redirige a Primes_Raider.
Si comparamos las dos páginas, veremos que hay un formato completamente diferente. Es que podemos hacer dos cosas antes de publicar la página elegida:
- adaptar la presentación;
- seleccionar las partes que se desea mostrar.
Adaptar la presentación
Ejemplo: Pagina destacada/GBA/Semana/2
Seleccionar las partes que se desea mostrar
Ejemplo: Primes_Raider
¿Qué pasa si el artículo es demasiado largo para incluirlo, o si solo algunas de sus partes son interesantes?
Lo más prudente es indicar las partes que se mostrarán u ocultarán en la futura inclusión marcándolas en el artículo original.
- Las etiquetas
<noinclude>y</noinclude>permiten excluir las partes que enmarcan de futuras inclusiones. - Las etiquetas
<onlyinclude>y</onlyinclude>permiten incluir las únicas partes que enmarcan en la inclusión futura. - Las etiquetas
<includeonly>y</includeonly>permiten incluir las únicas partes que enmarcan en la futura inclusión, ocultándolas en el artículo original(para ser manejadas con cuidado en una plantilla). Este último marcado se utiliza, por ejemplo, para ocultar en el artículo original el codigo{{read more|<articulo con mas información>}}(qui da el banda Leer más... que se muestra a continuación) pero lo visualiza en la inclusión.
Información adicional
Los paneles de visualización contienen información que puede ser de interés tanto para el lector como para el contribuidor. Esto puede variar desde información simple hasta emergencias, incluidas «Listas de tareas pendientes» y «Consejos y trucos».
Páginas de inicio
Las páginas de inicio son "específicas" porque son las que se muestran por defecto cuando inicias sesión en el wiki. Estas páginas no son editables y pueden contener muchos trucos en HTML (y Java). Esto implica que solo los contribuyentes informados pueden modificarlos según el consenso de la comunidad o los imperativos de comunicación.
Otros comandos avanzados
¿Alguna pregunta sobre wikis?
¿Un comentario? Por favor, póngarse en contacto con
- Consultar las categorías categoría:Ayuda y, más técnica, categoría:Wikipatys.
- Usar el canal público dedicado a los wikis, https://chat.ryzom.com/channel/pj-ryzom_wiki, y no en los buzones de correo personales, porque a menudo se hace las mismas preguntas. Se tendrá una respuesta más rápida, porque todos pueden tener acceso. Bajo el pj-ryzom_wiki, hay temas agrupados en discusiones, con la palabra FAQ en el título:
- FAQ - common: para preguntas y respuestas sobre la wiki Común (que tiene todas las imágenes, para las 5 wikis) y las imágenes
- FAQ Templates/Modèles: para preguntas y respuestas sobre plantillas
- FAQ - backgroud colors: para preguntas y respuestas relacionadas con el formato, la carta gráfica... (y los diversos modelos relacionados)
- FAQ - category: para preguntas y respuestas relacionadas con la categorización
- Comparación de portales y categorías con https://atys.wiki.ryzom.com/wiki/Ryzom_Wiki_Categories_v_Portals o https://es.wiki.ryzom.com/wiki/Categorización
Consulte la versión en inglés (en es: Wiki_Technical_Guide # Other advanced commands)o directamente: Tabla trilingüe para Páginas Especiales en: Wiki_guía Técnica / Páginas especiales es: Guía técnica de la Wiki / Notas de la API sobre comandos de la API (colocación de comandos en la wiki a través de URL, ayudado con un formulario de espacio aislado) Árboles de categorías dinámicos: User User:Craftjenn/ArboCaté * en es:Guía técnica Wiki#Códigos Wiki sobre categorías * at y atys comunes: User:Craftjenn/árbol de categorías comunes e información Advertencia (puede ser peligroso): reservado para la modificación masiva de administradores mediante expresiones regulares + https://regex101.com/
Acerca de los usuarios y los grupos de nuestras wikis: Guía técnica de la wiki / Permisos en < noinclude> ver https://meta.wikimedia.org/wiki/Help:Template https://meta.wikimedia.org/wiki/Migration_to_the_new_preprocessor
Espacios de nombres o namespaces
Las páginas de un wiki de MediaWiki se agrupan en colecciones denominadas «espacios de nombres» que permiten diferenciarlas a un nivel superior según su función. Las páginas en ciertos espacios de nombres también pueden tener propiedades especiales o comportarse de manera diferente al interactuar con otras páginas.
Los espacios de nombres se pueden encontrar en el codigo del nombre de la pagina apegado antes de su título, separado con dos puntos. Por ejemplo: Portal:La Gran Biblioteca, Plantilla:Portal La Gran Biblioteca, Categoría:La Gran Biblioteca. Una página cuyo título no es precedido por un espacio de nombres pertenece al espacio de nombres principal, como la pagina que se esta leyendo aquí.
