1. Project Management¶
Background Information¶
What is git & gitlab¶
Before we Start, we must know what git and gitlab is: -
1. git is a fast, scalable, distributed revision control system. it is a free and open source distributed version designed to handle everything from small to very large proects with speed and efficiency
2. gitlab Open source self-hosted Git management software. GitLab offers git repository management, A single GitLab server can handle more than 25,000 users
Difference: Git can be classified as a tool in the “Version Control System” category, while GitLab is grouped under “Code Collaboration & Version Control”[ Source ].
What is Markdown¶
it is in comparison to other programs in coding a lightweight markup language used to add formatting elements, it is in comparison to html pages much easier to use.
What is Mkdocs¶
it is a Python package that allows you to build static pages using MarkDown [ Source ]
How to add Headers, Images and resize them¶
- Add Headers using them using the ’#’
- Add Images using
and adding [image name] (file location) and .. to trace back and / to indicate next file, Example: (../images/week01/img.jpg)
- Resize Images using I love Img Website link, Note that size of image is in pixels represented as width x height (620x320), when cropping images and change image pixel size it decreases the size of the image storage (Example: from 1 MB to 0.3 Kb)
What is push and pull¶
- The Push is the process of sending the files into the repository to keep them there and update them
- while Pull is the process of updating the files the user has from someone else push(admin) or previous push by the user
- Difference: Push is from user to website repository update while Pull is the website repository to user update
How I Created a MarkDown Page¶
1. download atom editor¶
Download Atom Editor from their site
2. create an .md file¶
create an .md file by saving a text file with .md at the end
3. learn to write in markdown language¶
Open Markdown Cheat Sheet to find the right way to implement your ideas into your page
4. write the codes into my file using atom¶
write the codes that you need into your page
5. download python, pip and mkdocs using windows powershell¶
use python website to download the latest version of python and the codes from mkdocs download site to download pip and mkdocs from windows powershell
6. creating the mkdocs and index¶
you can create these files as shown in the picture by pressing the right click on the mouse and create file option
7. running the mkdocs file¶
Mkdocs file is run through Windows Powershell, you are to find its folder then execute it with the serve order, after that you will recieve a link that you need to browse in order to view your website
8. viewing the website¶
after browsing the link that was given in windows powershell, you will be able to view your website page
Git Lab Access¶
Necessary Steps¶
Tamkeen Registration¶
Fablab.io Registration¶
Gitlab Registration¶
GitBash Download¶
Gitlab fabcloud Update¶
Cloning¶
- Login to Gitlab Fabcloud.
- Select Projects.
- Select the Project related to Fablab Bahrain.
- Select Clone.
- Copy the link listed in the Clone with HTTPS.
- Open GitBash
- Add “git clone” then paste the link you copied, then press enter.
Uploading¶
- enter the following codes as listed below “cd ” + Enter.
- enter the following codes as listed below “cd file.name ” + Enter.
- enter the following codes as listed below “git add . ” + Enter.
- enter the following codes as listed below “git commit “push name” ” + Enter.
- enter the following codes as listed below “git push” + Enter.
- after doing these steps, the files will get updated and you can check on them in your projects page, as soon as it updates you will find the push name and a tick mark.
Final Result¶
