diff --git a/getting-code.md b/getting-code.md index 88d07e9..7a64a03 100644 --- a/getting-code.md +++ b/getting-code.md @@ -1,9 +1,53 @@ +# Creating and Cloning a Repository ## Setting up a new repository +Lets look at how you can set up a new remote repository on Gitlab/Github, so you are ready to start committing your code. the easist way is to create a new repository in Gitlab/Github, clone it locally then start adding your files to it. We'll look at this method first. +
+Using Gitlab +#### Gitlab +- Open Gitlab in your browser and log in +- Now click **new project** on the right hand side of the interface +![Create a New Project](./img/create-new-project.png) +- You'll now be asked what template do you want to use, I recommend a blank project unless your use case fits with the other options + +![Select Template for Repo](./img/select-project-type.png) + +- Now it's time to give your project a name. You can also set if the project is public or private at this time (although this can be changed later) + +![Setup your project](./img/setup-project.png) + +- Once done click **create project** at the bottom of the page +- You'll be taken to the next page which shows you a bare bones repository. (It should have a README.md file if you didn't change the setting to create one) + +![New repository is now created](./img/project-created.png) +#### Get the project URL + +- The next step is to get the URL for the git repository you want to clone. You can do this by going to the green **code** button and clicking it. +- If you intend to commit code back select the SSH URL. + +![Get the SSH URL](./img/clone-repo.png) + +> If you want to just pull the code down to use locally you can use HTTPS, this is especially useful if you don't have permissions on the repository. + +
+### Clone the new repository + +```bash +git clone git@gitlab.com:ric_harvey/demo-project.git +``` + +### Adding existing files to a git repository + +```bash +cd existing_repo +git remote add origin https://gitlab.com/ric_harvey/demo-project.git +git branch -M main +git push -uf origin main +``` ## Cloning an existing repository diff --git a/img/clone-repo.png b/img/clone-repo.png new file mode 100644 index 0000000..881ef84 Binary files /dev/null and b/img/clone-repo.png differ diff --git a/img/create-new-project.png b/img/create-new-project.png new file mode 100644 index 0000000..d5399de Binary files /dev/null and b/img/create-new-project.png differ diff --git a/img/project-created.png b/img/project-created.png new file mode 100644 index 0000000..a73b69c Binary files /dev/null and b/img/project-created.png differ diff --git a/img/select-project-type.png b/img/select-project-type.png new file mode 100644 index 0000000..3ba2f2b Binary files /dev/null and b/img/select-project-type.png differ diff --git a/img/setup-project.png b/img/setup-project.png new file mode 100644 index 0000000..99300dc Binary files /dev/null and b/img/setup-project.png differ