Browse Source

Rafa arreglando formato

Rafael Arce Nazario 8 years ago
parent
commit
b5321151dc
2 changed files with 16 additions and 23 deletions
  1. 9
    7
      README-en.md
  2. 7
    16
      README-es.md

+ 9
- 7
README-en.md View File

9
 
9
 
10
 During this semester the students in the Introduction to Computer Programming course will be participating in the project: "Engaging Introductory Programming Laboratory" (EIP). In this project, sponsored by the TUES program of the National Science Foundation, students will be able to work on laboratory experiences where they will practice the concepts and skills learned in class and obtain attractive products that will motivate them with the possibilities that Computer Science offers them.
10
 During this semester the students in the Introduction to Computer Programming course will be participating in the project: "Engaging Introductory Programming Laboratory" (EIP). In this project, sponsored by the TUES program of the National Science Foundation, students will be able to work on laboratory experiences where they will practice the concepts and skills learned in class and obtain attractive products that will motivate them with the possibilities that Computer Science offers them.
11
 
11
 
12
-Each of the laboratory experiences will use libraries and programming sections that have been developed by professors and students of the Computer Science program of the University of Puerto Rico, Río Piedras campus. When the laboratory experience is completed, the student will not only reinforce the concepts learned in class, but will also get to know products that he or she will be capable of producing with a bit more knowledge and experience in computing. 
12
+Each of the laboratory experiences will use libraries and programming sections that have been developed by professors and students of the Computer Science program of the University of Puerto Rico, Río Piedras campus. When the laboratory experience is completed, the student will not only reinforce the concepts learned in class, but will also get to know products that he or she will be capable of producing with a bit more knowledge and experience in computing. 
13
 
13
 
14
 In today's laboratory experience you will learn how we will work in the upcoming meetings, how to access the files that will be used, and how to turn in the work. You will also learn to manage the basic elements of Qt, the platform that will allow us to develop and execute projects in C++.
14
 In today's laboratory experience you will learn how we will work in the upcoming meetings, how to access the files that will be used, and how to turn in the work. You will also learn to manage the basic elements of Qt, the platform that will allow us to develop and execute projects in C++.
15
 
15
 
155
 
155
 
156
 Qt is an application used by professional developers that has many possibilities and options. In each laboratory experience we will see how to use the basic options that we will need during the semester.
156
 Qt is an application used by professional developers that has many possibilities and options. In each laboratory experience we will see how to use the basic options that we will need during the semester.
157
 
157
 
158
-For the laboratory, we will mostly use the part for editing programs in C++, but there is also an option to design graphical interfaces. This option was used to incorporate the code that presents the graphical interfaces for the laboratory experiences. Learning to use this option is not part of this course, but you can learn to use it on your own. In https://docs.google.com/file/d/0B_6PcmpWnkFBOXJxVDlUNEVfOFk/edit you can find a presentation, prepared by the student Jonathan Vélez, that shows basic aspects on how to use the option for designing graphical interfaces. 
158
+For the laboratory, we will mostly use the part for editing programs in C++, but there is also an option to design graphical interfaces. This option was used to incorporate the code that presents the graphical interfaces for the laboratory experiences. Learning to use this option is not part of this course, but you can learn to use it on your own. In https://docs.google.com/file/d/0B_6PcmpWnkFBOXJxVDlUNEVfOFk/edit you can find a presentation, prepared by the student Jonathan Vélez, that shows basic aspects on how to use the option for designing graphical interfaces. 
159
 
159
 
160
 
160
 
161
 ### Projects in C++
161
 ### Projects in C++
199
 
199
 
200
    ---
200
    ---
201
 
201
 
202
-2) Write the name of the project, select the directory where you would like to save it, press `Next` in that window and the following one, and then `Finish` in the next one.
203
 
202
 
204
-This process will create a new Qt project with the skeleton for a basic C++ program that only displays "Hello World!". Before continuing, select `Projects` in the vertical menu to the left. A window called `Build Settings` should appear. In this window, make sure the `Shadow build` checkbox is NOT selected, as shown in Figure 3.
203
+2) Write the name of the project, select the directory where you would like to save it, press `Next` in that window and the following one, and then `Finish` in the next one.
205
 
