Git tutorial:
- how to install
- how to set up your folders
- basic commands
Personal information
- Bio information
- Why you are taking FabAcademy
- Information about your laboratory
This week we had an introduction to the different applications used to publish our progress in the Fab Academy, we were allowed to use the different tools provided in the fab-network, We have an overview of developing languages such as MarkDown that are very easy to use since just placing some characters it is possible to enrich the text in HTML. I decided to launch my page with the help of a free template that I found in colorlib and I began to modify it manually, for this I downloaded and installed Atom, I was modifying the appearance of my page replacing codes and adding others that I was searching on the internet to give it the desired result, as I progressed I discovered that Atom is also modular and installed a plug-in that helps to preview the site in live view, this plug-in is called atom-html-preview and can be activated with the CTRL+Shift+H key combination.
HTML Coding
For the customization of my site I went to https://www.w3schools.com/ this site provide a full detail of HTML tutorials, samples and you can make test in their site to see how your code will looks like.
Here I'll give you some basic codes to star customizing your own site.
<!DOCTYPE html>
<html>
<head>
<title>Page Title</title>
</head>
<body>
<h1>This is a Heading</h1>
<p>This is a paragraph.</p>
</body>
</html>
The Basic
When creating an HTML document, one of the first things you will create is the <head> element. This contains metadata (or data about the HTML document). This includes information such as the character set, document title, document styles, scripts, etc.
Some of the elements in the <head> include the title, which is created with the <title> tag.
This title will be displayed in the browser tab. It’s also what will be indexed as the title for the page when the search engine bots crawl your website.
This also includes the <meta> element, which is often used to specify information search engines can use to describe the content in their listings. This includes the description, keywords, author information, etc. The <meta> element also specifies the character set the HTML document uses.
Creating The HTML <head> Element
To create headings, simply decide what heading you’re creating, open the heading with the regular heading tag and always remember to close the tags once you’re done.
HTML Headings Example:
- <h1>This is Your First HTML Heading</h1> (the largest)
- <h2>This is Your Second HTML Heading</h2>
- <h3>This is Your Third HTML Heading</h3>
- <h4>This is Your Fourth HTML Heading</h4>
- <h5>This is Your Fifth HTML Heading</h5>
- <h6>This is Your Sixth HTML Heading</h6>
Creating paragraphs
The next step is to start creating paragraphs. Paragraphs can be created with the <p> tag.
Example:
<p>This is a paragraph.</p>
<p>This is your second paragraph, and you will be creating many more paragraphs.</p>
I found in websitesetup this table for references, so useful...
This is how Atom looks with live preview activated
Git installation and setup
When I was ready with my first pages I started to setup the environment to upload my files to the git account in:
https://gitlab.fabcloud.org/academany/fabacademy/2020/labs/stjude/students/alex-hernandez
First installed Git for windows and the GUI
Configure git with my gitlab account
git config --global user.name"your-git-user"
git config --global user.email "your git email"
Generate ssh key
An ssh key is an identifier for the computer, to grant permissions to connect to a server, for uploading files to the git account. This key must be generated in the user's system (GitHub help).
Generate ssh key (Filename: default | passphrase: empty)
ssh-keygen -t rsa -b 4096 -C "your git email"
Start ssh agent
eval "$(ssh-agent -s)"
Add ssh key
ssh-add ~/.ssh/id_rsa
Display ssh key
cat~/.ssh/id_rsa.pub
Select and copy (CTRL+SHIFT+C to copy)
Sign in to Fab academy archive.
Go to SSH keys option on the left and paste the key on the text area (CTRL+V to paste the key)
https://gitlab.fabcloud.org/academany/fabacademy/2020/labs/stjude/students/alex-hernandez
Upload to GitLab
Create an empty folder to clone the git repository to (let's suppose you created it inside the Documents folder).
Open a terminal window with right click open git bash from here
Note: This folder must be empty.
Clone git repository to that new empty folder (when finished, this folder will contain a copy of the git repository).
git clone git@gitlab.fabcloud.org/academany/fabacademy/2020/labs/stjude/students/alex-hernandez .git
cd "your fablab folder"/students/"your name"/
Use a file manager to empty your folder (the folder with your number), and then copy all your site files to this folder.
Go back to the terminal.
git add .
git commit -m "< message >"
git push origin master
After this, go to a browser and check your webpage.
For the next commits, the commands are:
Use "cd" command to go to the repository folder on your computer, and to the folder with your number.
Update the files in your folder with the latest files of your site.
git add .
git commit -m "< message >"
git fetch origin
git rebase origin/master
git push origin master
Fab Academy Student Agreement
The Fab Academy is responsible for:
Teaching principles and practices of digital fabrication
Arranging lectures, recitations, meetings, and events for the class
Evaluating and providing feedback on student work
Offering clear standards for completing assignments
Certifying and archiving student progress
Supervising class preparation
Reviewing prospective students, instructors, and labs
Providing central staff and infrastructure for students, instructors, and labs
Fund-raising for costs not covered by student tuition
Managing and reporting on the program's finances, results, and impacts
Publicizing the program
Promoting a respectful environment free of harassment and discrimination
I am a Fab Academy student, responsible for:
Attending class lectures and participating in reviews
Developing and documenting projects assigned to introduce and demonstrate skills
Honestly reporting on my work, and appropriately attributing the work of others
Working safely
Leaving workspaces in the same (or better) condition than I found them
Participating in the upkeep of my lab
Ensuring that my tuition to cover local and central class costs is covered
Promoting a respectful environment free of harassment and discrimination
Signed by committing this file in my repository,
Alex Hernández