2. Project management¶
In the first week, I also learned about project management. I am going to create a website to document all my assignments, as well as my final project.
Frontend Development¶
For frontend development I will use the prepared .md files in the GitLab repository. With just little expenditure I can edit my website and create content for the projects.
Here you can find a cheatsheet for markdown tools.
Git¶
Git works as the basis for all FabAcademy Project documentations.
To get started, we need to download Git from https://git-scm.com/. I use Windows 10 and use the regular installer. The installing process works with the default settings. As a text editor for coding I use Visual Studio Code, so I set it as my standard text editor in the installation process as you can see in the picture below.
Afterwards, I create a local directory for the FabAcademy project. Inside this directory, right-click the back of the window and click “Git Bash Here”.
In the Git Bash commandline I connect our GitLab to the local git:
git config --global user.name "example"
git config --global user.email example@domain.com
Lastly, we clone our repository:
git clone https://gitlab.fabcloud.org/academany/fabacademy/2019/labs/yourLocation/students/your-name
When I am working on my project and want upload my changes, I will do the following:` To first see what I have made changes on I write
git status
As a result, I can see new, modified and deleted files as well as a comparison between gitlab and the local git. After I checked the changes and made sure I don’t have any unwanted data, I write
git add .
The “.” means to add all the modified data. Alternatively type in the file path for the single data or folder you want to commit. If you want to remove data write
git rm .
You can also add the filepath to remove a specific file. The next step is to commit your changes.
git commit -m "message"
Leaving a message is helpful for keeping the overview about what changed in which commit. With a status command between each step, I ensure that everything is going fine.
The very last step is to push your changes.
git push
If not already done, you need to verify your acces to the GitLab, read more below. If you set everything up already, Tips - use the .gitignore file to add file endings that should be ignored by git. - git ignores empty folders. -
GitLab The FabAcademy GitLab Repository was also created for us. I, for example, can find my personal repository here.
To make it able to connect Git and GitLab I need to create a key for a new branch, i.e. a different computer. Therefore I click on my little profile picture on the upper right and click “Settings”. On the left I navigate to SSH Keys and click “generate one” in the first paragraph on the right. I follow the instructions in Git Bash and enter:
ssh-keygen -t ed25519 -C "email@example.com"
Enter a directory and optionally a password and then use..
cat ~/.ssh/id_ed25519.pub | clip
..to copy the key to your clipboard.
Go back to the GitLab settings and paste the key into the big textbox on the right and click Add key.
On the first git push, git will ask for credentials. Fill in your gitlab email and password after setting up the SSH key and you should be fine.