204
 
205
+    This process will create a new Qt project with the skeleton for a basic C++ program that only displays "Hello World!". Before continuing, select `Projects` in the vertical menu to the left. A window called `Build Settings` should appear. In this window, make sure the `Shadow build` checkbox is NOT selected, as shown in Figure 3.
206
+    
206
    ---
207
    ---
207
 
208
 
208
    ![figure3.png](images/figure3.png)
209
    ![figure3.png](images/figure3.png)
211
     
212
     
212
    ---
213
    ---
213
 
214
 
215
+
214
 3) Return to the window where you can edit the program by selecting `Edit` in the left menu and double clicking `Sources` and then `main.cpp`. Press the green arrow on the left menu to execute the program. The results for the program will be displayed in the terminal window. If there were any errors, these would appear in the `Issues` window in Qt.
216
 3) Return to the window where you can edit the program by selecting `Edit` in the left menu and double clicking `Sources` and then `main.cpp`. Press the green arrow on the left menu to execute the program. The results for the program will be displayed in the terminal window. If there were any errors, these would appear in the `Issues` window in Qt.
215
 
217
 
216
 4) Change the contents of `main.cpp` as such:
218
 4) Change the contents of `main.cpp` as such:
231
 
233
 
232
 ### Exercise 2: Download projects from Bitbucket
234
 ### Exercise 2: Download projects from Bitbucket
233
 
235
 
234
-The files for this laboratory experience are stored in Bitbucket. In each laboratory session, you will download the Bitbucket folder that contains the files for that laboratory experience and you will save them in the `Documents/eip` directory you created in Exercise 0. To download the corresponding folder for this laboratory experience, open the terminal, use the Linux commands to move to the `Documents/eip` directory and write the command `git clone https://bitbucket.org/eip-uprrp/introduccion.git`. Go to the `Documents/eip` directory and verify that it contains the `Introduction` folder.
236
+The files for this laboratory experience are stored in Bitbucket. In each laboratory session, you will download the Bitbucket folder that contains the files for that laboratory experience and you will save them in the `Documents/eip` directory you created in Exercise 0. To download the corresponding folder for this laboratory experience, open the terminal, use the Linux commands to move to the `Documents/eip` directory and write the command `git clone https://bitbucket.org/eip-uprrp/intro-introduccion.git`. Go to the `Documents/eip` directory and verify that it contains the `intro-introduction` folder.
235
 
237
 
236
 
238
 
237
 ### Exercise 3: Open project already created, compile and run
239
 ### Exercise 3: Open project already created, compile and run
245
 
247
 
246
 2) Load the `QtCreator` project called `Practice` by double clicking the file `Practice.pro` in the `Documents/eip/introduction` directory on your computer. In the window that appears, press `Configure Project`.
248
 2) Load the `QtCreator` project called `Practice` by double clicking the file `Practice.pro` in the `Documents/eip/introduction` directory on your computer. In the window that appears, press `Configure Project`.
247
 
249
 
248
-Each time you load or start a new project, make sure that `Shadow build` is not selected: in the menu to the left, select `Projects`, then in `Build Settings` verify that the checkbox for `Shadow build` is not selected, as we saw in Figure 3.
250
+    Each time you load or start a new project, make sure that `Shadow build` is not selected: in the menu to the left, select `Projects`, then in `Build Settings` verify that the checkbox for `Shadow build` is not selected, as we saw in Figure 3.
249
 
251
 
250
 3) As you saw previously, Qt allows you to compile and execute a program by pressing the green arrow that appears in the left column. Press the arrow and notice that you obtain a window of "Issues" that occurred when compiling. The list that appears will show you information that allows you to find and fix the errors.
252
 3) As you saw previously, Qt allows you to compile and execute a program by pressing the green arrow that appears in the left column. Press the arrow and notice that you obtain a window of "Issues" that occurred when compiling. The list that appears will show you information that allows you to find and fix the errors.
251
 
253
 
252
 4) Select the `main.cpp` file in the `Sources` directory so you can find and fix the errors.
