OpenHatch wiki

Open Source Comes to Campus/Curriculum/Directory: Difference between revisions

Page Discussion

Open Source Comes to Campus/Curriculum/Directory (view source)

Revision as of 02:59, 9 March 2014

887 bytes added ,  10 years ago
no edit summary
imported>Shauna
(Created page with "Hi! This is a guide to help you follow along with the "introduction to git" activity - or, if you're not at an event with a mentor, to do it on your own. == Overview (ie T...")
 
imported>Shauna
No edit summary
Line 11:
== Visiting the project on the web ==
 
Since this project is a website, we've specially configured the repository so that whenever there is a push to it, it is made visible on the web. Github allows you to do this with repositories that have the following name scheme:
<code>$user-or-organization-name.github.io</code>
 
So for the organization FOSSdirectory, we call the repository: [https://github.com/FOSSdirectory/FOSSdirectory.github.io FOSSdirectory.github.io] And we can see the site live at [http://fossdirectory.github.io/ http://fossdirectory.github.io/].
If your group's repository is called e.g. ''waffle-castle.github.io'', then you can see that the shared version is visible on the web at http://waffle-castle.github.io/. (This is just an example. Your group's repository page should be at schoolname-#.github.io (for example, princeton-1.github.io or princeton-2.github.io.)
 
You should have already signed up for Github and created a user account. (If not, [https://github.com/join do so now]!) When you make your repository, you will eventually name it {your username}.github.io.
But note that any changes in your ''fork'' won't show up there until the maintainer of the project merges those changes in.
 
== To forkForking a project on Github ==
 
To "fork" a project means to make a copy of it. You can't edit the original - somebody else owns it. But you can edit your "fork".
 
* Start out logged in to Github
Line 29 ⟶ 32:
* Notice that your browser is now visiting a copy of the project in your personal space, rather than the old, group-owned one. You should also see a "forked from..." remark in the top-left.
 
* Now it's time to rename the repository. You don't have to do this every time you fork a project, but you'll need to in order to make your site viewable on the web. To edit the repository name, go to "Settings", which is towards the bottom of the toolbar on the righthand side of your page. The top option should be the rename option. Change the repository so it's name follows the format: '''{your username}.github.io'''.
== Now, clone to it to your computer ==▼
 
▲== Now, clone to itthe repository to your computer ==
 
You have a personal copy, but it's on Github (what git calls "a remote"), and not a local copy you can easily edit. We call the process of making a local copy "cloning".
 
* On the right side, look for the clone URL
Anonymous user
Retrieved from "https://wiki.openhatch.org/wiki/Special:MobileDiff/13856"