Proyecto:Manual de estilo

De doc.ubuntu-es
(Diferencias entre revisiones)
Saltar a: navegación, buscar
m (Manual de estilo trasladada a Ayuda:Manual de estilo: trasladado a ayuda)
m (corrijo errores y espacios)
Línea 4: Línea 4:
  
 
== Convenciones de nombres ==
 
== Convenciones de nombres ==
 +
 
Tanto en los nombres de las páginas como en el modo de escribir, debemos utilizar siempre nombres en español/castellano, por ejemplo, en vez de utilizar términos como "ripear Cd", utiliza "extraer CD".
 
Tanto en los nombres de las páginas como en el modo de escribir, debemos utilizar siempre nombres en español/castellano, por ejemplo, en vez de utilizar términos como "ripear Cd", utiliza "extraer CD".
  
Línea 10: Línea 11:
 
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:
 
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.
+
* 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 URL 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]].
 
* 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]].
  
Línea 17: Línea 18:
 
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 ==
  
 
Las líneas de código son las líneas donde introducimos por ejemplo comandos para la terminal.
 
Las líneas de código son las líneas donde introducimos por ejemplo comandos para la terminal.
Línea 28: Línea 29:
  
 
== Enlaces ==
 
== Enlaces ==
 +
 
Consulta en [[Como editar páginas]] la manera correcta de incluir enlaces, tanto internos (enlaces dentro del mismo wiki) como externos.
 
Consulta en [[Como editar páginas]] la manera correcta de incluir enlaces, tanto internos (enlaces dentro del mismo wiki) como externos.
  
 
== Imágenes ==  
 
== 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.
+
 
 +
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 mínimamente necesarias para el entendimiento de la documentación.
  
 
== Categorías ==
 
== 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.
 
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 ==
 
== Sobre párrafos, signos de puntuación, etc ==
Haz tu artículo fácil de leer, incluye signos de puntuación, una línea en blanco entre párrafos , etc.
+
 
 +
Haz 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).
 
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 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.
+
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 ==
 
== 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.
 
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]]
 
Por ejemplo, si tu artículo trata sobre mp3, es útil agregar un enlace a [[Formatos Restrictivos]]
  
 
== Si tu artículo no se ajusta a estas convenciones ==
 
== Si tu artículo no se ajusta a estas convenciones ==
 +
 
'''No te preocupes''', otros usuarios podrán adaptarlo. 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:
 
'''No te preocupes''', otros usuarios podrán adaptarlo. 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>'''
 
   <nowiki>[[Plantilla:Formatear]]</nowiki>'''
Línea 54: Línea 60:
 
Con esto incluirás una nota en tu página para que otros editores del wiki puedan darle un formato adecuado a tu artículo.
 
Con esto incluirás una nota en tu página para que otros editores del wiki puedan darle un formato adecuado a tu artículo.
  
<!-- Categorías-->
+
<!-- Categorías -->
 
+
 
[[Categoría:Ayuda]]
 
[[Categoría:Ayuda]]

Revisión de 18:03 25 nov 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

Convenciones de nombres

Tanto en los nombres de las páginas como en el modo de escribir, debemos utilizar siempre nombres en español/castellano, por ejemplo, en vez de utilizar términos como "ripear Cd", utiliza "extraer CD".

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 URL 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 mínimamente 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

Haz 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 tu artículo no se ajusta a estas convenciones

No te preocupes, otros usuarios podrán adaptarlo. 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 otros editores del wiki puedan darle un formato adecuado a tu artículo.

Herramientas personales