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,7 +9,7 @@ The Introduction to Computer Programming course provides an introduction to the
9 9
 
10 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 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,7 +155,7 @@ If you want to install the Qt application on your machine, you can go to the Qt
155 155
 
156 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 161
 ### Projects in C++
@@ -199,10 +199,11 @@ Use the terminal and the command `mkdir` to create a directory `Documents/eip` f
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 209
    ![figure3.png](images/figure3.png)
@@ -211,6 +212,7 @@ This process will create a new Qt project with the skeleton for a basic C++ prog
211 212
     
212 213
    ---
213 214
 
215
+
214 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 218
 4) Change the contents of `main.cpp` as such:
@@ -231,7 +233,7 @@ This process will create a new Qt project with the skeleton for a basic C++ prog
231 233
 
232 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 239
 ### Exercise 3: Open project already created, compile and run
@@ -245,13 +247,13 @@ In this exercise you will practice how to compile, fix errors, and execute a pro
245 247
 
246 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 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 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 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,7 +254,6 @@ Utiliza el terminal y el comando `mkdir` para crear un directorio `Documents/eip
254 254
 4. Cambia el contenido de `main.cpp` para que sea:
255 255
 
256 256
     ```cpp
257
-
258 257
         #include <iostream>
259 258
         using namespace std;
260 259
 
@@ -264,7 +263,6 @@ Utiliza el terminal y el comando `mkdir` para crear un directorio `Documents/eip
264 263
             cout << endl << "Me gusta el laboratorio de programacion." << endl;
265 264
             return 0;
266 265
         }
267
-
268 266
     ```
269 267
 
270 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,7 +270,7 @@ Utiliza el terminal y el comando `mkdir` para crear un directorio `Documents/eip
272 270
 
273 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 276
 ### Ejercicio 3: Abrir proyecto ya creado, compilar, y ejecutar
@@ -281,25 +279,18 @@ En este ejercicio practicarás cómo compilar, corregir errores, y ejecutar un p
281 279
 
282 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 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 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,6 +302,6 @@ Durante cada experiencia de laboratorio cada pareja deberá entregar algunos res
311 302
 
312 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