kotovalexarian-likes-gitlab
/
gitlab-org--gitlab-foss
1
0
Fork 0
Code Releases Activity

fixed/enhanced command-line documentation

This commit is contained in:
Edwin Torres 2018-06-12 07:51:11 +00:00 committed by Achilleas Pipinellis
parent e4c1ada452
commit bc7787b977
1 changed files with 45 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
doc/gitlab-basics/command-line-commands.md
View File

@ -7,17 +7,19 @@ In Git, when you copy a project you say you "clone" it. To work on a git project
When you are on your Dashboard, click on the project that you'd like to clone.
To work in the project, you can copy a link to the Git repository through a SSH
or a HTTPS protocol. SSH is easier to use after it's been
[setup](create-your-ssh-keys.md). While you are at the **Project** tab, select
HTTPS or SSH from the dropdown menu and copy the link using the 'Copy to clipboard'
[set up](create-your-ssh-keys.md). While you are at the **Project** tab, select
HTTPS or SSH from the dropdown menu and copy the link using the _Copy URL to clipboard_
button (you'll have to paste it on your shell in the next step).
![Copy the HTTPS or SSH](img/project_clone_url.png)
## On the command line
This section has examples of some basic shell commands that you might find useful. For more information, search the web for _bash commands_.
### Clone your project
Go to your computer's shell and type the following command:
Go to your computer's shell and type the following command with your SSH or HTTPS URL:
```
git clone PASTE HTTPS OR SSH HERE
@ -25,33 +27,45 @@ git clone PASTE HTTPS OR SSH HERE
A clone of the project will be created in your computer.
>**Note:** If you clone your project via an URL that contains special characters, make sure that they are URL-encoded.
>**Note:** If you clone your project via a URL that contains special characters, make sure that characters are URL-encoded.
### Go into a project, directory or file to work in it
### Go into a project directory to work in it
```
cd NAME-OF-PROJECT-OR-FILE
cd NAME-OF-PROJECT
```
### Go back one directory or file
### Go back one directory
```
cd ../
cd ..
```
### View what’s in the directory that you are in
### List what’s in the current directory
```
ls
```
### Create a directory
### List what’s in the current directory that starts with `a`
```
ls a*
```
### List what’s in the current directory that ends with `.md`
```
ls *.md
```
### Create a new directory
```
mkdir NAME-OF-YOUR-DIRECTORY
```
### Create a README.md or file in directory
### Create a README.md file in the current directory
```
touch README.md
@ -62,6 +76,12 @@ nano README.md
#### Press: enter
```
### Show the contents of the README.md file
```
cat README.md
```
### Remove a file
```
@ -74,12 +94,18 @@ rm NAME-OF-FILE
rm -r NAME-OF-DIRECTORY
```
### View history in the command line
### View command history
```
history
```
### Execute command 123 from history
```
!123
```
### Carry out commands for which the account you are using lacks authority
You will be asked for an administrator’s password.
@ -88,8 +114,14 @@ You will be asked for an administrator’s password.
sudo
```
### Tell where you are
### Show which directory I am in
```
pwd
```
### Clear the shell window
```
clear
```