Mona Bisho Website - FabLab Academy

Project Managment

Week Two.

This week assignment in Fab Academy was about introduction to fab academy and gite lab, And also publishing website using Medoc’s and markdown.

The first goals of the this week are:

Work through a git tutorial.
Build a personal site describing you and your final project.
Uploaded to the class archive.
Document everything.

Learning Outcomes:

Explore and use website development tools.

Identify and utilize version control protocols.

Spiral Development.
Failing as you can.
Make it nice.

Defining of the software & websites that I used:

Git: (version control system) To locally track changes in your project and push and pull Change from remote reposited like GitHub, Bitbaket, Gitlab.

Gitlab: Services of an open source end-to-end software that allow to host your project on a remote repo & have additional feature to help in SPLC, CI, CD in other words is an open source end-to-end software development platform with built-in version control, issue tracking, code review, CI/CD, and more.

Started with Gitlab

The first step to is to downloading Gitbash

Git Bash is an application for Microsoft Windows environments which provides an emulation layer for a Git command line experience.

Creating Account on git lab and creating new project:

I go to Gitlab and clicked on register.
Then I finish up my registration request.
I clicked on “sign in ” to enter my account.

After signing in I clicked on “My Project” to start working in my website and documentation

I opened “New Project” by entering the requirement information such as:

Project Name: Mona_website.
Project Description: The files of FabLAB will be saved here.
Visible level: public.
Then I clicked “Create Project”.

Git config –globle user.name “monabisho”
Git config –globle user.email “bo.hashim@live.com”

My next step is to generate ssh keygen which is a tool for creating new authentication key pairs for SSH. The key pairs used for automating logins and authenticating hosts. In simple word I can securely connect to Gitlab without using the username and password each time I enter.

I open Git Bash and type the following commands:

ssh-keygen -t rsa -b 4096 -C "bo.hashim@live.com"

I chose the folder where I want to save it:

I went to .ssh folder (id_rsa.pub)

Open it using Atom or any other text editor
Copy the ssh key
Go to Gitlab to copy the SSH key (Gitlab>setting>ssh keys)
Paste the key there and clicked on add key.
Then I will receive an email to conform that ssh key has been add to my account

I go to “projects” then “Mona_website”then I clicked in clone button, and copy the link under clone with ssh

I chose desktop to locate my website folder because it is much easier to find To “cloned” any project or files on Gitlab to the PC by following the steps below:

Right click on the desktop and chose “gitbash here”
Write this command git clone following with the link I copied for cloning with ssh then enter

Then Mona_project folder will appear on the desktop Now we will start to push the files to Gitlab by following this steps:

Open Mona_project folder
Right click and chose “gitbash here”
git add
git commit -m “add website file”
git push

Having a look in every command definition:

Git add: it is for adding a change directly to the work in staging area and it must be repeated every time we make a change to the files.
Git commit: it is for record the change that has been made
Git add with git commit are used to track projects versions
Git push: it is for push the changes in to the local repository to the remote repository which is gitlab in our case.

MkDocs is a fast and simple static site maker that's can build project documentation. Documentation source files are written in Markdown, and organised with a single YAML configuration file

The different between the command mkdir and touch:

The command mkdir used to create directories or folders
The command touch creates empty files.

Creating My Website

Hypertext mark-up language (HTML) is the standard mark-up language to design documents to be displayed in a web browser. And also, I will be using Markdown, which is a mark-up language that often used for writing messages in online discussion forums and can be used to create a plain text editor. The text can then be converted to HTML.

Firstly, I chose my website template by browse start bootstrap
I have chosen the template agency.
I have also downloaded Brackets; it is a kind software that allows me to make a change and edit HTML language to the website and see the changes directly.