1. Project management¶

WEEK ONE’S TASKS¶

• Build a personal site describing you and your final project.

• Upload it to the class archive.

• Work through a git tutorial.

===========================================================================================

WHAT IS GIT ?¶

Git is an Open Source Distributed Version Control System.

Control System: This basically means that Git is a content tracker. So Git can be used to store content — it is mostly used to store code due to the other features it provides.

Version Control System: The code which is stored in Git keeps changing as more code is added, so Version Control System helps in handling this by maintaining a history of what changes have happened.

Distributed Version Control System: Git has a remote repository which is stored in a server and a local repository which is stored in the computer of each developer. This means that the code is not just stored in a central server, but the full copy of the code is present in all the developers’ computers. Git is a Distributed Version Control System since the code is present in every developer’s computer.

============================================================================================ We started with a brief description about what is ;

GITHUB¶

Which essentially is a provider of Internet hosting for software development and version control using Git

ATOM¶

which provides open-source text and source code editor using web technologies.

To download atom

Click here

=======

To download Git

Click here

==========================================================================

Then, we proceeded to download the softwares and with an explanation on how to use them

CLONING THE REPOSITORY¶

STEP ONE : Logging into my website and clicking on the clone option

STEP TWO : Copy clone with https URL

STEP THREE : Opening GitBash and cloning the repository by typing git clone and ctrl paste the URL

NOTE : The computer may require you to enter the username and password as it does not recognize the software

STEP FOUR : clicking “enter” and this is how it should look like once successfully cloned

Here as we can see, it is now saved in my pc with all the required docs.

MODIYFING MY PORTFOLIO¶

Next, I started to modify my portfolio website in the cloud just to test things out so I edited my personal info and committed changes and viola!

MKDOCS¶

The website works using mkdocs which is a static site generator designed for building documentation websites. Documentation source files are written in Markdown, and configured with a single YAML configuration file, also written in the Python programming language, MkDocs is an open-source project with a variety of themes available. In terms of Markdown support, MkDocs does an excellent job supporting the basic syntax elements.

MARKDOWN CHEATSHEET¶

WORKING WITH ATOM¶

After downloading the repository, I wanted to work on it locally for editing it and making it easier to push the changes into the website.

STEP ONE : I opened atom and added the repository by clicking “add project”

STEP TWO : Open using version control from the welcome guide

Now I can choose which folder to work in, as I already edited my “about me” page from the cloud, I will include my picture using atom

I added the picture by copying the image to the folder of the local repository, once I added them it appears directly in atom. Here where I used this command line (![] (../location/name of the folder/name of the image.png or jpeg)

*Make sure to click “Ctrl S” after each step to ensure your work is saved.

PROBLEMS I FACED¶

Here, I faced a problem where I was unable to commit changes and the push button was not appearing so I redid the steps again, but there was no luck. I was not able to link with atom