@@ -29,9 +29,33 @@ the `--global` option sets that identity for your user on the PC that you are wo
...
@@ -29,9 +29,33 @@ the `--global` option sets that identity for your user on the PC that you are wo
## 2.: Create a new repository
## 2.: Create a new repository
Log into [https://gitlab.phaidra.org/](https://gitlab.phaidra.org/) and start a new project, choose *Create blank project* and choose a project name. Leave the rest of the settings under *Visibility level* and *Project Configuration* as they are.
Log into [https://gitlab.phaidra.org/](https://gitlab.phaidra.org/) and start a new project, choose *Create blank project* and choose a project name. Leave the rest of the settings under *Visibility level* and *Project Configuration* as they are.
In order to authenticate over https, you need to generate a *personal access token* (PAT).
- In Gitlab, navigate to User [Settings/Access tokens](https://gitlab.phaidra.org/-/profile/preferences) and select *Add new token*. About the settings:
- Token name and description are only used here on Gitlab. Recognizability is potentially useful if you plan to use different tokens for different machines.
- Expiration date is max. one year in the future. No need to worry about this because you when it has expired, you will simply get a new authentication prompt when trying to us it and can create a new token.
-**Scope**: If you prefer to stay on the safe side check read_repository and write_repository. Otherwise, you can wo with complete api access.
- Click *Create* personal access token. You will be taken back to the PAT overview site. **Do not close it!** You only have this one chance to copy your freshly generated PAT for later use. Copy your new PAT and paste it in some place safe (a message to yourself on Slack is a popular choice).
## 4.: Clone your repository to your local machine.
-**Retrieve the project URL:**
- In Gitlab, go to the site of the repository you have just created.
- Click the *Code* button. The drop down menu shows the project URL to clone the repository using HTTPS. Copy it.
- Open the GitHub desktop app. If you are opening it for the first time, you will see a prompt to log into GitHub.
- Because we are using Gitlab and not GitHub, you can *Skip this step.*
- Click *Clone a repository from the Internet...*
- In the tab URL, paste your project URL and choose a local directory to clone where the project files will be stored.
- Click *clone**
- A dialogue titled *Authentication failed* will open. It has not failed, you just need your Gitlab username (<firstname>.<lastname>@univie.ac.at) and your previously created PAT.