254
 4) Select the `main.cpp` file in the `Sources` directory so you can find and fix the errors.
253
 
255
 
254
-Fix all of the errors and press the green arrow once again to compile and execute the program. Once you fix the errors, the program should open a window `Application Output` and display `Exit: 1`.
256
+    Fix all of the errors and press the green arrow once again to compile and execute the program. Once you fix the errors, the program should open a window `Application Output` and display `Exit: 1`.
255
 
257
 
256
 5) As mentioned earlier, during the compilation and execution process, Qt creates various files we should delete after terminating the program. To do this, in the `Build` option of the Qt menu, select `Clean All`.
258
 5) As mentioned earlier, during the compilation and execution process, Qt creates various files we should delete after terminating the program. To do this, in the `Build` option of the Qt menu, select `Clean All`.
257
 
259
 

+ 7
- 16
README-es.md View File

254
 4. Cambia el contenido de `main.cpp` para que sea:
254
 4. Cambia el contenido de `main.cpp` para que sea:
255
 
255
 
256
     ```cpp
256
     ```cpp
257
-
258
         #include <iostream>
257
         #include <iostream>
259
         using namespace std;
258
         using namespace std;
260
 
259
 
264
             cout << endl << "Me gusta el laboratorio de programacion." << endl;
263
             cout << endl << "Me gusta el laboratorio de programacion." << endl;
265
             return 0;
264
             return 0;
266
         }
265
         }
267
-
268
     ```
266
     ```
269
 
267
 
270
 5. Marca el botón verde del menú de la izquierda para compilar y ejecutar el programa. Saldrá una ventana que te ofrece la opción de guardar los cambios. Marca `Save all`. Al ejecutar, si no cometiste ningún error, el programa debe desplegar "Me gusta el laboratorio de programacion." en la pantalla de terminal.
268
 5. Marca el botón verde del menú de la izquierda para compilar y ejecutar el programa. Saldrá una ventana que te ofrece la opción de guardar los cambios. Marca `Save all`. Al ejecutar, si no cometiste ningún error, el programa debe desplegar "Me gusta el laboratorio de programacion." en la pantalla de terminal.
272
 
270
 
273
 ### Ejercicio 2: Bajar proyectos de Bitbucket
271
 ### Ejercicio 2: Bajar proyectos de Bitbucket
274
 
272
 
275
-Los archivos para cada experiencia de laboratorio están guardados en Bitbucket. En cada sesión de laboratorio bajarás de Bitbucket la carpeta que contiene los archivos de esa experiencia de laboratorio y los guardarás en el directorio `Documents/eip` que creaste en el Ejercicio 0. Para bajar la carpeta correspondiente a esta experiencia de laboratorio, abre un terminal, utiliza los comandos de Linux para moverte al directorio `Documents/eip` y escribe el comando `git clone https://bitbucket.org/eip-uprrp/introduccion.git`. Ve al directorio `Documents/eip` y verifica que contiene la carpeta `Introducción`.
273
+Los archivos para cada experiencia de laboratorio están guardados en Bitbucket. En cada sesión de laboratorio bajarás de Bitbucket la carpeta que contiene los archivos de esa experiencia de laboratorio y los guardarás en el directorio `Documents/eip` que creaste en el Ejercicio 0. Para bajar la carpeta correspondiente a esta experiencia de laboratorio, abre un terminal, utiliza los comandos de Linux para moverte al directorio `Documents/eip` y escribe el comando `git clone https://bitbucket.org/eip-uprrp/intro-introduccion.git`. Ve al directorio `Documents/eip` y verifica que contiene la carpeta `intro-introduction`.
276
 
274
 
277
 
275
 
278
 ### Ejercicio 3: Abrir proyecto ya creado, compilar, y ejecutar
276
 ### Ejercicio 3: Abrir proyecto ya creado, compilar, y ejecutar
281
 
279
 
282
 #### Instrucciones
280
 #### Instrucciones
283
 
281
 
