Github manual for Ubuntu - Revision history

Ginger at 15:01, 26 September 2012

2012-09-26T15:01:06Z

← Older revision		Revision as of 09:01, 26 September 2012
Line 40:		Line 40:

	== How to use Github ==		== How to use Github ==
	When you have a local copy of your project on your system, you can edit the files (if you have the correct permission). ~~But most unexperienced users forget~~ to ~~update their local~~ copy ~~before editing or upload ("push")~~ the ~~local copy~~ to the ~~GitHub~~ repository ~~when they made a correct change~~ to ~~one or more of their files~~.		When you have a local copy of your project on your system, you can edit the files (if you have the correct permission). It is important to keep your copy up to date, so all the collections on all the systems are the same. To do so you'll need to understand the following: pulling the newest version from the repository, Adding files to the repository, commit the changes. These are the most important subject for using the repository. We will also discuss some other very usefull commands.

Ginger: /* Introduction to Github */

2012-09-26T13:21:54Z

Introduction to Github

← Older revision		Revision as of 07:21, 26 September 2012
Line 1:		Line 1:
	== Introduction to Github ==		== Introduction to Github ==
	Developers often use a ~~repository~~ for developing their software projects. ~~When using~~ a ~~repository~~, ~~developers can upload and download~~ the ~~code developed for~~ the ~~project~~. ~~Github~~ is an open source ~~repository site. For~~ more information about repository's and Github, please visit [http://en.wikipedia.org/wiki/GitHub Wiki GitHub]. If you do not have a GitHub account and you would like to contribute to a project or develop a project on your own, please register at [https://github.com/ github.com] and follow their "Bootcamp".		Developers often use a version control system for developing their software projects. <br>
			A version control system allows the creation for a collection of files (such as a software project). The user also has the opportunity to switch back to an older version of the collection.

			GitHub (git) is a distributed version control system (dvcs), it doesn't have a central server but every local copy contains the full history of the collection. GitHib is open source, for more information about repository's and Github, please visit [http://en.wikipedia.org/wiki/GitHub Wiki GitHub]. If you do not have a GitHub account and you would like to contribute to a project or develop a project on your own, please register at [https://github.com/ github.com] and follow their "Bootcamp".
	<span style="color:#FF0000"> This manual works only for ubuntu users! </span>		<span style="color:#FF0000"> This manual works only for ubuntu users! </span>

Ginger at 12:32, 26 September 2012

2012-09-26T12:32:44Z

← Older revision		Revision as of 06:32, 26 September 2012
Line 35:		Line 35:
	Cloning is a way of downloading a local copy of your project. The following command will clone the code branch, just replace "username" with you GitHub username and project name with the name of project on github: <br><br><code>$ git clone git@github.com:username/projectname.git</code><br><br>		Cloning is a way of downloading a local copy of your project. The following command will clone the code branch, just replace "username" with you GitHub username and project name with the name of project on github: <br><br><code>$ git clone git@github.com:username/projectname.git</code><br><br>
	Be aware, do not misspell the command, it won't work. If you are having trouble, read the given error and try to solve him by reading the following page: [https://help.github.com/categories/56/articles GitHub help].		Be aware, do not misspell the command, it won't work. If you are having trouble, read the given error and try to solve him by reading the following page: [https://help.github.com/categories/56/articles GitHub help].

			== How to use Github ==
			When you have a local copy of your project on your system, you can edit the files (if you have the correct permission). But most unexperienced users forget to update their local copy before editing or upload ("push") the local copy to the GitHub repository when they made a correct change to one or more of their files.

Ginger at 12:29, 26 September 2012

2012-09-26T12:29:23Z

← Older revision		Revision as of 06:29, 26 September 2012
Line 1:		Line 1:
	== Introduction to Github ==		== Introduction to Github ==
	Developers often use a repository for developing their software projects. When using a repository, developers can upload and download the code developed for the project. Github is an open source repository site. For more information about repository's and Github, please visit [http://en.wikipedia.org/wiki/GitHub Wiki GitHub]. If you do not have a GitHub account and you would like to contribute to a project or develop a project on your own, please register at [https://github.com/ github.com] and follow their "Bootcamp".		Developers often use a repository for developing their software projects. When using a repository, developers can upload and download the code developed for the project. Github is an open source repository site. For more information about repository's and Github, please visit [http://en.wikipedia.org/wiki/GitHub Wiki GitHub]. If you do not have a GitHub account and you would like to contribute to a project or develop a project on your own, please register at [https://github.com/ github.com] and follow their "Bootcamp".
			<span style="color:#FF0000"> This manual works only for ubuntu users! </span>

	== Github and Ubuntu ==		== Github and Ubuntu ==
Line 6:		Line 7:

	== Setup Github ==		== Setup Github ==
	When you have a github-account, you may install Github. Before installing Github, you need to set up the ssh keys.		When you have a github-account, you may install Github. Before installing Github, you need to set up the ssh keys. This manual will also guide you trough cloning and configurnig with github.

	=== Setup the SSH-key ===		=== Setup the SSH-key ===
	# Open the terminal in Ubuntu.		# Open the terminal in Ubuntu.
Line 27:		Line 29:
	Open the terminal and type the following command: <br> <br>		Open the terminal and type the following command: <br> <br>
	<code> $ sudo apt-get install git-core git-gui git-doc </code> <br> <br>		<code> $ sudo apt-get install git-core git-gui git-doc </code> <br> <br>

			Your terminal will download some things and install github automaticly. When it's done, your installation is complete! The next step is getting your local copy of the repository (or code-branch), follow the instructions for "Cloning".

			=== Cloning ===
			Cloning is a way of downloading a local copy of your project. The following command will clone the code branch, just replace "username" with you GitHub username and project name with the name of project on github: <br><br><code>$ git clone git@github.com:username/projectname.git</code><br><br>
			Be aware, do not misspell the command, it won't work. If you are having trouble, read the given error and try to solve him by reading the following page: [https://help.github.com/categories/56/articles GitHub help].

Ginger: /* Setup the SSH-key */

2012-09-26T12:15:50Z

Setup the SSH-key

← Older revision		Revision as of 06:15, 26 September 2012
Line 19:		Line 19:
	## Click: "SSH Keys"		## Click: "SSH Keys"
	## Click: "Add another public key"		## Click: "Add another public key"
	## Paste the copied content into the "key field" and press "Add key"		## Paste the copied content into the "key field" and press "Add key" <br> <br>
			# Open the terminal again and type the following command: <br> <br> <code>ssh-add</code> <br> <br> This is only required if you use ubuntu (which all the readers of this document should, as described in the introduction.)

	Your setup for the ssh-key is completed! Now you are ready to install github.		Your setup for the ssh-key is completed! Now you are ready to install github.

Ginger at 16:54, 25 September 2012

2012-09-25T16:54:59Z

← Older revision		Revision as of 10:54, 25 September 2012
Line 6:		Line 6:

	== Setup Github ==		== Setup Github ==
	When you have a github-account, you may install Github. Before installing Github, you need to set up the ssh keys:		When you have a github-account, you may install Github. Before installing Github, you need to set up the ssh keys.
			=== Setup the SSH-key ===
	# Open the terminal in Ubuntu.		# Open the terminal in Ubuntu.
	# Type: <br> <br><code>$cd ~/.ssh </code> <br> <br> When the terminal displays: ""bash: cd: ./.ssh:No such file or directory" you should generate a public/private rsa ket pair, continue with step 3. <br> If the terminal changes to ~/.ssh directory, continue with step 5.		# Type: <br> <br><code>$cd ~/.ssh </code> <br> <br> When the terminal displays: ""bash: cd: ./.ssh:No such file or directory" you should generate a public/private rsa ket pair, continue with step 3. <br> If the terminal changes to ~/.ssh directory, continue with step 5.
Line 22:		Line 22:

	Your setup for the ssh-key is completed! Now you are ready to install github.		Your setup for the ssh-key is completed! Now you are ready to install github.

			=== Install Github ===
			Open the terminal and type the following command: <br> <br>
			<code> $ sudo apt-get install git-core git-gui git-doc </code> <br> <br>

Ginger: /* Setup Github */

2012-09-25T16:52:11Z

Setup Github

← Older revision		Revision as of 10:52, 25 September 2012
Line 13:		Line 13:
	# Enter a suitable passphrase which is > 4 characters. If this is done, please continue with step 6.		# Enter a suitable passphrase which is > 4 characters. If this is done, please continue with step 6.
	# (Follow this step only if your terminal changed to "~/.ssh") <br> You already have some SSH-keys, following commands will backup (in folder "key_backup") and remove the keys. Type in your terminal: <br> <br> <code> $ mkdir key_backup </code> <br> <code> $ cd id_rsa* key backup </code> <br> <code> $ rm id_rsa* </code> <br> <br>		# (Follow this step only if your terminal changed to "~/.ssh") <br> You already have some SSH-keys, following commands will backup (in folder "key_backup") and remove the keys. Type in your terminal: <br> <br> <code> $ mkdir key_backup </code> <br> <code> $ cd id_rsa* key backup </code> <br> <code> $ rm id_rsa* </code> <br> <br>
			# Add the SSH-key to github, type in the terminal: <br> <br> <code> $ gedit id_rsa.pub </code> <br> <br>
			# Ubuntu will open a file, copy it's entire content:
			## Open the github site and login.
			## Go to "Account Settings" (in the upper right corner from your page).
			## Click: "SSH Keys"
			## Click: "Add another public key"
			## Paste the copied content into the "key field" and press "Add key"

			Your setup for the ssh-key is completed! Now you are ready to install github.

Ginger: Created page with "== Introduction to Github == Developers often use a repository for developing their software projects. When using a repository, developers can upload and download the code develo…"

2012-09-25T16:45:58Z

Created page with "== Introduction to Github == Developers often use a repository for developing their software projects. When using a repository, developers can upload and download the code develo…"

New page

== Introduction to Github ==
Developers often use a repository for developing their software projects. When using a repository, developers can upload and download the code developed for the project. Github is an open source repository site. For more information about repository's and Github, please visit [http://en.wikipedia.org/wiki/GitHub Wiki GitHub]. If you do not have a GitHub account and you would like to contribute to a project or develop a project on your own, please register at [https://github.com/ github.com] and follow their "Bootcamp".

== Github and Ubuntu ==
Github doesn't provide an easy step-by-step guide for using your repository with ubuntu, if you need (or would like) to use ubuntu and github together, we provide a nice and easy guide. This page will help you to Setup github for Ubuntu and use Github. At the end there will be a small summary or so called: "Cheatsheet" with the command's you might need.

== Setup Github ==
When you have a github-account, you may install Github. Before installing Github, you need to set up the ssh keys:

# Open the terminal in Ubuntu.
# Type: <code>$cd ~/.ssh </code> When the terminal displays: ""bash: cd: ./.ssh:No such file or directory" you should generate a public/private rsa ket pair, continue with step 3. If the terminal changes to ~/.ssh directory, continue with step 5.
# Open a new terminal and type: <code>$ ssh-keygen -t rsa -C "your_email@youremail.com"</code> After hitting Enter, the terminal will say: 'Generating public/private rsa ket pair. Enter file in which to save the key(/Home/ubuntu/.ssh/id_rsa):' please press only enter and the terminal will ask to enter a passphrase.
# Enter a suitable passphrase which is > 4 characters. If this is done, please continue with step 6.
# (Follow this step only if your terminal changed to "~/.ssh") You already have some SSH-keys, following commands will backup (in folder "key_backup") and remove the keys. Type in your terminal: <code> $ mkdir key_backup </code> <code> $ cd id_rsa* key backup </code> <code> $ rm id_rsa* </code>