GitHub.com is a web-based Git repository hosting service.
GitHub allows users to have an unlimited number of public repositories under 2GB each. Meaning your source code is publicly available to the world for them to view and fork (copy). This is great, as it encourages “open source” software projects. Open source software encourages the development of shared knowledge and progress within the open source community. It also means that all code is publicly viewable.
As you saw in the above video, GitHub also provides advanced collaboration tools. This is not something you will use much this semester. However, it is important to know about and you will use it in future projects.
GitHub also provides a service known as GitHub pages. This service provides free static website hosting. This is what you will primarily use this semester to host your web projects. (Did I mention it is free! This means you do not have to purchase server providers from another company.)
Each repository also contains a community-editable wiki page, which can provide in depth information and how-to tutorials on a specific project.
The Issues tracker serves as a place for people to create new “issue” or “feature requests”. This can then be used to assign people to work on these issues, ask for help from other users, or track the progress of a new feature.
This course, the one you are looking at right now, is being provided to you entirely through GitHub.
The website you are looking at now is hosted via GitHub pages.
Also, almost all of the resources for this course that you will need are available from a course repo. Eventually, I will show you how to “clone” the course repo to your own machine so that you can have easy access to these resources.
You will submit links to your homework assignments to the wiki page for the course repo. This will allow you to see each others work as well.
The wiki will also be somewhere that you can post resources
Finally, you will be expected to log “issues” which might be problems or questions. You will also be expected to respond to at least one issue every week.
First, visit GitHub.com and create a new user account. (Step 1 should have been completed during week-01)
NOTE: Please choose a username that you are comfortable with being part of your publicly visible URL. Ideally, this should be your name or something similar. Your username will be publicly available and used often for many things throughout this course and your entire time on GitHub.
After creating a GitHub account, the next step is to link it to SourceTree (or the GitHub Desktop App).
Our repository does not exist on GitHub.com yet, instead, we only have a local copy of it, without any remote version. This means we need to tell the destination remote server to create the repository, assign it a unique URL, and create space for the associated data.
See Below if you are on a PC OR have decided to use GitHub Desktop
cmd
+ ,
) and navigate to the “Authentication” tab.control
+ ,
) and navigate to the “Accounts” tab.Finally, lets add our “341-work” Git repo to GitHub.com.
This will bring you to your new repo in GitHub.com. At the top should be an HTTPS link. Select and copy this link (also ensure HTTPS is selected as opposed to SSH).
The process of linking GitHub Desktop to GitHub.com is a rather straight forward procedure.
From GitHub desktop this is done very easily by pressing the “Publish” button on the top-right of the application window.
When the publish window comes up, label the repository as you would like (probably, “341-work”), add a description, make sure your account is selected under “Account:” and press the “Publish Repository” button.
If you don’t get an error message, you should be good to go. To check if all your files uploaded and the repo was created successfully, you should navigate to github.com. You can do this the normal way by opening your browser and simply typing in the site address, or you can right-click in the repo, from the repository browser on the left and select “View on GitHub”.
The button that used to say “Publish” should now say “Sync”. Whenever you commit new changes to your Git repo via GitHub Desktop, you need to remember to press “Sync” when you are done working. This “pushes” you changes to the remotely hosted version of your repository on GitHub.com.
To verify success in pushing the repo, go to GitHub.com. You should see “341-work” under “Your repositories”.
Select your 341-work repository. You should see the files you added to your repo on the GitHub.com site.
You can now select any of these files to view their contents.
Likewise, you can select the “commits” tab to see all of the commits you have made in your repo so far.