Docs: move article "installing Git" to its topic-related dir
This commit is contained in:
Marcia Ramos
Achilleas Pipinellis
parent
82007530cb
commit
c94d6ad199
4 changed files with 101 additions and 109 deletions
|
|
@ -1,66 +1 @@
|
|||
# Installing Git
|
||||
|
||||
> **Article [Type](../../development/writing_documentation.html#types-of-technical-articles):** user guide ||
|
||||
> **Level:** beginner ||
|
||||
> **Author:** [Sean Packham](https://gitlab.com/SeanPackham) ||
|
||||
> **Publication date:** 2017-05-15
|
||||
|
||||
To begin contributing to GitLab projects
|
||||
you will need to install the Git client on your computer.
|
||||
This article will show you how to install Git on macOS, Ubuntu Linux and Windows.
|
||||
|
||||
## Install Git on macOS using the Homebrew package manager
|
||||
|
||||
Although it is easy to use the version of Git shipped with macOS
|
||||
or install the latest version of Git on macOS by downloading it from the project website,
|
||||
we recommend installing it via Homebrew to get access to
|
||||
an extensive selection of dependancy managed libraries and applications.
|
||||
|
||||
If you are sure you don't need access to any additional development libraries
|
||||
or don't have approximately 15gb of available disk space for Xcode and Homebrew
|
||||
use one of the the aforementioned methods.
|
||||
|
||||
### Installing Xcode
|
||||
|
||||
Xcode is needed by Homebrew to build dependencies.
|
||||
You can install [XCode](https://developer.apple.com/xcode/)
|
||||
through the macOS App Store.
|
||||
|
||||
### Installing Homebrew
|
||||
|
||||
Once Xcode is installed browse to the [Homebrew website](http://brew.sh/index.html)
|
||||
for the official Homebrew installation instructions.
|
||||
|
||||
### Installing Git via Homebrew
|
||||
|
||||
With Homebrew installed you are now ready to install Git.
|
||||
Open a Terminal and enter in the following command:
|
||||
|
||||
```bash
|
||||
brew install git
|
||||
```
|
||||
|
||||
Congratulations you should now have Git installed via Homebrew.
|
||||
Next read our article on [adding an SSH key to GitLab](../../ssh/README.md).
|
||||
|
||||
## Install Git on Ubuntu Linux
|
||||
|
||||
On Ubuntu and other Linux operating systems
|
||||
it is recommended to use the built in package manager to install Git.
|
||||
|
||||
Open a Terminal and enter in the following commands
|
||||
to install the latest Git from the official Git maintained package archives:
|
||||
|
||||
```bash
|
||||
sudo apt-add-repository ppa:git-core/ppa
|
||||
sudo apt-get update
|
||||
sudo apt-get install git
|
||||
```
|
||||
|
||||
Congratulations you should now have Git installed via the Ubuntu package manager.
|
||||
Next read our article on [adding an SSH key to GitLab](../../ssh/README.md).
|
||||
|
||||
## Installing Git on Windows from the Git website
|
||||
|
||||
Browse to the [Git website](https://git-scm.com/) and download and install Git for Windows.
|
||||
Next read our article on [adding an SSH key to GitLab](../../ssh/README.md).
|
||||
This document was moved to [another location](../../topics/git/how_to_install_git/index.md).
|
||||
|
|
|
|||
|
|
@ -30,18 +30,6 @@ Build, test, and deploy the software you develop with [GitLab CI/CD](../ci/READM
|
|||
| [How to use GitLab CI and MacStadium to build your macOS or iOS projects](https://about.gitlab.com/2017/05/15/how-to-use-macstadium-and-gitlab-ci-to-build-your-macos-or-ios-projects/) | Technical overview | 2017-05-15 |
|
||||
| [Setting up GitLab CI for iOS projects](https://about.gitlab.com/2016/03/10/setting-up-gitlab-ci-for-ios-projects/) | Tutorial | 2016-03-10 |
|
||||
|
||||
## Git
|
||||
|
||||
Learn how to use [Git with GitLab](../topics/git/index.md):
|
||||
|
||||
| Article title | Category | Publishing date |
|
||||
| :------------ | :------: | --------------: |
|
||||
| [Numerous _undo_ possibilities in Git](numerous_undo_possibilities_in_git/index.md) | Tutorial | 2017-08-17 |
|
||||
| [Why Git is Worth the Learning Curve](https://about.gitlab.com/2017/05/17/learning-curve-is-the-biggest-challenge-developers-face-with-git/) | Concepts | 2017-05-17 |
|
||||
| [How to install Git](how_to_install_git/index.md) | Tutorial | 2017-05-15 |
|
||||
| [Getting Started with Git LFS](https://about.gitlab.com/2017/01/30/getting-started-with-git-lfs-tutorial/) | Tutorial | 2017-01-30 |
|
||||
| [Git Tips & Tricks](https://about.gitlab.com/2016/12/08/git-tips-and-tricks/) | Technical overview | 2016-12-08 |
|
||||
|
||||
## GitLab Pages
|
||||
|
||||
Learn how to deploy a static website with [GitLab Pages](../user/project/pages/index.md#getting-started):
|
||||
|
|
|
|||
66
doc/topics/git/how_to_install_git/index.md
Normal file
66
doc/topics/git/how_to_install_git/index.md
Normal file
|
|
@ -0,0 +1,66 @@
|
|||
# Installing Git
|
||||
|
||||
> **[Article Type](../../../development/writing_documentation.html#types-of-technical-articles):** user guide ||
|
||||
> **Level:** beginner ||
|
||||
> **Author:** [Sean Packham](https://gitlab.com/SeanPackham) ||
|
||||
> **Publication date:** 2017-05-15
|
||||
|
||||
To begin contributing to GitLab projects
|
||||
you will need to install the Git client on your computer.
|
||||
This article will show you how to install Git on macOS, Ubuntu Linux and Windows.
|
||||
|
||||
## Install Git on macOS using the Homebrew package manager
|
||||
|
||||
Although it is easy to use the version of Git shipped with macOS
|
||||
or install the latest version of Git on macOS by downloading it from the project website,
|
||||
we recommend installing it via Homebrew to get access to
|
||||
an extensive selection of dependancy managed libraries and applications.
|
||||
|
||||
If you are sure you don't need access to any additional development libraries
|
||||
or don't have approximately 15gb of available disk space for Xcode and Homebrew
|
||||
use one of the the aforementioned methods.
|
||||
|
||||
### Installing Xcode
|
||||
|
||||
Xcode is needed by Homebrew to build dependencies.
|
||||
You can install [XCode](https://developer.apple.com/xcode/)
|
||||
through the macOS App Store.
|
||||
|
||||
### Installing Homebrew
|
||||
|
||||
Once Xcode is installed browse to the [Homebrew website](http://brew.sh/index.html)
|
||||
for the official Homebrew installation instructions.
|
||||
|
||||
### Installing Git via Homebrew
|
||||
|
||||
With Homebrew installed you are now ready to install Git.
|
||||
Open a Terminal and enter in the following command:
|
||||
|
||||
```bash
|
||||
brew install git
|
||||
```
|
||||
|
||||
Congratulations you should now have Git installed via Homebrew.
|
||||
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
||||
|
||||
## Install Git on Ubuntu Linux
|
||||
|
||||
On Ubuntu and other Linux operating systems
|
||||
it is recommended to use the built in package manager to install Git.
|
||||
|
||||
Open a Terminal and enter in the following commands
|
||||
to install the latest Git from the official Git maintained package archives:
|
||||
|
||||
```bash
|
||||
sudo apt-add-repository ppa:git-core/ppa
|
||||
sudo apt-get update
|
||||
sudo apt-get install git
|
||||
```
|
||||
|
||||
Congratulations you should now have Git installed via the Ubuntu package manager.
|
||||
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
||||
|
||||
## Installing Git on Windows from the Git website
|
||||
|
||||
Browse to the [Git website](https://git-scm.com/) and download and install Git for Windows.
|
||||
Next read our article on [adding an SSH key to GitLab](../../../ssh/README.md).
|
||||
|
|
@ -14,6 +14,7 @@ We've gathered some resources to help you to get the best from Git with GitLab.
|
|||
## Getting started
|
||||
|
||||
- [Git concepts](../../university/training/user_training.md#git-concepts)
|
||||
- [How to install Git](how_to_install_git/index.md)
|
||||
- [Start using Git on the command line](../../gitlab-basics/start-using-git.md)
|
||||
- [Command Line basic commands](../../gitlab-basics/command-line-commands.md)
|
||||
- [GitLab Git Cheat Sheet (download)](https://gitlab.com/gitlab-com/marketing/raw/master/design/print/git-cheatsheet/print-pdf/git-cheatsheet.pdf)
|
||||
|
|
@ -21,25 +22,37 @@ We've gathered some resources to help you to get the best from Git with GitLab.
|
|||
- [Revert a commit](../../user/project/merge_requests/revert_changes.md#reverting-a-commit)
|
||||
- [Cherry-picking a commit](../../user/project/merge_requests/cherry_pick_changes.md#cherry-picking-a-commit)
|
||||
- [Squashing commits](../../workflow/gitlab_flow.md#squashing-commits-with-rebase)
|
||||
- **Articles:**
|
||||
- [Numerous _undo_ possibilities in Git](../../articles/numerous_undo_possibilities_in_git/index.md)
|
||||
- [How to install Git](../../articles/how_to_install_git/index.md)
|
||||
- [Git Tips & Tricks](https://about.gitlab.com/2016/12/08/git-tips-and-tricks/)
|
||||
- [Eight Tips to help you work better with Git](https://about.gitlab.com/2015/02/19/8-tips-to-help-you-work-better-with-git/)
|
||||
- **Presentations:**
|
||||
- [GLU Course: About Version Control](https://docs.google.com/presentation/d/16sX7hUrCZyOFbpvnrAFrg6tVO5_yT98IgdAqOmXwBho/edit?usp=sharing)
|
||||
- **Third-party resources:**
|
||||
- What is [Git](https://git-scm.com)
|
||||
- [Version control](https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control)
|
||||
|
||||
**Third-party references:**
|
||||
|
||||
- [Getting Started - Git website](https://git-scm.com)
|
||||
- [Getting Started - Version control](https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control)
|
||||
- [Getting Started - Git Basics](https://git-scm.com/book/en/v2/Getting-Started-Git-Basics)
|
||||
- [Getting Started - Installing Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
|
||||
- [Git on the Server - GitLab](https://git-scm.com/book/en/v2/Git-on-the-Server-GitLab)
|
||||
|
||||
### Concepts
|
||||
|
||||
- Article (2017-05-17): [Why Git is Worth the Learning Curve](https://about.gitlab.com/2017/05/17/learning-curve-is-the-biggest-challenge-developers-face-with-git/)
|
||||
- Article (2016-05-11): [The future of SaaS hosted Git repository pricing](https://about.gitlab.com/2016/05/11/git-repository-pricing/)
|
||||
- GLU Course (Presentation): [About Version Control](https://docs.google.com/presentation/d/16sX7hUrCZyOFbpvnrAFrg6tVO5_yT98IgdAqOmXwBho/edit?usp=sharing)
|
||||
|
||||
## Exploring Git
|
||||
|
||||
- [Git Tips & Tricks](https://about.gitlab.com/2016/12/08/git-tips-and-tricks/)
|
||||
- [Eight Tips to help you work better with Git](https://about.gitlab.com/2015/02/19/8-tips-to-help-you-work-better-with-git/)
|
||||
|
||||
## Troubleshooting Git
|
||||
|
||||
- [Numerous _undo_ possibilities in Git](../../articles/numerous_undo_possibilities_in_git/index.md)
|
||||
- Learn a few [Git troubleshooting](troubleshooting_git.md) techniques to help you out.
|
||||
|
||||
## Branching strategies
|
||||
|
||||
- **Articles:**
|
||||
- [GitLab Flow](https://about.gitlab.com/2014/09/29/gitlab-flow/)
|
||||
- **Third-party resources:**
|
||||
|
||||
**Third-party references:**
|
||||
|
||||
- [Git Branching - Branches in a Nutshell](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell)
|
||||
- [Git Branching - Branching Workflows](https://git-scm.com/book/en/v2/Git-Branching-Branching-Workflows)
|
||||
|
||||
|
|
@ -55,17 +68,7 @@ We've gathered some resources to help you to get the best from Git with GitLab.
|
|||
|
||||
## Git LFS
|
||||
|
||||
- [Git LFS](../../workflow/lfs/manage_large_binaries_with_git_lfs.md)
|
||||
- [Git-Annex to Git-LFS migration guide](https://docs.gitlab.com/ee/workflow/lfs/migrate_from_git_annex_to_git_lfs.html)
|
||||
- **Articles:**
|
||||
- [Getting Started with Git LFS](https://about.gitlab.com/2017/01/30/getting-started-with-git-lfs-tutorial/)
|
||||
- [Towards a production quality open source Git LFS server](https://about.gitlab.com/2015/08/13/towards-a-production-quality-open-source-git-lfs-server/)
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
- Learn a few [Git troubleshooting](troubleshooting_git.md) techniques to help you out.
|
||||
|
||||
## General information
|
||||
|
||||
- **Articles:**
|
||||
- [The future of SaaS hosted Git repository pricing](https://about.gitlab.com/2016/05/11/git-repository-pricing/)
|
||||
- [GitLab Git LFS documentation](../../workflow/lfs/manage_large_binaries_with_git_lfs.md)
|
||||
- [Git-Annex to Git-LFS migration guide](https://docs.gitlab.com/ee/workflow/lfs/migrate_from_git_annex_to_git_lfs.html)
|
||||
- Article (2015-08-13): [Towards a production quality open source Git LFS server](https://about.gitlab.com/2015/08/13/towards-a-production-quality-open-source-git-lfs-server/)
|
||||
|
|
|
|||
Loading…
Reference in a new issue