Favor de familiarizarse con el concepto de namespaces en DokuWiki: https://www.dokuwiki.org/start?id=es:namespaces
Cuando vas a crear únicamente una página sencilla entonces se recomienda utilizar uno de los namespaces que ya existen:
howtos:
security:
slackware:
wiki:user:
Si agregas un nuevo tutorial que está dividido en múltiples artículos, contiene capturas de pantalla, o algo por el estilo se recomienda que se publiquen en su propio sub-namespace. De otra manera los namespaces actuales se saturarán y será más difícil mantener la organización.
Cuando agregues un enlace dentro de una página existente que apunta a tu nueva página en su propio sub-namespace, también es necesario poner el nombre de tu namespace en la liga.
Para esto se utilizan dos puntos, y si el namespace empieza con un punto '.' significa que es relativo al namespace actual.
howtos:icecast_streams:
Posteriormente podrás subir todos tus archivos a ese namespace. Por favor haz lo posible por mantener una estructura de namespaces limpia y organizada. Sería muy laboroso arreglar todos los enlaces del Wiki si tenemos que corregir las ubicaciones de las páginas o namespaces.
Primero será necesario que te familiarices con la sintaxis de DokuWiki. No es igual a la de MediaWiki.
Intenta mantener el formato de la página lo más simple posible:
man rc.inet1.conf
. Hay un botón etiquetado “TT” en la barra de herramientas en la parte superior que inserta este tipo de formato automaticamente.Este es un ejemplo de cómo se vería una página sencilla utilzando namespaces para las subpáginas:
====== Esta es la página ====== Aquí va una descripción Recuerda utilizar las subpáginas (sub-namespaces) cuando sea necesario. ===== La primera sección ===== Algo aquí [[.subpage:start | Artículo más a detalle]] ===== La segunda sección ===== Más texto [[.otra_subpagina:start | Más información con capturas de pantalla]] <!-- Puedes dejar comentarios en tu página. Los comentarios no son visibles en la publicación final --> <!-- Las etiquetas son indispensables para generar la tabla de contenido --> {{tag>howtos software}}
Tal vez querrás incluir algunas imágenes en tu artículo pero tener imágenes de tamaño completo podría hacer el el formato no se vea muy bien. Afortunadamente es posible ajustar el tamaño directamente dentro del mismo artículo. También se puede alinear la imágen como desees:
Ajustar lo ancho:
{{wiki:dokuwiki-128.png?50}}
Alinear izquirda/centro/derecha:
{{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
Véase tambíen información sobre imágenes y otros archivos para más detalle.
Se puede insertar código utilizando la etiqueta código
de tal manera:
<code c> float a; </code>
float a; float b; a = b * 10 + 2 * sin1(x);
Como se muestra en el ejemplo, es mucho más facil leer código si se utiliza el resaltado de sintaxis
Por favor revisa la ortografía de tu artículo ya sea con inglés americano o del Reino Unidos. El inglés no es el idioma principal de muchos de nuestros lectores. No dudes en contactar a nuestro equipo de editores si necesitas ayuda para traducir tu artículo al inglés.
Las páginas nuevas incluyen texto predeterminado que viene de nuestras plantillas para los distintos namespaces. Cada namespace tiene texto predeterminado diferente.
Lo más importante de estas plantillas es que agregan las etiquetas predeterminadas según el namespace. Las etiquetas sirven para generar la tabla de contenido automáticamente.
Ejemplo de texto de plantilla:
<!-- Agrega tu texto en la parte inferior. Se recomienda empezar con un encabezdo (véase la barra de herramientas en la parte superior). --> <!-- Favor de no agregar texto debajo de esta línea excepto por etiquetas adicionales. --> <!-- Recuerda borrar la etiqueta "template", de lo contrario la página no se mostrará en la tabla de contenido --> <!-- No borres esta línea ni la que sigue con la lista de etiquetas. Gracias! slackdocs@--> {{tag>howtos template}}
Es buena idea utilizar las páginas de discusión (véase el enlace en la parte superior de cada página) para discutir el contenido del artículo, señalar errores, resolver dudas, llamar la atención del autor hacia alguna sección en especifico, o hacer sugerencias
Si quieres agregar un comentario a una página de discusión piensa bien en lo que quieres escribir antes de hacer clic en la pestaña de editar esta página. Manten el tiempo que tienes la página bloqueada lo más corto posible para que no obstruyas a alguna otra persona que quiera hacer comentarios también.
Cuando agregues un comentario a la página de discusión existen algunas directrices que debes seguir con el fin de mantener la discusión legible y ordenada:
>
para generar un hilo de discusión, utilizando varias >
dependiendo de cuantas respuestas haya actualmente. Por ejemplo:===== Tema ===== Comentario original > La primer respuesta >> La segunda respuesta >>> La tercera respuesta
Se va a ver algo así:
Te puedes suscribir a los cambios de cualquier página de discusión si quieres que se te notifique cuando haya nuevas respuestas o nuevos comentarios. Haz clic en la pestaña de gestión de suscripciones una vez que estés dentro de la página de discusión.
El inglés es el idioma principal del proyecto de documentación de Slackware. Esto es natural ya que Slackware Linux únicamente cuenta con un instalador y documentación en inglés. El equipo de administración no desea que el proyecto sufra del efecto confusio linguarum.
Favor de revisar cómo crear una página en su propio idioma en las directrices de traducción.