[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

no way to compare when less than two revisions

Diferencias

Muestra las diferencias entre dos versiones de la página.


—es:slackdocs:tutorial [2015/10/22 06:25 (UTC)] (actual) – creado gerardo.zamudio
Línea 1: Línea 1:
 +====== Tutorial del Wiki y directrices ======
  
 +
 +===== Namespaces =====
 +
 +Favor de familiarizarse con el concepto de namespaces en DokuWiki: [[https://www.dokuwiki.org/start?id=es:namespaces]]
 +
 +==== Artículos sencillos ====
 +
 +Cuando vas a crear únicamente una página //sencilla// entonces se recomienda utilizar uno de los namespaces que ya existen:
 +  * ''[[/start?idx=howtos|howtos:]]'' \\ Para tutoriales y guías
 +  * ''[[/start?idx=security|security:]]'' \\ Documentación sobre cómo enfrentar problemas de seguridad en Linux (no nada más en Slackware), guías para proteger tu computadora y aplicaciones, cómo navegar el Internet de manera segura, etc.
 +  * ''[[/start?idx=slackware|slackware:]]'' \\ Artículos directamente relacionados con la distribución Slackware
 +  * ''[[/start?idx=wiki:user|wiki:user:]]'' \\ Para uso personal de los usuarios del Wiki
 +  * Cualquiera de los namespaces regionales (''[[/start?idx=nl|nl:]]'' ''[[/start?idx=de|de:]]'' ''[[/start?idx=fr|fr:]]'' etc) que tambíen incluyen los namespaces ya mencionados.
 +
 +
 +==== Artículos complejos ====
 +
 +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-[[https://www.dokuwiki.org/start?id=es:namespaces|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 [[wp>Dos_puntos|dos puntos]], y si el namespace empieza con un punto '.' significa que es relativo al namespace actual.
 +
 +<note tip>Supongamos que estás editando la página principal de HOWTO y quieres agregar tu propio HOWTO llamado "icecast streams" y también quieres incluir múltiples páginas y capturas de pantalla. Tendrías que agregar un enlace en la [[es:howtos:start|página principal de HOWTOs]] utilizando el nombre ".icecast_streams:start". \\ //Recuerda que en este Wiki el [[es:howtos:start|índice de HOWTOs]] es automáticamente poblado con los artículos que tengan la etiqueta "howtos" así que asegurate ser prudente con las etiquetas// \\ 
 +Ese nombre dentro de un enlace interno normal pondría la página bajo el namespace ''howtos:icecast_streams:'' Posteriormente podrás subir todos tus archivos a ese namespace. \\ 
 +//Cabe señalar que en el nombre de ejemplo "icecast streams" se reemplazo el espacio por un guion baojo. Procura no utilizar espacios en los nombres de las páginas o namespaces!//
 +</note>
 +
 +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.
 +
 +
 +===== Sintaxis y formato =====
 +
 +Primero será necesario que te familiarices con la [[es:wiki:syntax|sintaxis de DokuWiki]]. No es igual a la de MediaWiki.
 +
 +Intenta mantener el formato de la página lo más simple posible:
 +  * El título de la página, o el primer encabezado, deberá ser **H1**, y los encabezados posteriores serían **H2**, **H3** y así sucesivamente.
 +  * No utilices reglas horizontales a menos que sea necesario. Por ejemplo, no es necesario cuando hay un encabezado arriba o abajo de la parte donde quieres agregar una nueva sección.
 +  * Asegurate que todo aquel texto que contenga comandos de ejemplo, nombres de archivos, texto de consola, o cosas similares tenga el formato de "texto código". Por ejemplo, ''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: <code>
 +====== 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}}
 +</code>
 +
 +===== Imágenes =====
 +
 +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 [[es:wiki:syntax#imagenes_y_otros_ficheros|información sobre imágenes y otros archivos]] para más detalle.
 +
 +
 +===== Código =====
 +
 +Se puede insertar [[es:wiki:syntax#bloques_no_analizados|código]] utilizando la etiqueta ''código'' de tal manera:
 +  <code c> float a; </code>
 +<code c>
 +float a; 
 +float b;
 +a = b * 10 + 2 * sin1(x);
 +</code>
 +Como se muestra en el ejemplo, es mucho más facil leer código si se utiliza el [[es:wiki:syntax#resaltado_de_sintaxis|resaltado de sintaxis]]
 +
 +
 +===== Corrección de ortografía =====
 +
 +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 [[es:slackdocs:contact|nuestro equipo de editores]] si necesitas ayuda para traducir tu artículo al inglés.
 +
 +
 +===== Plantilla de texto =====
 +
 +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 [[https://www.dokuwiki.org/plugin:tag|etiquetas]] predeterminadas según el namespace. Las etiquetas sirven para generar la tabla de contenido automáticamente.
 +
 +Ejemplo de texto de plantilla: <code>
 +<!-- 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}}
 +</code>
 +
 +===== Uso de las páginas de discusión =====
 +
 +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:
 +
 +  * Firma todos tus comentarios haciendo clic en el botón que dice **insertar firma** en el editor WYSIWYG o con la combinación de teclas <key>ALT</key>+<key>SHIFT</key>+<key>Y</key> 
 +  * Usa un **encabezado de segundo nivel** para añadir un nuevo comentario haciendo clic en la **H** azul en el editor WYSIWYG o con la combinación de teclas <key>ALT</key>+<key>SHIFT</key>+<key>2</key>
 +  * Añade todos los comentarios en la parte inferior de la página a menos que estés respondiendo. En ese caso, añade tus comentarios directamente bajo la entrada a la que estás respondiendo. Usa la tecla ''>'' para generar un hilo de discusión, utilizando varias ''>'' dependiendo de cuantas respuestas haya actualmente. Por ejemplo:
 +<code>
 +===== Tema =====
 +
 +Comentario original
 +> La primer respuesta
 +>> La segunda respuesta
 +>>> La tercera respuesta
 +</code>
 +
 +Se va a ver algo así:
 +
 +{{ :slackdocs:threaded-talk-page.png?640 |}}
 +
 +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. 
 +
 +===== Consideraciones de idioma ===== 
 +
 +==== En inglés por favor ====
 +
 +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**.
 +
 +==== ¿Cómo se manejan las contribuciones que no sean en inglés? ====
 +
 +Favor de revisar [[es:slackdocs:translation_guide#crear_una_pagina_en_su_propio_idioma|cómo crear una página en su propio idioma]] en las directrices de traducción.
 +
 +
 +<!-- Do not remove this line and the text below. Thanks! slackdocs@-->
 +{{tag>slackdocs tutorial needs_attention}}

Traza:

es:slackdocs:tutorial ()