Table of Contents

Contribuir a esta Wiki

Permisos de Edición

Los usuarios logueados tienen permisos para poder editar casi todas las páginas. Actualmente, es posible loguearse automáticamente usando una cuenta de Discord.

Disculpen por la dependencia, pero es la forma más facil de pelear contra el spam, considerando que los que contribuyen al proyecto ya tienen una cuenta de Discord.

Derechos de Autor

Al contribuir texto, usted acepta publicarlo bajo la licencia CC BY-NC-SA. Los detalles de esta licencia se encuentran abajo.

Sobre crear Páginas

A pesar de que es recomendado revisar page primero, en resumen es que en Dokuwiki, cualquier link <base_url>/what-ever-page es una página wiki “válida”, aunque nadie la haya creado. Al navegar a ese link, aparecerán instrucciones para poder crear la página.

A pesar de esto, esa usualmente no es la forma de crear una página, porque al crear una página de esta manera, solo será accesible desde el mapa de sitio o el link exacto, lo que no es muy accesible para la mayoría de los usuarios. Esta página se considera una página “huérfana”.

La forma adecuada de crear una página es agregando un link en alguna página que ya exista a la ruta de la página que se quiere crear, [[nonexistent|así]] así. Luego uno puede seguir el link y crear la nueva página.

Sobre Namespaces

De la misma forma en que en los filesystems los archivos se organizan en path/to/file, en Dokuwiki estas relaciones jerárquicas se estructuran con namespaces. <base_url>/namespace1:namespace2:page. Y para este ejemplo, el namespace para page es namespace2.

Lo genial de los namespaces es que, cuando creas una página desde un link, esta por defecto se asocia al namespace actual. [[link|page]] en <base_url>/ns1:ns2:blah se refiere a <base_url>/ns1:ns2:link. De esa forma, uno puede crear links a páginas que se crearan en el futuro sin preocuparse por los conflictos que se puedan generar con otros namespaces.

Sigiendo las convenciones de Dokuwiki, usamos namespace:start como la página inicial y el índice de los namespace.

Normalmente, no necesitarás crear nuevos namespaces. En muchos casos, es mejor idea crear una nueva página en el namespace actual en vez de crear un nuevo namespace con el contenido. Se recomienda conversar con los administradores antes de crear un nuevo namespace. Y si por alguna razón creaste un namespace por error, es fácil para los administradores corregirlo usando las herramientas que tienen disponibles, que les permiten mover páginas y regenerar los índices.

Traducción

En cualquier página con un menú lateral, al seleccionar un lenguaje en el menú drop-down, navegará a la misma página pero en el lenguaje seleccionado. Si la página se identifica como no existente, significa que tienes la oportunidad de ser el primero en traducirla. Simplemente, crea la página siguiendo las instrucciones mostradas. Al crearla, el editor aparecerá con la versión en Inglés de la página.

Si no encuentras un lenguaje en el menú drop-down, significa que el lenguaje aún no ha sido habilitado. Únete al servidor de Discord y solicita ayuda para empezar a traducir en el nuevo lenguaje, de esa forma los admins te podrán ayudar a arreglar las cosas.

Si quieres ver el progreso de traducción del sitio, puedes usar el tracker experimental.

Internals

Si estás familiarizado con este tipo de plataformas, notarás que el sistema de traducción funciona aprovechándose del sistema de namespaces. Bajo el namespace raíz hay namespaces que representan los diferentes lenguajes, nombrados con su código ISO. Todas las páginas dentro de un namespace del lenguaje están linkeadas adecuadamente, y cambiar de lenguaje es tan sencillo como cambiar el nombre del lenguaje en el link.

Barra Lateral

Si eres el primer traductor de un lenguaje, podrás encontrarte en la situación de que la barra lateral no aparecerá en las páginas que has creado en el nuevo lenguaje. Esto es una excepción al sistema de creación de páginas. Para arreglar este problema, debes ingresar a <base_url>/<language code>:sidebar en tu navegador y crear la barra lateral tú mismo. Usa la barra lateral en inglés sidebar como referencia.

Actualmente, existe un problema con el plug-in de traducción que hace que los links en la barra lateral tengan que empezar con .. Si agregas un link como [[contribute]] este te llevará a <base_url>/contribute (que no existe porque no se encuentra bajo ningún lenguaje), mientras que [[.contribute]] funciona de la forma esperada respetando el lenguaje.

Misceláneos

En el menú lateral podrás encontrar documentación acerca de la syntax de Dokuwiki.