Diferencia entre revisiones de «Ayuda:Manual de estilo»

Revisión de 09:11 26 jul 2006

A todos los colaboradores: Por favor, no copiéis y peguéis el contenido de la antigua guía en esta. Queremos hacer una cosa nueva, con más y mejor contenido.

Introducción

Hemos visto que habéis empezado a añadir contenidos a esta nueva guía de Dapper. Antes de nada nos gustaría daros unas directrices sobre cómo añadir información:

• El título principal de la página ya viene puesto, por lo que las secciones irán como titulares de nivel 2 (Con dos signos de igual rodeando el nombre del título). Un atajo es pulsar sobre el botón con la letra A grande de la barra de edición.

• Ahora ya no va a ser una colección de ¿Cómo instalar...? ya que la inmensa mayoría de las veces se limita a un aptitude install pepito. Ahora las sección deberían tener el nombre del programa o una cadenas más explícita. También habría que explicar un poco sobre el programa e idealmente una captura de pantalla.

• Los programas que ya vienen instalados por defecto en Ubuntu no hace falta explicar como se instalan.

• Para instalaciones normales de programas que ya se encuentran en los repositorios, en lugar de poner la consabida línea $sudo aptitude install pepito hacer una referencia al apartado Primeros pasos/Añadir aplicaciones donde se explican los diversos métodos de instalación que existen.

Añadir nuevos puntos

No más entradas del estilo ¿Cómo instalar...?. La anterior guía se estaba convirtiendo en una acumulación de instrucciones de instalación que, por lo general, aportaban muy poca información al usuario. Las entradas cuya única información era un:

$ sudo aptitude install pepito

ya no deben existir. Se especificará el nombre del paquete y un enlace a la página dónde se explica, de forma única, como instalar programas en Ubuntu (Primeros pasos/Añadir aplicaciones). Así no forzamos a utilizar una consola y la gente puede usar una aplicación gráfica para estos menesteres como es Synaptic. Tampoco tiene ningún sentido explicar como instalar aplicaciones que ya vienen por defecto instaladas en Ubuntu Dapper.

En la portada hay un índice que categoriza la información que hay en el wiki:

Cualquier aportación que añadamos iría dentro de alguna de las categorías o puntos. Tendrás que editar la portada para añadir el enlace a la página en la que vas a añadir la aportación. Cada aportación nueva irá en una página individual. En la otra guía había muchos puntos en algunas páginas y era lento de ver.

A la hora de comentar las bondades de una determinada aplicación, la aportación debería tener estos apartados:

• Descripción de la aplicación
  • Comentar características de la misma
  • Paquete que tenemos que instalar y/o proceso de instalación si lo requiere
  • Captura de pantalla con el tema por defecto de Ubuntu Dapper (por homogeneidad)
• Configuración
  • Alguna cosa que debamos saber sobre la configuración
  • Características que deberíamos tener habilitadas por defecto

Actualizando el cambio

En el campo Resumen puedes escribir una breve descripción de la modificación. Teniendo en cuenta que somos muchos lo que estamos viendo y modificando las páginas del wiki constantemente, es muy buena idea rellenar siempre este campo que se mostrará en el historial de la página. Asi de un vistazo vemos que ha pasado entre una versión y otra de la página.

En la página de edición tenemos debajo del área de texto editable unos botones y controles. Con el botón Grabar la página envías la modificación al servidor y está visible para el resto del mundo casi instantáneamente. Por ello siempre antes de enviar los cambios hay que previsualizar lo que hemos editado para comprobar que todo está bien escrito y tiene el aspecto correcto. El botón Mostrar previsualización se encarga de esto.

Si no estamos seguros de qué hemos modificado en área de texto, con el botón Mostrar cambios se verá una lista con las diferencias entre la página original y nuestra modificación.

El controvertido tema de las firmas

En estos momentos veo que hay un pequeño lío sobre el tema de firmar aportaciones. Mucha gente cree que no se deben firmar. No se si por tratarse de una norma de la Wikipedia, ya que ,en un principio, la página de ayuda en la edición de esta guía era la misma que la de la Wikipedia. Esto supongo que es debeido a que si un artículo tiene muchas modificaciones por parte de varias personas, al final habrá un montón de firmas. Y no queda muy bonito que haya más firma que texto :)

Esto ha desembocado en usuarios que borran las firmas de otros y el consiguiente malestar de los firmantes que se quejan del extraño anonimato al que se quiere llevar esto. Los administradores pensamos que los usuarios tienen derecho a firmar sus aportaciones si lo desean. También queremos aclarar que el hecho de no firmar una aportación no la hace anónima, ya que el historial aparecen todas las modificaciones hechas a una página junto con su autor. Pero insistimos en que si alguien lo desea, puede firmar explícitamente.

Las capturas de pantalla

Siempre es recomentable que el artículo tenga una captura del pantalla de la aplicación sobre la que se escribe. Para capturar sólo la venta del programa basta con pulsar la tecla Alt + Imprimir Pantalla. El nombre del fichero en cuestión será solamente el nombre de la aplicación sin la palabra Pantallazo que pone programa que realiza las capturas.

Para evitar líos sobre el tamaño con el que aparecen las capturas en los artículos, lo mejor es decirle que sean del tipo muestra (thumbnail en inglés, aunque la abreviatura thumb también es válida). Este es un parámetro global de la configuración del Wiki y asegura que todas tendrán el mismo tamaño. El formato de la inclusión de la imagen será el siguiente:

[[Imagen:NombreAplicacion.jpg|thumbnail|right|Breve descripción de la captura.]]

Hay que prestar atención a los mensajes que da el wiki a la hora de subir las imágenes. Por defecto, la aplicación de capturas de pantalla guarda las imágenes en formato PNG. Es preferible usar imágenes en formato JPG por lo que tendrás que convertirlas usando algún programa con el Gimp. La abres con Gimp y le das a la opción Guardar como... y le cambias la extensión .png por .jpg. Si en la aplicación de captura cambias la extensión no la cambiará de formato: será un imagen con formato PNG con extensión .jpg.

Aunque ocupen algunas veces un poco más, es preferible usar las imágenes en formato JPG ya que las imágenes de muestra (thumnail) tiene mayor calidad.

Para que las imágenes no invadan la sección siguiente prueba con:

<br style="clear:both;">