description |
---|
Created by Alyson La, @realalysonla, updated by Nicole Maneth |
- Check if Git is installed
- In the terminal type
git --version
(1.8 or higher preferred)
- In the terminal type
- If not, download Git here. Then, setup your local Git profile - In the terminal:
- Type
git config --global user.name "your-name"
- Type
git config --global user.email "your-email"
- To check if Git is already config-ed you can type
git config --list
- Type
- Create a free GitHub account or login if you already have one
COACH: Talk a little about git, version control, and open source
On your GitHub profile click “new repo” give it a name (example: rails-girls), brief description, choose the “public” repo option, and click “create repository”.
In the command line–make sure you cd
into your railgirls folder–and type:
git init
This initializes a git repository in your project
Next check if a file called README.rdoc
exists in your railsgirls directory:
ls README.rdoc
If the file doesn’t exist, create it by typing:
touch README.rdoc
COACH: Talk a little about README.rdoc
Then type:
git status
This will list out all the files in your working directory.
COACH: Talk about some of your favorite git commands
Then type:
git add .
This adds in all of your files & changes so far to a staging area.
Then type:
git commit -m "first commit"
This commits all of your files, adding the message “first commit”
Next type:
git remote add origin https://github.com/username/rails-girls.git
Your GitHub Repository page will list the repository URL, so feel free to copy and paste from there, rather than typing it in manually. You can copy and paste the link from your GitHub repository page by clicking the clipboard icon next to the URL.
This creates a remote, or connection, named “origin” pointing at the GitHub repository you just created.
Then type:
git push -u origin master
If this command results in an error like fatal: unable to access error:1407742E:SSL routines:SSL23_GET_SERVER_HELLO:tlsv1 alert protocol version
then we'll install git directly from the source. Follow the default settings. Once the installation finishes, you will have a new program called "Git Bash" on your machine. You will use this command terminal for interacting with git throughout the tutorial.
This sends your commits in your “master” branch to GitHub
Congratulations your app is on GitHub! Go check it out by going to the same url you used above: https://github.com/username/rails-girls (without the .git part)
If you want to continue making changes and pushing them to GitHub you’ll just need to use the following three commands:
git add .
git commit -m "type your commit message here"
git push origin master
COACH: Talk about what makes a good commit message (active, descriptive and short).
- Follow your fellow Rails Girls & coaches on GitHub
- Star or watch their projects
- Fork a repo, then clone and push changes to your fork. Share the changes with the originator by sending them a pull request!
- Create an issue on a project when you find a bug
- Explore other open source projects - search by programming language or key word
- Check out trygit.org
- Use a Git Cheatsheet
- Look up Git Commands at git-scm.org