Libro de estilo

En esta página he recogido una serie de normas que, aunque no tienen que ver directamente con la programación en Python, todos los alumnos debéis seguir para facilitar las explicaciones y la corrección de las actividades.

• distribuir las ventanas en la pantalla
• poner nombres a las carpetas y los archivos
• comentarios en los programas
• cabecera de los programas

Distribuir las ventanas en la pantalla

Normalmente, necesitarás tener abiertas dos ventanas: la ventana de IDLE y la del programa que estés editando. Una forma cómoda de trabajar es tener las dos ventanas en mosaico horizontal, con IDLE en la parte inferior y el programa que estés editando en la parte superior, como muestra la imagen.

Para conseguir esta distribución de ventanas, puedes proceder de la siguiente manera

• abre la ventana de IDLE y abre una nueva ventana con la opción de menú File / New window;
• haz clic derecho en una zona libre (sin iconos) de la barra de tareas y elige la opción Mosaico Horizontal, como muestra la imagen.

Poner nombres a las carpetas y archivos

En la carpeta Mis Documentos tienes que tener una carpeta en la que guardarás el trabajo de todo el curso. Esa carpeta se llamará 1BT, 2BCT o 2BHT, dependiendo del grupo en que estés (en las explicaciones que vienen a continuación yo escribiré BT aunque tú tengas que escribir 1BT, 2BCT o 2BHT).

Dentro de la carpeta BT, crea una carpeta que se llame BT_Python en la que guardarás todos tus programas.

Dentro de la carpeta BT_Python crea una carpeta que se llame Pruebas y, a medida que vayas haciendo los ejercicios de cada lección, crea una carpeta para cada lección. La tabla siguiente indica un par de ejemplos de:

• el nombre de la lección,
• el nombre de la carpeta que debes crear dentro de BT_Python
• el nombre de los archivos de programas (uno por programa) que debes guardar dentro de la carpeta anterior, donde XX es el número de ejercicio

Comentarios en los programas

Es importante añadir comentarios a los programas para que sean más comprensibles para los humanos (el ordenador ignora completamente el contenido de los comentarios). En Python un comentario empieza por el símbolo de almohadilla (#) y acaba al final de la línea. No es necesario comentar todas las líneas, sino sólo aquellas que lo necesiten. Por ejemplo:

Cabecera de los programas

Para poder identificar qué hace cada programa, quién lo ha escrito y cuándo, todos los programas tienen que tener una cabecera como ésta, hecha a base de comentarios:

Autor: Bartolomé Sintes Marco
Última modificación de esta página: 21 de octubre de 2002