Git - Revision history

Hw2210: Don't show redirects in see also

2026-06-05T13:53:55Z

Don't show redirects in see also

← Older revision		Revision as of 13:53, 5 June 2026
Line 90:		Line 90:
	== See also ==		== See also ==

	{{Special:PrefixIndex\|prefix=Git/\|namespace=0}}		{{Special:PrefixIndex\|prefix=Git/\|namespace=0\|hideredirects=1}}

	[[Category:Tutorial]]		[[Category:Tutorial]]

Pm2022: /* See also */

2026-06-04T00:08:17Z

Hw2210: Fix broken links

2026-06-03T20:47:33Z

Fix broken links

← Older revision		Revision as of 20:47, 3 June 2026
Line 43:		Line 43:

	== Remote Repos ==		== Remote Repos ==
	These are the web applications such as GitLab or GitHub. For bathcs.com, we use the [~~[Git config user~~.~~email "your email@abc~~.~~com" git config user~~.~~name "Your Name"~~\|Bath’s GitLab instance]] and have instructions [[Git ~~config user.email "your email@abc.com" git config user.name "Your Name"~~\|here]]. But also note Bath has a GitHub enterprise instance running [https://github.bath.ac.uk/ here].		These are the web applications such as GitLab or GitHub. For bathcs.com, we use the [https://gitlab.bath.ac.uk\|Bath’s GitLab instance] and have instructions [[Git/GitLab\|here]]. But also note Bath has a GitHub enterprise instance running [https://github.bath.ac.uk/ here].

	They normally provide many features and tools for version control, collaboration and CI/CD.		They normally provide many features and tools for version control, collaboration and CI/CD.

Hw2210 at 19:26, 3 June 2026

2026-06-03T19:26:07Z

← Older revision		Revision as of 19:26, 3 June 2026
Line 90:		Line 90:
	== See also ==		== See also ==

	* [[Git/Basic Components]]		{{Special:PrefixIndex\|prefix=Git\|namespace=0}}
	* [[Git/Special ~~files]]~~
	* [[Git/Gitlab]]
	* [[Git/Advanced]]
	* [[Git~~/Mirrors]]~~

	[[Category:Tutorial]]		[[Category:Tutorial]]

Hw2210: Add a see also section with child pages

2026-06-03T18:57:42Z

Add a see also section with child pages

← Older revision		Revision as of 18:57, 3 June 2026
Line 87:		Line 87:
	# Git is simple in the basics, and very complicated but very powerful once you dive into it. Basics are enough to have version control. Use them!		# Git is simple in the basics, and very complicated but very powerful once you dive into it. Basics are enough to have version control. Use them!
	# It’s hard to permanently lose data in git. Almost always you can restore in some way. Don’t panic. Use your favourite search engine or Dang It Git		# It’s hard to permanently lose data in git. Almost always you can restore in some way. Don’t panic. Use your favourite search engine or Dang It Git

			== See also ==

			* [[Git/Basic Components]]
			* [[Git/Special files]]
			* [[Git/Gitlab]]
			* [[Git/Advanced]]
			* [[Git/Mirrors]]

			[[Category:Tutorial]]

Hw2210: Translate from boss.bathcs.com

2026-06-03T16:58:17Z

Translate from boss.bathcs.com

New page

[https://git-scm.com/ Git] is a “version control software” which can be [https://git-scm.com/downloads downloaded on their website]. It allows for version management:

* Git keeps track and history of all changes and version of the software you are writing, and lets you:
** Revert and jump back and forth in history
** Create different versions or “branches” of your software
** Manage versions in a better way than “LATEST_COURSEWORK_X.zip”
** Easily see who last edited a line of code
* It makes collaborating on the same codebase easier

A lot of programs have ways to help you interact with git so you don’t have to go through the terminal for most things. Some programs that integrate well:

* VSCode
* All JetBrains products
* Vim with fugitive
* GitHub Desktop

If you want a UI in the terminal on:

* Lazygit (Linux/MacOS)
* GitUI (Linux/MacOS/Windows)
* And many more…

Here we will mostly focus on the parts of git and using the command line tool as it more easily translates to any of the tools above. Plus for the more complicated routines, you can only do it via the terminal.

== Alternative tutorials ==
This page is covers a lot of topics (including some commands which are a bit more advanced but useful for managing projects), and can be read all in one go or can just be used as reference. But there are also other resources which may be a bit more your speed:

* [https://www.w3schools.com/git/default.asp W3Schools git tutorials]
* [https://www.atlassian.com/git/glossary Atlassians indepth git tutorials]
* [https://rogerdudler.github.io/git-guide/ The colourful intro]
* [https://code.visualstudio.com/docs/sourcecontrol/intro-to-git Git in VSCode]
* [https://ohshitgit.com/ Git Troubleshooting]
* [https://www.youtube.com/playlist?list=PLT4sucrjsqF8kvZFcRvxfhWuTvjKrXYzE BCSS Technical Labs]

== Setup ==
When you first download git you need to do a bit of configuring before you start. This is just so when you start committing, it will come up with your name and email address.<syntaxhighlight lang="sh">
git config user.email "your_email@abc.com"
git config user.name "Your Name"
</syntaxhighlight>{{Note|text=Make sure the email is also linked to your account on GitHub or GitLab, see [[Git/GitLab|our GitLab documentation]].}}
You can also configure the name of the default branch to <code>main</code> instead of <code>master</code>. [https://sfconservancy.org/news/2020/jun/23/gitbranchname/ See why].<syntaxhighlight lang="sh">
git config --global init.defaultBranch main
</syntaxhighlight>

== Remote Repos ==
These are the web applications such as GitLab or GitHub. For bathcs.com, we use the [[Git config user.email "your email@abc.com" git config user.name "Your Name"|Bath’s GitLab instance]] and have instructions [[Git config user.email "your email@abc.com" git config user.name "Your Name"|here]]. But also note Bath has a GitHub enterprise instance running [https://github.bath.ac.uk/ here].

They normally provide many features and tools for version control, collaboration and CI/CD.

* You can <code>push</code> your local repository to them.
* Then on another device you can <code>pull</code> this code from them.
* Collaborators that work on your code can also <code>push</code> and <code>pull</code>
* You can collaborate with other people, on the same codebase
* Provides web UI for <code>git</code>
* Acts as a “cloud backup”

=== HTTP vs SSH ===
In the rest of the page, we will be using URLs to pull from remote repositories.

On both GitHub and GitLab you can do this in two ways:

* <code>http</code>, where urls look like: <code><nowiki>https://gitlab.bath.ac.uk/cs/wiki</nowiki></code>
* <code>ssh</code>, where urls look like: <code>git@gitlab.bath.ac.uk:cs/wiki</code>
{{Note|text=To convert from <code>http</code> to <code>ssh</code>, you replace <code>https://</code> with <code>git@</code> (which is the user we are sshing as) and then replace the first <code>/</code> with <code>:</code>, specifying the folder location of the repo we are copying.

It is exactly the same syntax as <code>scp</code> (or ssh copy).}}
In most cases this does not matter. With public repositories <code>http</code> does not require you to log in, however it cannot handle larger repos at lower internet speeds (as it times out).

However when you have setup 2FA, you can’t just use your credentials to login, which is what <code>https</code> normally requires. Therefore, you need to setup <code>ssh</code> to work, which also requires you to have a [[SSH keys]].

You can generate one by [[SSH keys|following our documentation]], which then you copy and paste the public key into the relavent section on GitHub or GitLab (see our [[Git/GitLab|GitLab documentation]], or the [https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account GitHub documentation]).

Once you have set up this ssh key, you should be able to clone and push to a repo without specifying your login details.

== Best Practices ==

# Follow this workflow:
## Pull main
## Create a branch
## push
## Create a pull/merge request
## Merge into main
## Pull main
# Don’t push to main directly
# Add a <code>README.md</code>
# Add <code>.gitignore</code> file: you can choose what files and folders git should ignore, for example, <code>.env</code> file containing API keys.
# Write descriptive commit and PR/MR messages
# Git is simple in the basics, and very complicated but very powerful once you dive into it. Basics are enough to have version control. Use them!
# It’s hard to permanently lose data in git. Almost always you can restore in some way. Don’t panic. Use your favourite search engine or Dang It Git

← Older revision		Revision as of 00:08, 4 June 2026
Line 90:		Line 90:
	== See also ==		== See also ==

	{{Special:PrefixIndex\|prefix=Git\|namespace=0}}		{{Special:PrefixIndex\|prefix=Git/\|namespace=0}}

	[[Category:Tutorial]]		[[Category:Tutorial]]