[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

Diferencias

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

Enlace a la vista de comparación

Ambos lados, revisión anteriorRevisión previa
Próxima revisión
Revisión previa
Próxima revisiónAmbos lados, revisión siguiente
es:slackdocs:styleguide [2013/01/14 01:19 (UTC)] – [General] dragones:slackdocs:styleguide [2013/01/14 03:04 (UTC)] – [Una nota general de Style] dragon
Línea 1: Línea 1:
-======= Work in Progress (dragon) ====== 
 ====== Guía de estilo de los artículos publicados en SlackDocs ====== ====== Guía de estilo de los artículos publicados en SlackDocs ======
  
Línea 11: Línea 10:
 ---- ----
  
-==== Política Regla ====+==== Regla ====
    
 **Mayor ((Para los fines de esta regla, una edición de importancia deberia considerarse, cuando cambia sustancialmente el contenido, el flujo, o la disposición del artículo.)) Las ediciones no deberian realizarse en la presentación de un contribuyente, sin su conocimiento y discusión editorial.** **Mayor ((Para los fines de esta regla, una edición de importancia deberia considerarse, cuando cambia sustancialmente el contenido, el flujo, o la disposición del artículo.)) Las ediciones no deberian realizarse en la presentación de un contribuyente, sin su conocimiento y discusión editorial.**
Línea 21: Línea 20:
   - Documentos Básicos en estos espacios de nombres que requieren visión editorial más exigente: **slackware**, **slackdocs** o **slackbook**.   - Documentos Básicos en estos espacios de nombres que requieren visión editorial más exigente: **slackware**, **slackdocs** o **slackbook**.
   - El permiso explícito se concede a través de la página de discusión del autor original para permitir abiertamente la edición/mejoras.   - El permiso explícito se concede a través de la página de discusión del autor original para permitir abiertamente la edición/mejoras.
-  - El autor es desconocido o ya no es un participante activo aquí.+  - El autor es desconocido o ya no es un participante activo.
   - Edición o reversión se requiere para corregir el vandalismo.   - Edición o reversión se requiere para corregir el vandalismo.
   - Correcciones menores se requieren para corregir la gramática, puntuacion, la ortografía, el formato wiki, o la claridad.   - Correcciones menores se requieren para corregir la gramática, puntuacion, la ortografía, el formato wiki, o la claridad.
Línea 39: Línea 38:
 Gracias por su comprensión y cooperación en este asunto. Gracias por su comprensión y cooperación en este asunto.
  
-===== Página Etiquette Edición =====+===== Etiquette en la Edición de Página =====
  
 ==== Realizando el bloqueo ==== ==== Realizando el bloqueo ====
Línea 47: Línea 46:
 ==== Editar una Sección, no toda la página ==== ==== Editar una Sección, no toda la página ====
  
-A la derecha de la cabecera de cada sección de la página, verá la palabra [editar]. Si hace clic en él para editar la sección, sólo bloquear esta sección de la página que permite a otros colaboradores para editar las distintas secciones de la página. Este es el método recomendado para la traducción de páginas, la fijación de los errores tipográficos o sólo algunas frases / palabras.+A la derecha de la cabecera de cada sección de la página, verá la palabra [editar]. Si hace clic en él para editar la sección, sólo bloquear esta sección de la página que permite a otros colaboradores editar las distintas secciones de la página. Este es el método recomendado para la traducción de páginas, la correccion de los errores tipográficos o sólo algunas frases/palabras.
  
 ==== Añadir un Resumen ==== ==== Añadir un Resumen ====
Línea 55: Línea 54:
 ==== Modificaciones Menores ==== ==== Modificaciones Menores ====
  
-Cuando sólo corrige un error, cambia una palabra o hace modificaciones globales menores, marque la casilla "Cambios menores" que se encuentra a la derecha del "resumen Editar" de campo. Dokuwiki nos permite seguir revisiones de la página a través de [[http://docs.slackware.com/feed.php | RSS]]. Al indicar que usted ha hecho un "pequeño cambio", no dará lugar a una actualización de la fuente RSS. \ \ En el "viejo revisiones" ficha, ** modificaciones menores serán ** mencionado.+Cuando sólo corrige un error, cambia una palabra o hace modificaciones globales menores, marque la casilla "Cambios menores" que se encuentra a la derecha del "resumen Editar". Dokuwiki nos permite seguir revisiones de la página a través de [[http://docs.slackware.com/feed.php | RSS]]. Al indicar que usted ha hecho un "pequeño cambio", no dará lugar a una actualización de la fuente RSS. \\ En la ficha "revisiones antiguas", **las modificaciones menores serán** mencionadas.
  
-==== ==== Añadir un pie de página+==== Añadir un pie de página ====
  
 Cada página puede terminar con este código wiki, especialmente si ha copiado un texto a partir de una fuente externa: Cada página puede terminar con este código wiki, especialmente si ha copiado un texto a partir de una fuente externa:
  
 <code> <code>
-Fuentes ===== =====+===== Sources =====
  
-  * Autor principal +  * principal author 
-  * Contribuyentes+  * contributors 
 + 
 +{{tag>list of tags}} 
 +</code>
  
-{{Tag> lista de tags}} 
-</ Code> 
  
  
Línea 74: Línea 74:
  
 Puede utilizar varios cuadros visuales, tales como: Puede utilizar varios cuadros visuales, tales como:
-<note> nota </ ??note> +<note> nota </note> 
-<note tip> punta </ ??note> +<note tip> punta </note> 
-<note important> importante </ note> +<note important> importante </note> 
-<note advertencia warning> </ note>+<note advertencia warning> </note>
  
 Este es el resultado de: Este es el resultado de:
 <code> <code>
-<note> nota </ ??note> +<note>nota</note> 
-<note tip> punta </ ??note> +<note tip>punta</note> 
-<note important> importante </ note> +<note important>importante</note> 
-<note advertencia warning> </ note> +<note advertencia warning>warning</note> 
-</ Code>+</code>
  
 La barra de botones en la parte superior de la ventana de edición contiene botones para la creación sencilla de estos cuadros de notificación. La barra de botones en la parte superior de la ventana de edición contiene botones para la creación sencilla de estos cuadros de notificación.
  
  
-===== Una nota general para Style ====+===== Una nota general de Estilo ====
  
-Este es un wiki en el que un cierto grado de informalidad es aceptable. Esto incluye, por ejemplo, las contracciones conversacionales tales como "no tienes". Los lectores deben sentir que están hablando con un amigo bien informado en lugar de leer un manual. Sin embargo, cualquier apariencia de descuido se debe evitar.+Este es un wiki en el que un cierto grado de informalidad es aceptable. Esto incluye, por ejemplo, las contracciones conversacionales tales como "you've". Los lectores deben sentir que están hablando con un amigo bien informado en lugar de leer un manual. Sin embargo, cualquier apariencia de descuido se debe evitar.
   * No utilice [[wp> Slang | argot]] o "[[wp> SMS_language | textspeak]]".   * No utilice [[wp> Slang | argot]] o "[[wp> SMS_language | textspeak]]".
   * Escribir oraciones completas y tratar de evitar los errores gramaticales. Si el Inglés no es su lengua materna, siempre puede obtener ayuda de un editor de Inglés.   * Escribir oraciones completas y tratar de evitar los errores gramaticales. Si el Inglés no es su lengua materna, siempre puede obtener ayuda de un editor de Inglés.
   * Siga las instrucciones adecuadas [[http://www.writersblock.ca/tips/monthtip/tipmar98.htm|capitalization reglas]] para las palabras en los títulos y encabezados.   * Siga las instrucciones adecuadas [[http://www.writersblock.ca/tips/monthtip/tipmar98.htm|capitalization reglas]] para las palabras en los títulos y encabezados.
-  * Pasajes largos de texto plano son difíciles de leer, siempre tenga en cuenta que si algo se puede expresar mejor usando un formato de lista. Utilice las listas numeradas sólo para las operaciones secuenciales, listas con viñetas para las opciones o ejemplos (como se muestra aquí). A veces, una tabla o diagrama de flujo de una puede ser útil. +  * Pasajes largos de texto plano son difíciles de leer, siempre tenga en cuenta que si algo se puede expresar mejor usando un formato de lista; hagalo. Utilice las listas numeradas sólo para las operaciones secuenciales, listas con viñetas para las opciones o ejemplos (como se muestra aquí). A veces, una tabla o diagrama de flujo puede ser útil. 
-  * Si citando a la salida del ordenador, se reproducen con exactitud, incluyendo la ortografía (que suele ser americano). Utilice%% <code> </ code>%% para encerrar la salida para una mejor legibilidad. +  * Si citando a la salida del ordenador, se reproducen con exactitud, incluyendo la ortografía (que suele ser Estadounidense). Utilice %%<code></code>%% vinetas para encerrar la salida para una mejor legibilidad. 
-  * Si el texto tiene ejemplos de pulsaciones de teclas, utilice el%% <key> </ key> markup%% para lograr un impacto visual. <key> Alt-F2 </ key> se ve mejor que "'''' Alt-F2"+  * Si el texto tiene ejemplos de pulsaciones de teclas, utilice el %%<key></key>%% markup para lograr un impacto visual. <key>Alt-F2</key> se ve mejor que "''Alt-F2''". 
-  * Evite la voz pasiva. Úselo sólo cuando las alternativas sería torpe+  * Evite la voz pasiva. Úselo sólo cuando las alternativas sean nulas
-  Trate de evitar a largo prolijidad. "Para hacer x, utilice la opción-y" o "hacer X, escriba [[http://www.techopedia.com/definition/7264/foo|foo]]-y" lee mejor que "Si quieres foo hacer para usted, usted tiene que escribir foo-y ".+  Trate de evitar confusion. "Para hacer x, utilice la opción-y" o "hacer X, escriba [[http://www.techopedia.com/definition/7264/foo|foo]]-y" se lee mejor que "Si quiere que foo haga x , usted tiene que escribir foo-y ".
  
  
 ===== Traducir una página ===== ===== Traducir una página =====
  
-Las capacidades multi-idioma de este Wiki requiere que usted se pega a unas cuantas reglas. Por favor, lea los específicos [[slackdocs: translation_guide | Normas de Traducción.]]+Las capacidades multi-idioma de este Wiki requiere que usted se apegue a unas cuantas reglas. Por favor, lea la [[slackdocs: translation_guide | Guia de Traducción.]]
 ===== Páginas que requieren la atención de un administrador ===== ===== Páginas que requieren la atención de un administrador =====
  
-Si usted piensa que una página Wiki (escrito por otra persona o usted mismo) está en necesidad de atención por parte del equipo de administración, puede agregar una etiqueta de "needs_attention" a esa página. Esto hará que la página afectada a aparecer en la "etiqueta [[: needs_attention | Páginas que necesitan atención]]" de la página. El equipo de administración comprobará que la página regularmente para nuevas entradas.+Si usted piensa que una página Wiki (escrito por otra persona o usted mismo) está en necesidad de atención por parte del equipo de administración, puede agregar una etiqueta de "needs_attention" a esa página. Esto hará que en la página afectada aparezca la "etiqueta [[: needs_attention | Páginas que necesitan atención]]". El equipo de administración comprobará la página regularmente para nuevas entradas.
  
-¿Cuándo se debe usar esto? Por ejemplo, puede encontrar un texto incompleto o mal escrito o incluso una página vacía (esto puede suceder si alguien escribe un texto no-Inglés, pero no toma acción para obtener una traducción Inglés adecuada arreglado). O quizás usted encontrará spam, o lenguaje ofensivo. \ \ Sus observaciones nos ayudarán a mantener el Wiki limpio y de alta calidad.+¿Cuándo se debe usar esto? Por ejemplo, puede encontrar un texto incompleto o mal escrito o incluso una página vacía (esto puede suceder si alguien escribe un texto no-Inglés, pero no toma acción para obtener una traducción Inglés adecuada). O quizás usted encontrará spam, o lenguaje ofensivo.\\ Sus observaciones nos ayudarán a mantener el Wiki limpio y de alta calidad.
  
-Vea también ===== =====+===== Vea también ===== 
  
   * [[Slackdocs: staff_editors_guide | Personal Guide Editors]]   * [[Slackdocs: staff_editors_guide | Personal Guide Editors]]
   * [[: Contribuir slackdocs | Ideas para Contribuir a la Wiki SlackDocs]]   * [[: Contribuir slackdocs | Ideas para Contribuir a la Wiki SlackDocs]]
   * [[Slackdocs: tutorial | Wiki Tutorial y Guía]]   * [[Slackdocs: tutorial | Wiki Tutorial y Guía]]
-<- Por favor, no añade nada a continuación, excepto que las etiquetas adicionales -.> +<!-- Please do not add anything below, except additional tags.--
-<- No quite esta línea y el texto a continuación¡Gracias! slackdocs @ -> +<!-- Do not remove this line and the text belowThanks! slackdocs@ --> 
-{{Tagsintaxis slackdocs style_guide edición de directivas}}+{{tag>slackdocs syntax style_guide editing policy}}
 es:slackdocs:styleguide ()