Below is a list of tasks. By mid-semester, everyone should...
- Understand what the task is asking
- Be able to do the task
- Make it clear through your actions you understand what's happening
- Fork this repository
- Complete and check off each of the tasks below, adding content where prompted with: ??
- Note: Sometimes I give the instructions or command you need and sometimes you have to read the documentation to find it.
- After you finish, celebrate your Git proficiency! 🙌
Create a Github account and make your first commit
- Create a Github account
- Fork this repository learn-git-milestones (click the Fork button, top right).
- Edit the README file (click the pencil icon) and add your favorite emoji here: 🐬
- Commit changes to the README file directly to the master branch with the message
commit #1 from Github.com
- View the commit history and confirm your edits
Install your development environment
- Install Git on your machine
Windows: Install Git for Windows (includes Git BASH, its own version of the bash shell)
Mac:
- Install the homebrew package manager
- Install git using Homebrew
brew install git
- Set your default shell to bash
chsh -s /bin/bash
- You'll be prompted to type a password. The command line doesn't give you feedback that you're typing. Just type your password and hit enter. Backspace a lot if you make a mistake.
- On the command line, confirm Git is installed by typing
git
at the prompt and hitting enter - Install Github Desktop
- Connect your Github account in Githhub Desktop
You should be able to perform a basic Git workflow using Github.com, the command line, Github Desktop, and Git in Atom. Using four different interfaces will give you practice and help you understand Git better. You've already forked and made a commit on Github.com so let's move to Github Desktop ...
You should be able to ...
- In Github Desktop, clone the fork (you made above) learn-git-milestones ...
- File > Clone Repository > Github.com and select it ...
- Local Path: Click "Choose" and add a new folder on your computer. This will be the base folder for your work in this class:
critical-web-design
- Click "Clone" to make a local copy
- Open the repo in Atom: Repository > Open in Atom
- In Atom, edit this README file and add your second favorite emoji here: 😂
- In Github Desktop, confirm the README file was saved and shows your new changes in the Changes tab
- Commit your changes to the README file directly to the master branch with the message
commit #2 from Github Desktop
- Click Push origin to push your changes back to remote repo
- Confirm the changes to the README file were pushed: Choose Repository > View on Github
- Click on the README file and then click on History to see the history of this file
You should have a basic familiarity with the command line in case you need to do advanced Git commands. Many folks use the CLI for file editing, though I'm not going to make you suffer when we have Atom installed. You've used most of these already through a GUI (e.g. git status
, git add
, git commit
, git push
) ...
- In Github Desktop, with the learn-git-milestones repo you cloned above selected, click Repository > Open in Terminal ("Bash" in Windows?)
- Use the CLI to navigate directories
- List files in this directory:
ls
- List files in this directory, including hidden:
ls -la
- Confirm the existence of the
.git
directory (where Git versions and config are stored) - View your current directory and copy the full path:
pwd
- Open this README file in Atom and paste that path here: /c/Users/Virginia Gilliland/Documents/07 Fall 2020/Critical Web Design/learn-git-milestones
- List files in this directory:
- Use Git on the CLI
- Confirm your name and email is correct in the Git config
- View the status of your repo:
git status
- View the changed files of your repo:
git diff
- Add all changed files to the staging area
git add .
- View the status of your repo
git status
to confirm it has been staged - Commit your changes with the message
commit #3 from CLI
- Use
git push
to push those changes to your remote repo
You should be able to ...
- In Github Desktop, open this repo learn-git-milestones in Atom: Repository > Open in Atom
- In Atom, edit this README file and add your third favorite emoji here: 😊
- Create a new file
hello.txt
, add some text and save it. - Display the Git panel (click the small Git button at the bottom right).
- Select on your file(s) in Unstaged changes and confirm your changes match what you expect to see
- Double click on each file with changes to stage them
- Commit your changes directly to the master branch with the message
commit #4 from Atom
Now that we have basic Git commands out of the way use Git to create and turn in your DIG 245 assignment ...
- In Github Desktop, create a new repository ...
- Name:
dig245-a1
- Local Path: Click "Choose" and create a new folder
dig245-a1
inside thecritical-web-design
folder you made above - Click Create Repository
- This should now be your class folder's directory structure.
critical-web-design |-- dig245-a1 |-- learn-git-milestones
- Name:
- Open your new repository in Atom (with Github Desktop or drag the
dig245-a1
project folder into Atom)- Add a README file:
README.md
- In the README write your name and the date
- Use some Markdown tags
- Add a README file:
- Complete Assignment 1
- Create a file called
index.html
in your repo - See the instructions in Assignment 1
- Test your file in a web browser
- Commit and push the files to Github
- Set up a Github page "project site" for your repo
- Choose "Project site"
- Do not use a theme. Start from scratch
- In your repository settings, scroll aaaaallllll the way down to the Github Pages section, select the master branch source and click save
- Visit your project site at http://username.github.io/dig245-a1
- [x ] Paste this link into the appropriate Moodle forum
That is all that is required for DIG 245. See the ADVANCED.md
file if you would like to continue learning Git.
- Github Desktop Documentation
- Github Cheatsheet HTML and PDF
- Github Learning Lab which contains tutorials like Introduction to Github and others