Diferencia entre revisiones de «Ayuda:Manual de estilo»

De Guía Ubuntu
Saltar a: navegación, buscar
(Las capturas de pantalla)
(Las capturas de pantalla)
Línea 104: Línea 104:
 
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.
 
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). 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:
+
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:
  
 
<pre>
 
<pre>
Línea 114: Línea 114:
  
 
{{Nota|Si tienes pocos colores, el forma PNG ocupa menos tamaño. Si por el contrario tiene muchos, es probable que en formato JPG ocupe menos. Si queremos emborronar partes de la imagen para evitar que muestre información personal, lo mejor es usar el formato JPG ya que el degradado genera un montón de colores.}}
 
{{Nota|Si tienes pocos colores, el forma PNG ocupa menos tamaño. Si por el contrario tiene muchos, es probable que en formato JPG ocupe menos. Si queremos emborronar partes de la imagen para evitar que muestre información personal, lo mejor es usar el formato JPG ya que el degradado genera un montón de colores.}}
 +
 +
Para que las imágenes no invadan la sección siguiente prueba con:
 +
 +
<pre>
 +
<br style="clear:both;">
 +
</pre>

Revisión de 18:11 9 jul 2006

Nota clasica.png 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:

  1. Instalación
    1. Descarga
    2. Actualización desde Breezy
    3. Instalación limpia
  2. Primeros pasos
    1. Activar universe-multiverse
    2. Añadir aplicaciones
    3. Multimedia - Instalar codecs
    4. Instalar la impresora
  3. Usuario doméstico
    1. Personalizar el entorno
    2. Accesorios
    3. Ofimática
    4. Video
    5. Audio
    6. Internet
    7. Juegos
    8. Migración desde Windows
    9. Interoperabilidad con Windows
    10. Xgl
  4. Administración del sistema
    1. Escritorios remotos
    2. Optimización
    3. Securización
      1. Actualización de paquetes
      2. Desactivación de servicios
      3. Cortafuegos
    4. Recuperación de desastres
    5. Instalación de software
      1. Servidor web
      2. Servidor de correo
      3. Servidor de FTP
    6. Compartición de ficheros e impresoras en red
  5. Conoce tu sistema
    1. Los procesos
    2. El arranque
    3. Sistema de ficheros
    4. Configuración de red
  6. Programación

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.

Estas categorías principales no se deberán modificar sin consultar previamente con algunos de los administradores de la guía

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 formatp PNG. Algunas veces pude que sea más grande del tamaño aconsejado. En ese caso la mejor opción es convertirla a formato JPG.


Nota clasica.png Si tienes pocos colores, el forma PNG ocupa menos tamaño. Si por el contrario tiene muchos, es probable que en formato JPG ocupe menos. Si queremos emborronar partes de la imagen para evitar que muestre información personal, lo mejor es usar el formato JPG ya que el degradado genera un montón de colores.

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

<br style="clear:both;">