102.182.126.5 at 12:35, 29 July 2021

2021-07-29T12:35:18Z

CRNKEE002 at 08:36, 6 February 2020

2020-02-06T08:36:46Z

CRNKEE002: /* Fetching an Existing Git Repository */

2020-02-06T08:35:51Z

Fetching an Existing Git Repository

CRNKEE002: Created page with "= Overview = Throughout the course you will be required to write and submit code and other files to an online git repository, as well as submitting it through Vula. Git is a..."

2020-02-06T08:35:28Z

Created page with "= Overview = Throughout the course you will be required to write and submit code and other files to an online git repository, as well as submitting it through Vula. Git is a..."

New page

= Overview =

Throughout the course you will be required to write and submit code and other files to an online git repository, as well as submitting it through Vula. Git is a popular version control application that allows you to keep a record of changes you have made to files over time. Additionally, by using a version controlled repository that is accessible to other collaborators, it provides a powerful way for many people to collectively build a larger system. Almost all open source projects use a version control system to enable them to work with anyone else around the world in a structured and organised manner. There are many platforms that offer free hosting services where you are able to share repositories, Github, and Gitlab are two such options. Making an account on either of these (or a similar alternative) allows you to:
# keep track of your own projects and the changes you make to them,
# work collaboratively with teammates if you choose to share your repositories with them, and
# is an increasingly common way of sharing a portfolio of your prior work with potential employers.

Git can be intimidating in the beginning, but it becomes invaluable as you progress in software development. [https://swcarpentry.github.io/git-novice/ This page] has a great guide you can follow to get well acquainted.

== GitHub and the GitHub Education Pack ==
Git is a local tool. To use online backups, it’s recommended to use a remote (online) repository management tool. GitHub is recommended because, as a student, there are many benefits which you can access. See https://education.github.com/pack to sign up.

= A Quick Git Get Go =

This sub section has a bunch of useful “recipes” to follow that will be common throughout your experience with git.

== Creating a GitHub Account and Configuring your Computer ==

<ul>
<li>Start by creating a GitHub account</li>
<li>Install git on your computer 
Lab computers already have git installed. 
If you’re using a Linux based system, this can be as simple as <code>sudo apt-get install git</code> 
If you’re using Windows, you need to [https://git-scm.com/download/win download and use an installer].</li>
<li>Once git is installed, run the following commands: 
Note: Do not do this on the lab computers. If you are on a lab computer, rather set the user.name and user.email parameters from within the created git repository, and do not use the --global flag. Only use the global flag if you’re on your own system, such as your own PC or your Pi. 

<pre>
$ git config --global user.name "Your Name"
$ git config --global user.email "github email address"
</pre></li>
<li>Git is now configured</li></ul>

== Creating a New Project ==

Git consists of three primary stages: Untracked, staged and committed. Untracked files are not tracked by the repository. Staged files are files staged for commit but not yet committed. Committed files are “saved” to git. On your local system:

* Create a folder and enter into it
* Run <code>git init</code>
* Create a new text file, for example “test.txt”
* Run <code>git status</code>
* You will see there is an untracked file. Add it to git by running <code>git add test.txt</code>
* It is possible to add all untracked files by running <code>git add .</code>
* If you run <code>git status</code> again, you will see that “test.txt” has been staged, but not yet committed. Commit test.txt by running <code>git commit -m "Created test.txt"</code>. The <code>-m</code> flag is to include a git commit message. It’s useful to use these messages to explain what has changed in this commit.

== Linking GitHub and your Local Project ==

On GitHub, create a new repository and give it a meaningful name and description. Take note of the link (something like https://github.com/<username>/<project-name>.git)

GitHub gives instructions on how to push an existing repository from the command line, but for completeness sake the commands are included here:

<pre>$ git remote add origin https://github.com/<username>/<project-name>.git
$ git push -u origin master </pre>
If you refresh the GitHub page, you should now see your files and commits.

== Understanding .gitignore ==

Related SW Carpentry link: [https://swcarpentry.github.io/git-novice/06-ignore/index.html Ignoring Things]

You may have seen the option to add a .gitginore when creating a new repository on GitHub. This is used to get Git to ignore certain files, such as interim or raw data files.

== Fetching an Existing Git Repository ==

Oftentimes you will need to fetch initial files and templates that have been created for you. If the project is on GitHub, you could navigate to GitHub, download a compressed folder, move it to the system you want to work on, unzip it, and then work with the files, it’s much easier to just run the following command:

<pre>$ git clone <GithubProjectUrl>.git</pre>
For example, fetching

← Older revision		Revision as of 08:36, 6 February 2020
Line 1:		Line 1:
		+	[[Category: Software]]
	= Overview =		= Overview =

← Older revision		Revision as of 08:35, 6 February 2020
Line 65:		Line 65:

	<pre>$ git clone <GithubProjectUrl>.git</pre>		<pre>$ git clone <GithubProjectUrl>.git</pre>
−	~~For example, fetching~~

@@ Line 14: / Line 14: @@
 = A Quick Git Get Go =
-This sub section has a bunch of useful “recipes” to follow that will be common throughout your experience with git.
+This sub section has a bunch of useful “recipes” to follow that will be common throughout your experience with git. You can also view these resources to help learn git:
 == Creating a GitHub Account and Configuring your Computer ==

Git - Revision history

102.182.126.5 at 12:35, 29 July 2021

CRNKEE002 at 08:36, 6 February 2020

CRNKEE002: /* Fetching an Existing Git Repository */

CRNKEE002: Created page with "= Overview = Throughout the course you will be required to write and submit code and other files to an online git repository, as well as submitting it through Vula. Git is a..."