Guia de Estilo de OpenSUSE

De openSUSE, la enciclopedia libre.

(Redirigido desde OpenSUSE Style Guide)

Por favor siga las especificaciones de este documento cuando cree o edite artículos en este Wiki.

Tabla de contenidos

Títulos de Artículos


El nombre de tu artículo es también el encabezado. Pon un título claro, no uses abreviaturas confusas, y no uses palabras juntas DeEstaManera. No repitas el título del artículo en el encabezado. No debes crear tus propios espacios de nombres. Usa mayúsculas en para la primea letra de las palabras en los encabezados y los subtítulos.

Encabezados


  • Usa el simbolo = (encabezado) y no el simbolo ''' (negrita) para crear un encabezado. De este modo, la tabla de contenidos (TOC) se genera automáticamente a partir de los encabezados.
  • Inicia con solo un = y no con dos ==. Por ejemplo:
=Encabezado 1=
==Subtítulo 1.1==
==subtítulo 1.2==
=Encabezado 2=
==subtítulo 2.2==
===subtítulo 2.2.1===
====subtítulo 2.2.1.1===
  • Los Encabezados facilitan a las personas leer rápidamente sólo lo que desean y omitir las partes en las que no están interesadas.
  • Si tu texto comienza a ser muy largo, considera dividirlo en subtitulos.
  • Usa mayúsculas para la primera letra de las palabras en los títulos.

Etiqueta Adecuadamente Tu Texto


Usa las características de formato de MediaWiki para hacer tu texto mas fácil de leer. Pon los nombres de archivos y comandos en una fuente de ancho uniforme:

<tt>fuente de ancho uniforme</tt>

Utiliza el Conjunto de Características de MediaWiki


No uses formato HTML a menos que sea absolutamente necesario. Al usar en formato de MediaWiki das a los artículos un aspecto y sensacion consistente y hace, al código fuente, fácil de escribir, leer y editar. Por favor visita el artículo Cómo se edita una página para ver las herramientas de formato y etiquetado que puedes usar. También puedes ver en el código fuente de algunos Artículos de Wikipedia.

Comentarios


Como lector, usa las páginas de discusión de los artículos para publicar tus comentarios. No desordenes el texto del artículo.

Como escritor, evita que tu artículo parezca incompleto o que está sin finalizar, excepto con el uso de {{plantillas}} o templates.

De igual manera, no tiene beneficio alguno para el lector ver encabezados y tablas sin contenido.

Si deseas comunicarte con otro editor potencial, haz comentarios invisibles al lector normal del artículo. Para lograr esto, encierra el texto que desees que solo lean los editores entre <!-- y -->.

Por ejemplo, lo siguiente:

hola <!--Este es un comentario.--> a todos

se muestra así:

hola a todos

Así, el comentario se verá cuando un editor lea el código fuente wiki o HTML.

Debes Evitar el Crecimiento Artificial


No debes crear artículos vacíos, los artículos deben contener un mínimo de información relevante. En Wiki el modo de sugerir un artículo para que alguien lo escriba, es crear un enlace a él. Si hay al menos dos enlaces al mismo artículo inexistente, este aparecerá en la lista de Páginas Deseadas.