Project Management¶
This week is an introductionary to the website. The intern is expected to build their own personal site. The intern is responsible for editing their site and documenting everything they do for the whole internship period, as they will be assessed based on what is available on their page.
Git¶
Git is a software for tracking changes in any set of files. It is usually used for coordinating work among a group of individuals during project development.
Get Started for MacOS¶
The installation of Git on your workstation is straightforward and easy.
Install Homebrew¶
- Visit brew website and copy the link then paste it on the Terminal window on your MacBook
Once the installation is completed successfully, you will be able to go the next step.
Install Git¶
- Sign in into your GitLab page
- Go to Menu > Projects
- Select the project you want to work on
- On your project page, click on Clone > Clone with HTTPS, and copy the link provided
- Open your Terminal window, and type
git clone
followed by the copied link.
Generate SSH Key¶
-
Open a Terminal window. Then type
ssh-keygen -t
followed by the key type. For example, a 2048-bit RSA key type code isssh-keygen -t rsa -b 2048
-
The next step is to take the content of id_rsa.pub PIPE to SSH command. For that, type on a Terminal window
cat ~/.ssh/id_rsa.pub
pwd
mkdir fab
cd fab
git clone YourWebsiteLink
Hint: To get your website link, open your project page and click on Clone > Clone with SSH.
Atom¶
Atom is an open-source text and source code editor.
Installation for MacOS¶
Open atoms website in your browser, and click on Download. It will automatically be downloaded on your desktop.
Note that installation is only available for macOS 10.10 version or later.
GitHub with Atom¶
To make things easier for you, and to allow you to edit your code while you are offline, you can now link GitHub with Atom. Why? to update your edited website periodically using the easiest tool.
To link GitHub with Atom:
- Open Atom application
- Enter your username and your email
- Select for all repositories option
Congratulations!
You can now start editing and writing new codes.
Useful Links¶
FAQ¶
1. How to save my work on Atom directly to my website?
Saving your edited page is a very simple procedure. For MacOS users, follow the next steps:
- Click on
cmd⌘+S
to save your work - Your saved work will appear on the right side of Atom page in a category called Unstaged Changes
- Click on Stage All option
- Write a message with the changes you made on Commit message box
- Press Commit to master
- Press Push at the bottom of the page
Your work will now be saved to the website. This process may take 2-3 minutes.
2. What is the code used to add pictures to my page?
![](../picture_link)
You can get the picture’s link after uploading the picture on your GitHub page.
3. What is the code used to add website links to my page?
You can use the following code [text](website_link)
4. How can I fix the picture in the center, and change its size?
You can include the following code in your page whether you are using atoms, or editing it directly on GitHub.
<p align="center">
<img src="imagelink" width="100" height="100"/>
</p>
5. How can I preview my work in Atoms?
Open Atoms, then go to Packages > Markdown Preview > Toggle Preview