| ... | ... | @@ -3,6 +3,7 @@ |
|
|
|
# Session 1: Tools-I
|
|
|
|
|
|
|
|
* **Time**: 2h
|
|
|
|
* **Date**: Wednesday, Jan-XX-2023
|
|
|
|
* **Goals**:
|
|
|
|
* Brief introduction to Github/Gitlab
|
|
|
|
* Create your first repository
|
| ... | ... | @@ -12,12 +13,12 @@ |
|
|
|
# Contents
|
|
|
|
|
|
|
|
* [Introduction](#introduction)
|
|
|
|
* [Introduction to Github](#introduction-to-github)
|
|
|
|
* [Our Github's account](#our-githubs-account)
|
|
|
|
* [Introduction to Git](#introduction-to-github)
|
|
|
|
* [Our Gitlab's account](#our-githubs-account)
|
|
|
|
* [Playing with repositories](#playing-with-repositories)
|
|
|
|
* [Wikis](#wikis)
|
|
|
|
* [Downloading all the files in a repo](#downloading-all-the-files-in-a-repo)
|
|
|
|
* [Creating a working repo](#creating-our-working-repo)
|
|
|
|
* [Creating your repo](#creating-our-working-repo)
|
|
|
|
* [Working with PyCharm and Github](#working-with-pycharm-and-github)
|
|
|
|
* [Opening Pycharm](#opening-pycharm)
|
|
|
|
* [Cloning our working repo](#cloning-our-working-repo)
|
| ... | ... | @@ -46,18 +47,15 @@ In the **Programming in Network Environment** subject we will learn how to creat |
|
|
|
|
|
|
|
But first, we need to learn about the tools we are going to use: [Github](https://github.com/), [Python](https://www.python.org/), [Firefox](https://www.mozilla.org/es-ES/firefox/new/) and [Pycharm](https://www.jetbrains.com/es-es/pycharm/download) (Community Edition)
|
|
|
|
|
|
|
|
## Introduction to Github
|
|
|
|
## Introduction to Git
|
|
|
|
|
|
|
|
Modern **programming projects** have thousand of lines of code and hundred of **developers** working on them. It is necessary to use **powerful tools** to manage it: [The revision control systems](https://en.wikipedia.org/wiki/Repository\_(version_control)). The projects are located into a what we call a **repository**
|
|
|
|
|
|
|
|
Currently, the two most used controls systems are [Github](https://github.com/) and [GitLab](https://gitlab.com/). Both are based on the **opensource** engine called [git](https://es.wikipedia.org/wiki/Git), developed in 2005 by [Linux Torvalds](https://es.wikipedia.org/wiki/Linus_Torvalds), the creator of the [Linux Kernel](https://en.wikipedia.org/wiki/Linux_kernel)
|
|
|
|
|
|
|
|
\
|
|
|
|
|
|
|
|
In this **course** we will use **Gitlab**
|
|
|
|
|
|
|
|
In this **subject** we will focus on the use of **Github**
|
|
|
|
|
|
|
|
### Our Github's account
|
|
|
|
### Your Gitlab's account
|
|
|
|
|
|
|
|
* Create your account on [Gitlab](https://gitlab.etsit.urjc.es/). Do not forget to send your **real name** and your **username** in the post in Aula Virtual
|
|
|
|
* Once you have your account, you can create and edit your profile Mine is [rperez](https://gitlab.etsit.urjc.es/rperez).
|
| ... | ... | @@ -144,9 +142,9 @@ We can **decompress** this file as usual to have access to all the files and fol |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Creating our working repo
|
|
|
|
### Creating your repo
|
|
|
|
|
|
|
|
In this subject, all your work will be stored in a **public Gitlab repo**. You will fork from [this repo,](https://gitlab.etsit.urjc.es/rperez/pne-studentslab) In other words, you will have your own branch. Just click on the 'fork' button on the top right and complete the requested information (select your username for the namespace and set a project slug you are happy with -as you can see I inherited a slug that is not adequate right now-).
|
|
|
|
In this cpursw, all your work will be stored in a **public Gitlab repo**. You will fork from [this repo,](https://gitlab.etsit.urjc.es/rperez/pne-studentslab) In other words, you will have your own branch. Just click on the 'fork' button on the top right and complete the requested information (select your username for the namespace and set a project slug you are happy with -as you can see I inherited a slug that is not adequate right now-).
|
|
|
|
|
|
|
|
After some seconds **your repository will be ready**. You can have a look at your main gitlab page to check that it is there.
|
|
|
|
|
| ... | ... | @@ -160,11 +158,11 @@ For developing in python we are going to use the [PyCharm IDE](https://www.jetbr |
|
|
|
|
|
|
|
Go to the **activities menu** in the top left corner and write pycharm. Click on the PyCharm icon. **CAUTION!** In the lab there are two version of the program. We will use the **Community Edition** (which is OpenSource). Make sure the icon looks like this one (squared):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
If this is **the first time** it is opened, some configuration windows will appear.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
IThe initial window will show up (maybe the program requests some other information, but that would be easy to handle):
|
|
|
|
|
| ... | ... | @@ -182,7 +180,7 @@ This window shows up. It is asking us for the location of our project in the rep |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
We just go to the browser and go to our **working repo** main page and click on the **Clone or download** button.
|
|
|
|
We just go to the browser and go to your **working repo** main page and click on the **Clone or download** button (watch out! in the image the cloned repo is a different one!).
|
|
|
|
|
|
|
|
|
|
|
|
|
| ... | ... | |