284
-1. Primero borrarás los archivos creados por Qt y cerrarás los archivos del proyecto anterior. Para hacer esto, en el menú principal de Qt ve a `Build`  y selecciona `Clean all`; luego ve a `File` y selecciona `Close all projects and editors`. 
282
+1) Primero borrarás los archivos creados por Qt y cerrarás los archivos del proyecto anterior. Para hacer esto, en el menú principal de Qt ve a `Build`  y selecciona `Clean all`; luego ve a `File` y selecciona `Close all projects and editors`. 
285
 
283
 
286
-2. Carga a `QtCreator` el proyecto `Practica`  haciendo doble "click" en  el archivo `Practica.pro` en el directorio `Documents/eip/introduccion` de tu computadora. En la ventana que aparece marca `Configure Project`.
284
+2) Carga a `QtCreator` el proyecto `Practica`  haciendo doble "click" en  el archivo `Practica.pro` en el directorio `Documents/eip/introduccion` de tu computadora. En la ventana que aparece marca `Configure Project`.
287
 
285
 
288
     Cada vez que cargues o comiences algún proyecto asegúrate de que el `Shadow build` no esté seleccionado: en el menú de la izquierda, selecciona `Projects` y luego, en `Build Settings`, verifica que la cajita de `Shadow build` no esté seleccionada, como vimos en la Figura 3.
286
     Cada vez que cargues o comiences algún proyecto asegúrate de que el `Shadow build` no esté seleccionado: en el menú de la izquierda, selecciona `Projects` y luego, en `Build Settings`, verifica que la cajita de `Shadow build` no esté seleccionada, como vimos en la Figura 3.
289
 
287
 
290
 
288
 
291
-3. Como viste anteriormente, Qt te permite compilar y ejecutar el programa marcando la flecha verde
292
-que aparece en la columna de la izquierda. Presiona la flecha y nota que
293
-obtienes una ventana de "Issues" que ocurrieron al compilar. La lista
294
-que aparece te muestra información que te permitirá encontrar y corregir
295
-los errores. 
289
+3) Como viste anteriormente, Qt te permite compilar y ejecutar el programa marcando la flecha verde que aparece en la columna de la izquierda. Presiona la flecha y nota que obtienes una ventana de "Issues" que ocurrieron al compilar. La lista que aparece te muestra información que te permitirá encontrar y corregir los errores. 
296
 
290
 
297
-4. Selecciona el archivo `main.cpp` en el directorio de
298
-`Sources` para que puedas encontrar y corregir los errores. 
291
+4. Selecciona el archivo `main.cpp` en el directorio de `Sources` para que puedas encontrar y corregir los errores. 
299
 
292
 
300
-Corrige todos los errores y presiona nuevamente la flecha verde para compilar y ejecutar el programa. Una vez
301
-corrijas todos los errores, el programa debe abrir la pantalla
302
-`Application Output` y desplegar `Salida: 1`.
293
+    Corrige todos los errores y presiona nuevamente la flecha verde para compilar y ejecutar el programa. Una vez corrijas todos los errores, el programa debe abrir la pantalla `Application Output` y desplegar `Salida: 1`.
303
 
294
 
304
 5. Como mencionamos antes, durante el proceso de compilación y ejecución, Qt crea varios archivos que debemos borrar luego de terminar con el programa. Para hacer esto, en la opción `Build` del menú de Qt, selecciona `Clean All`.
295
 5. Como mencionamos antes, durante el proceso de compilación y ejecución, Qt crea varios archivos que debemos borrar luego de terminar con el programa. Para hacer esto, en la opción `Build` del menú de Qt, selecciona `Clean All`.
305
 
296
 
311
 
302
 
312
 #### Instrucciones
303
 #### Instrucciones
313
 
304
 
314
-1. Abre el enlace de "Entregas" en Moodle y entrega el archivo `main.cpp`. Recuerda utilizar buenas prácticas de programación incluyendo el nombre de los programadores como comentario al inicio de tu programa.
305
+1) Abre el enlace de "Entregas" en Moodle y entrega el archivo `main.cpp`. Recuerda utilizar buenas prácticas de programación incluyendo el nombre de los programadores como comentario al inicio de tu programa.
315
 
306
 
316
 
307