Proyecto:Manual de estilo

De doc.ubuntu-es
(Diferencias entre revisiones)
Saltar a: navegación, buscar
(Creación de páginas: añado ejemplo)
(continuo con los contenidos, hay que pulir aun)
Línea 13: Línea 13:
  
 
Siempre que la página tenga mas de tres o 4 párrafos el artículo deberá estar separado por secciones. Los títulos de las secciones tienen que usar la ortografía general respecto a mayúsculas y minúsculas, es decir, sólo se usarán mayúsculas para las iniciales de los nombres propios y para la primera letra del título. Consulta la sección de secciones en la [[Como_editar_páginas#Secciones|guía de edición]].
 
Siempre que la página tenga mas de tres o 4 párrafos el artículo deberá estar separado por secciones. Los títulos de las secciones tienen que usar la ortografía general respecto a mayúsculas y minúsculas, es decir, sólo se usarán mayúsculas para las iniciales de los nombres propios y para la primera letra del título. Consulta la sección de secciones en la [[Como_editar_páginas#Secciones|guía de edición]].
 
+
 
 
== Líneas de Código ==
 
== Líneas de Código ==
  
Línea 24: Línea 24:
 
   ~$ sudo apt-get update
 
   ~$ sudo apt-get update
  
 +
== Enlaces ==
 +
Consulta en [[Como editar páginas]] la manera correcta de incluir enlaces, tanto internos (enlaces dentro del mismo wiki) como externos.
 +
 +
== Imágenes ==
 +
No utilices nunca imágenes superiores a 400x300, pues deformarán el wiki sobretodo a las personas que utilicen una configuración de pantalla pequeña. No utilices imágenes indiscriminadamente. Utiliza solo las imprescindibles o minimamente necesarias para el entendimiento de la documentación.
 +
 +
== Categorías ==
 +
Puedes incluir más de una categoría a tu artículo, pero no incluyas en el mismo artículo una categoría una subcategoría a la vez. Lo correcto es incluir solo la subcategoría más baja, puesto que esto incluirá automáticamente el artículo en la categoría padre.
 +
 +
 +
== Sobre párrafos, signos de puntuación, etc ==
 +
Has tu artículo fácil de leer, incluye signos de puntuación, una línea en blanco entre párrafos , etc.
 +
Incluye títulos y subtítulos para hacer la lectura más cómoda y de mayor accesibilidad a través del índice de la página (tabla de contenidos).
 +
 +
No utilices palabras como Actualmente, ahora, etc, la documentación debe ser atemporal.
 +
No crees páginas con el mismo contenido para versiones diferentes de ubuntu, lo correcto es incluir un apartado en la misma página con la versión de Ubuntu de la que quieras incluir información.
  
(continua)
+
== Enlaces relacionados ==
 +
Es muy útil para los usuarios incluir una sección de enlaces relacionados con el artículo en cuestión, ya que facilita mucho la navegación. También puedes agregar en otras páginas el enlace a tu artículo en la sección de enlaces relacionados.
 +
Por ejemplo, si tu artículo trata sobre mp3, es útil agregar un enlace a [[Formatos Restrictivos]]
  
 +
Si no estás seguro de si has dado un estilo o formato adecuado a tu artículo, añade la plantilla [[:Plantilla:Formatear]] añadiendo el siguiente código al principio de la página:
 +
  <nowiki>[[Plantilla:Formatear]]</nowiki>
 +
Con esto incluirás una nota en tu página para que los responsables del wiki puedan darle un formato adecuado a tu artículo.
  
 
<!-- Categorías-->
 
<!-- Categorías-->
  
 
[[Categoría:Ayuda]]
 
[[Categoría:Ayuda]]

Revisión de 20:23 9 oct 2007

Para que todos los artículos de este sitio mantengan un estilo o formato unificado es necesario establecer ciertas reglas a la hora de la creación de los mismos, facilitando así la lectura y el entendimiento a todos los usuarios y la organización de los contenidos del wiki.

Se mencionan aquí ciertos aspectos importantes a la hora de crear páginas o de editar las mismas.

Contenido

Creación de páginas

Es necesario y muy importante que pensemos bien el título que le vamos a poner a nuestra página antes de crearla. Antes de ello, ten en cuenta estos puntos:

  • Los títulos de las páginas serán también la url de estas mismas. Se pueden añadir tildes, pero evita incluir caracteres extraños, pues las urls no los interpretan bien.
  • El título ha de ser completamente específico y evitando información innecesaria. Por ejemplo, si queremos crear una página para el reproductor de música Totem, el título debe ser ese y solo ese, no es necesario llamarla “reproductor de música totem” puesto que para añadir esa información ya tenemos la categoría Reproductores de música.

Estructura de la página

Siempre que la página tenga mas de tres o 4 párrafos el artículo deberá estar separado por secciones. Los títulos de las secciones tienen que usar la ortografía general respecto a mayúsculas y minúsculas, es decir, sólo se usarán mayúsculas para las iniciales de los nombres propios y para la primera letra del título. Consulta la sección de secciones en la guía de edición.

Líneas de Código

Las líneas de código son las líneas donde introducimos por ejemplo comandos para la terminal. Se han de introducir siempre solamente esa línea, no agregues símbolos como $ o # antes del comando, pues esto puede crear confusión a los nuevos usuarios. Por ejemplo:

Bien:

 sudo apt-get update

Mal

 ~$ sudo apt-get update

Enlaces

Consulta en Como editar páginas la manera correcta de incluir enlaces, tanto internos (enlaces dentro del mismo wiki) como externos.

Imágenes

No utilices nunca imágenes superiores a 400x300, pues deformarán el wiki sobretodo a las personas que utilicen una configuración de pantalla pequeña. No utilices imágenes indiscriminadamente. Utiliza solo las imprescindibles o minimamente necesarias para el entendimiento de la documentación.

Categorías

Puedes incluir más de una categoría a tu artículo, pero no incluyas en el mismo artículo una categoría una subcategoría a la vez. Lo correcto es incluir solo la subcategoría más baja, puesto que esto incluirá automáticamente el artículo en la categoría padre.


Sobre párrafos, signos de puntuación, etc

Has tu artículo fácil de leer, incluye signos de puntuación, una línea en blanco entre párrafos , etc. Incluye títulos y subtítulos para hacer la lectura más cómoda y de mayor accesibilidad a través del índice de la página (tabla de contenidos).

No utilices palabras como Actualmente, ahora, etc, la documentación debe ser atemporal. No crees páginas con el mismo contenido para versiones diferentes de ubuntu, lo correcto es incluir un apartado en la misma página con la versión de Ubuntu de la que quieras incluir información.

Enlaces relacionados

Es muy útil para los usuarios incluir una sección de enlaces relacionados con el artículo en cuestión, ya que facilita mucho la navegación. También puedes agregar en otras páginas el enlace a tu artículo en la sección de enlaces relacionados. Por ejemplo, si tu artículo trata sobre mp3, es útil agregar un enlace a Formatos Restrictivos

Si no estás seguro de si has dado un estilo o formato adecuado a tu artículo, añade la plantilla Plantilla:Formatear añadiendo el siguiente código al principio de la página:

 [[Plantilla:Formatear]]

Con esto incluirás una nota en tu página para que los responsables del wiki puedan darle un formato adecuado a tu artículo.

Herramientas personales