View source for Git/C3/Hosting-Git-Repositories/English

'''Title of script:''' Hosting Git Repositories

'''Author:''' Priya K

'''Keywords:''' '''Video tutorial, Git, GitHub, repository, creating repository, adding files, commits, releases, creating branches, creating tags'''



{| style="border-spacing:0;"
| style="border:1pt solid #000000;padding:0.097cm;"| <center>Visual cue</center>
| style="border:1pt solid #000000;padding:0.097cm;"| <center>Narration</center>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 1:

Hosting Git Repositories
| style="border:1pt solid #000000;padding:0.097cm;"| Welcome to the spoken tutorial on''' Hosting Git Repositories'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 2:Learning Objectives   


| style="border:1pt solid #000000;padding:0.097cm;"| In this tutorial, we will learn about   

* '''Git repository hosting services'''

* Creating a '''GitHub account'''
* Creating a '''repository''' in '''GitHub''' and
* Creating a '''tag''' in the '''repository'''



|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 3:

System requirement



| style="border:1pt solid #000000;padding:0.097cm;"| To record this tutorial, I am using

* '''Ubuntu Linux 14.04''' and
* '''Firefox web browser'''

You can use any browser of your choice.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 4:

Pre-requisites


| style="border:1pt solid #000000;padding:0.097cm;"| For this tutorial, you will need a working''' Internet connection.'''

* You should also have basic knowledge of''' Git''' commands.
* If not, for relevant''' Git''' tutorials, please visit the link shown.



|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 5:

Git repository hosting services


| style="border:1pt solid #000000;padding:0.097cm;"| First let us learn about '''Git repository hosting services'''.


* There are many '''web-based hosting services''' available such as '''Bitbucket, CloudForge''' and '''GitHub'''.
* Here you can import your '''Git repositories''' free of cost.
* They provide a centralized location to share your '''repository,''' so that many people can collaborate on a project easily.
* They allow you to download and study other's projects free of cost.



|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 6:

Why GitHub


| style="border:1pt solid #000000;padding:0.097cm;"| Next we will see why to use '''GitHub'''.  

* '''GitHub''' has become the most popular website for housing Open Source Software.
* In '''GitHub''' you can view, discuss and review changes with your team effectively.  

* The procedure used in '''GitHub''', will be similar to other free '''Git hosting '''websites. 
* You can explore them yourself later.<br/> 


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next we will learn how to create an '''account''' in '''GitHub'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Open web browser >> type www.github.com >> press Enter
| style="border:1pt solid #000000;padding:0.097cm;"| Open your web browser and go to www.github.com.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to homepage
| style="border:1pt solid #000000;padding:0.097cm;"| Here in the homepage, you have to give your details for registration.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Type''' priya-spoken''' as user name

priyaspoken@gmail.com as emailid
| style="border:1pt solid #000000;padding:0.097cm;"| I will type,''' priya-spoken''' as user name and

priyaspoken@gmail.com as email id.


Please type your prefered user name and valid email id.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Type a password
| style="border:1pt solid #000000;padding:0.097cm;"| Then I will type my password.


You can give any password as per your choice.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Sign up for GitHub''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Sign up for GitHub''' button at the bottom right.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Highlight Step 2


Click on''' Free'''
| style="border:1pt solid #000000;padding:0.097cm;"| Next in '''Step 2''', we have to choose our plan.


I will choose''' Free''' plan as I want to use the free service.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Finish sign up''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Finish sign up''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next we will create a '''repository''' in '''GitHub'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' New repository''' button in right side box >> click on it
| style="border:1pt solid #000000;padding:0.097cm;"| You can see a button '''New repository ''' in the right side box.


Click on it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the verification message



| style="border:1pt solid #000000;padding:0.097cm;"| It shows a message “'''Please verify your email address'''”. 


'''GitHub''' will send a verification mail to our registered email id.


So we have to open our email account and click on the email which is sent by '''GitHub'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Open the Gmail account
| style="border:1pt solid #000000;padding:0.097cm;"| I have already signed-in to my email id which is registered with '''GitHub'''. 


Let me open it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the GitHub mail
| style="border:1pt solid #000000;padding:0.097cm;"| I have an email from '''GitHub'''. 


Let me click on it.


The subject line says, “'''Please verify your email address'''”.


If the mail is not found in your '''Inbox''', please check your '''Spam''' or '''Junk''' folders.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Verify email address''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now, click on''' Verify email address''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| On '''GitHub''' verification page
| style="border:1pt solid #000000;padding:0.097cm;"| We are redirected to the '''GitHub Homepage'''.


This indicates that we have successfully created our '''account '''in '''GitHub.'''


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| We will try to create a '''repository''' in '''GitHub'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' New repository''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' New repository''' button in the right side box.


You can see that now we are able to create '''repository'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Type''' stories''' in''' Repository Name'''
| style="border:1pt solid #000000;padding:0.097cm;"| Let us type “'''stories'''” as '''Repository Name'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' Description''' field
| style="border:1pt solid #000000;padding:0.097cm;"| If you want to give any description about the '''repository''', we can do so here.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Public''' option
| style="border:1pt solid #000000;padding:0.097cm;"| Next, I will choose''' Public''' option, which is free of cost.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Private''' option and show the payment details. 



| style="border:1pt solid #000000;padding:0.097cm;"| If we choose''' Private''' option, we have to pay some fees to keep our '''repository '''private. 


This means that other users cannot find and download our '''repository'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Again click on''' Public'''
| style="border:1pt solid #000000;padding:0.097cm;"| Let me click on '''Public '''again.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on '''Initialize this repository with a README box'''.



| style="border:1pt solid #000000;padding:0.097cm;"| Click on this checkbox,''' Initialize this repository with a README'''.


This will create a''' readme file.'''


In this file, you can write information about the usage of code or installation instructions.


It will be useful for all the collaborators.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the message “Skip this step if you’re importing an existing repository”
| style="border:1pt solid #000000;padding:0.097cm;"| However, if we are importing an existing '''repository''', this box should be unchecked.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Create repository''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Create repository''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Highlight User name and repository name
| style="border:1pt solid #000000;padding:0.097cm;"| You can see the '''repository''' name along with your user name has been created successfully.


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to '''README.md file'''


Highlight on '''README.md file'''

Point the readme writer area
| style="border:1pt solid #000000;padding:0.097cm;"| Once the '''repository''' is created, you can see the '''readme file '''label at the left bottom.


We will write some information in this file later.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' commit, branch''' and''' contributor'''
| style="border:1pt solid #000000;padding:0.097cm;"| By default, we can see a '''commit''' (i.e)''' Initial commit''', one '''branch''' (i.e)''' master''' branch and one contributor.


You can click on each link and explore them at your convenience.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Now, let us start working in this '''repository'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' New file''' button
| style="border:1pt solid #000000;padding:0.097cm;"| We will begin by adding a file to our '''repository'''.


Click on''' New file''' button in the middle panel.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Type kids-story.html
| style="border:1pt solid #000000;padding:0.097cm;"| A new form opens up for creating a file.


Here I will give the file name as''' kids-story.html'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Copy and paste the code into the file
| style="border:1pt solid #000000;padding:0.097cm;"| I will copy and paste some code into this file, from my''' Writer document,''' which I had saved earlier.


Likewise, you can add some content into your file.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Let's '''commit''' this new file now.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Scroll down the page
| style="border:1pt solid #000000;padding:0.097cm;"| Scroll down the page to give the commit message.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the '''commit message '''field
| style="border:1pt solid #000000;padding:0.097cm;"| Here in the '''commit message '''field, you can see the default message''' Create kids-story.html'''. 

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| You can keep the default message or type a new message.


I will keep the default message.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| In the extended description, type''' Added first file of the repository'''
| style="border:1pt solid #000000;padding:0.097cm;"| Here in the next field, you can also give an extended description of the '''commit'''.


So here, I will type:''' Added first file of the repository.'''

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' master''' branch
| style="border:1pt solid #000000;padding:0.097cm;"| By default, we '''commit''' to the''' master branch'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Commit new file''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Commit new file''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to kids-story.html
| style="border:1pt solid #000000;padding:0.097cm;"| Our new file''' kids-story.html''' is added to the '''repository'''.


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to 2 commits
| style="border:1pt solid #000000;padding:0.097cm;"| Notice that now the '''commit number''' is increased to two.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on 2 commits
| style="border:1pt solid #000000;padding:0.097cm;"| Let’s click on it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the three dots
| style="border:1pt solid #000000;padding:0.097cm;"| Here you can see three dots next to the''' commit message'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on the three dots
| style="border:1pt solid #000000;padding:0.097cm;"| Let me click on it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the description
| style="border:1pt solid #000000;padding:0.097cm;"| It shows the description of the '''commit'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on Create kids-story.html



| style="border:1pt solid #000000;padding:0.097cm;"| To know what we have done in the '''commit''', click on that particular '''commit message'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to the details
| style="border:1pt solid #000000;padding:0.097cm;"| Now you can see the details of the '''commit'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Go back
| style="border:1pt solid #000000;padding:0.097cm;"| Let’s go back to the '''commit list'''. 


For this click on the left arrow button at the top left corner of the browser.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to hash value
| style="border:1pt solid #000000;padding:0.097cm;"| On the right side, you can see the '''hash value''' of the '''commit'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on '''Code''' tab
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Code''' tab at the top left corner to come back to the '''repository'''.


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next let me demonstrate how to create a new '''branch''' in '''GitHub'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Branch''' drop down.
| style="border:1pt solid #000000;padding:0.097cm;"| In the left side, you can see a dropdown list labeled''' Branch'''. 


Click on it to create a new '''branch'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' Find or create a branch''' field.
| style="border:1pt solid #000000;padding:0.097cm;"| You can see a pop-up window opens up.


In the pop-up window, you can see''' Find or create a branch''' field.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Type''' new-chapter''' in '''branch name''' field
| style="border:1pt solid #000000;padding:0.097cm;"| I will type''' new-chapter''' as the new '''branch '''name and press''' Enter'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' Branch: new-chapter'''
| style="border:1pt solid #000000;padding:0.097cm;"| You can see that the''' new-chapter branch''' is created and it is our current '''branch'''.


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next, we will make a '''commit''' in the''' new-chapter branch''' to understand the '''branching process''' better.


Let’s make some changes in''' kids-story.html''' file for demonstration purpose.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on '''kids-story.html''' file
| style="border:1pt solid #000000;padding:0.097cm;"| In the '''repository''', click on''' kids-story.html''' file to open it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' edit icon >> '''click on it
| style="border:1pt solid #000000;padding:0.097cm;"| At the top right corner of the editor panel, you can see an''' edit icon.''' 


Click on it to edit this file.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Copy and paste the lines
| style="border:1pt solid #000000;padding:0.097cm;"| I will add some lines here which I have copied from my''' Writer''' document.


You can do so likewise.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to commit message
| style="border:1pt solid #000000;padding:0.097cm;"| Now, we will '''commit '''this change.


I will keep the '''default commit message''' as it is.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' new-chapter''' branch



| style="border:1pt solid #000000;padding:0.097cm;"| Here you can see the '''branch''' name''' new-chapter''' where this '''commit''' was made.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Commit changes''' button
| style="border:1pt solid #000000;padding:0.097cm;"| To '''commit''', click on''' Commit changes''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Code''' tab
| style="border:1pt solid #000000;padding:0.097cm;"| Let’s click on''' Code''' tab to go back to our '''repository'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next let’s checks the '''commits''' of''' master''' and''' new-chapter branches'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' commits''' link
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' commits''' link.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to''' Branch''' dropdown
| style="border:1pt solid #000000;padding:0.097cm;"| Here in the''' Branch''' drop down, we can select the '''branch '''name that we want to see.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Select''' master''' branch


Point to the commits
| style="border:1pt solid #000000;padding:0.097cm;"| I will select''' master branch''' in the list.


Once it is selected, the '''commits''' of the''' master branch''' will be listed.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Select''' new-chapter branch'''


Point to the commits
| style="border:1pt solid #000000;padding:0.097cm;"| To see the '''commits''' of''' new-chapter branch''', we will select''' new-chapter''' in the''' Branch''' drop down.


Now you can see the '''commits''' of''' new-chapter branch.'''


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Code''' tab
| style="border:1pt solid #000000;padding:0.097cm;"| Let’s click on''' Code''' tab to go back to our '''repository'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| Next let us see how to create a '''tag''' in '''GitHub'''.


We already know that''' tagging''' is used to mark a''' commit stage''' as important.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' releases''' link
| style="border:1pt solid #000000;padding:0.097cm;"| For example say, I want to create a '''tag''' in the''' master branch''' after adding '''kids-story.html''' file.


To create a '''tag''', first click on''' releases''' link.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Create a new release''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Create a new release''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| In the''' Tag Version''' box, type '''V1.0'''.
| style="border:1pt solid #000000;padding:0.097cm;"| A new form opens up.


In the''' Tag Version''' box, type '''V1.0'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| In the '''Release title''' box, type''' Version one'''.
| style="border:1pt solid #000000;padding:0.097cm;"| In the''' Release title''' box, type''' Version one'''.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to Write tab

Type “'''This is the version one'''”
| style="border:1pt solid #000000;padding:0.097cm;"| In the '''Write''' box we can give the description of our '''tag'''.


I will type “'''This is the version one'''”.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Click on''' Publish release''' button
| style="border:1pt solid #000000;padding:0.097cm;"| Now click on''' Publish release''' button.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Point to hash value
| style="border:1pt solid #000000;padding:0.097cm;"| Here on the left side, you can see the '''hash value''' of the latest '''commit.'''


We already know that by default, the '''tag''' will be created in the latest''' commit'''.


<nowiki><<PAUSE>></nowiki>

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| With this, we come to the end of this tutorial.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 7:

Summary


| style="border:1pt solid #000000;padding:0.097cm;"| Let us summarize.


In this tutorial, we have learnt about

* Importance of online '''Git hosting services'''
* Creating a '''GitHub account'''
* Creating a '''repository''' in '''GitHub '''and
* Creating a '''tag''' in the '''repository'''



|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 8:

Assignment


| style="border:1pt solid #000000;padding:0.097cm;"| As an assignment

* Create a '''repository''' in '''GitHub'''
* Add few files to the '''repository'''
* Edit the files and do some '''commits '''and
* Try to create '''branches''' and '''tags''' in the '''repository'''



|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 9:

Acknowledgement



| style="border:1pt solid #000000;padding:0.097cm;"| The video at the following link summarises the Spoken Tutorial project.


Please download and watch it.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 10:

Spoken Tutorial Workshops



| style="border:1pt solid #000000;padding:0.097cm;"| The Spoken Tutorial Project Team conducts workshops and gives certificates to those who pass online tests.


For more details, please write to us.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| Slide 11:

Acknowledgement



| style="border:1pt solid #000000;padding:0.097cm;"| Spoken Tutorial Project is funded by NMEICT, MHRD, Government of India.


More information on this Mission is available at the following link.

|-
| style="border:1pt solid #000000;padding:0.097cm;"| 
| style="border:1pt solid #000000;padding:0.097cm;"| This is Priya from IIT Bombay signing off. Thanks for joining.

|}