You only have to set this up once per machine.
I do not explain all the shell and Git commands in detail. This is sort of black box diagnostic / configuration exercise.
Go to https://github.com and make sure you are logged in.
Click green “New repository” button. Or, if you are on your own profile page, click on “Repositories”, then click the green “New” button.
Repository name: myrepo (or whatever you wish)
Public
YES Initialize this repository with a README
Click big green button “Create repository.”
Copy the HTTPS clone URL. It’s near the bottom of the right sidebar.
Go to the shell.
Take charge of – or at least notice! – what directory you’re in. pwd to display working directory. cd to move around. Personally, I would do this sort of thing in ~/tmp.
Clone myrepo from GitHub to your computer. This URL should have your GitHub username and the name of your practice repo. If your shell cooperates, you should be able to paste the whole https://.... bit that we copied above. But some shells are not (immediately) clipboard aware. Type it. Accurately.
git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
This should look something like this:
jenny@2015-mbp tmp $ git clone https://github.com/jennybc/myrepo.git
Cloning into 'myrepo'...
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), done.
Checking connectivity... done.
Make this new repo your working directory, list its files, display the README, and get some information on its connection to GitHub:
cd myrepo
ls
less README.md
git remote show origin
This should look something like this:
jenny@2015-mbp ~ $ cd myrepo
jenny@2015-mbp myrepo $ ls
README.md
jenny@2015-mbp myrepo $ less README.md
# myrepo
tutorial development
jenny@2015-mbp myrepo $ git remote show origin
* remote origin
Fetch URL: https://github.com/jennybc/myrepo.git
Push URL: https://github.com/jennybc/myrepo.git
HEAD branch: master
Remote branch:
master tracked
Local branch configured for 'git pull':
master merges with remote master
Local ref configured for 'git push':
master pushes to master (up to date)
Add a line to README and verify that Git notices the change:
echo "A line I wrote on my local computer" >> README.md
git status
This should look something like this:
jenny@2015-mbp myrepo $ echo "A line I wrote on my local computer" >> README.md
jenny@2015-mbp myrepo $ git status
On branch master
Your branch is up-to-date with 'origin/master'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
Commit this change and push to your remote repo on GitHub.
git add -A
git commit -m "A commit from my local computer"
git push
This should look something like this:
jenny@2015-mbp myrepo $ git add -A
jenny@2015-mbp myrepo $ git commit -m "A commit from my local computer"
[master de669ba] A commit from my local computer
1 file changed, 1 insertion(+)
jenny@2015-mbp myrepo $ git push
Counting objects: 3, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 311 bytes | 0 bytes/s, done.
Total 3 (delta 0), reused 0 (delta 0)
To https://github.com/jennybc/myrepo.git
b4112c5..de669ba master -> master
If you’re a new GitHub user, you will be challenged for your GitHub username and password. Provide them!
Go back to the browser. I assume we’re still viewing your new GitHub repo.
Refresh.
You should see the new “A line I wrote on my local computer” in the README.
If you click on “commits,” you should see one with the message “A commit from my local computer.”
If you have made it this far, you are ready to graduate to using Git and GitHub with RStudio. But first …
It is likely that your first push, above, leads to a challenge for your GitHub username and password.
This will drive you crazy in the long-run and make you reluctant to push. Read more here about GitHub credential caching.
Now is the perfect time to go there, since you have a functioning test repo.
When you’re read to clean up, delete the local repo in the shell:
cd ..
rm -rf myrepo/
In the browser, viewing your repo’s landing page on GitHub, click on “Settings”, near the bottom or the right sidebar.
Scroll down, click on “delete repository,” and do as it asks.
Go back to the index for the all the Git stuff.