1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
---
layout: default
title: Create A Repo
description: Create the place where your commits will be stored
categories: bootcamp
main_category: bootcamp
---
<span class="intro">If you’ve found yourself on this page, we’re assuming you’re brand new to Git and GitHub. This guide will walk you through creating your first repo, creating a README file, and making your first commit.</span>
##<span>First:</span> Create A Repo
Every time you push your commits to GitHub, they get stored in a repository (a.k.a. “repo”)
1. <span class="step-title">Create a new repo</span>
Click “New Repository.
<img src="/images/bootcamp/bootcamp_2_newrepo.jpg" width="558" height="291" alt="Click “New Repository" />
Fill out the information on this page. When you’re done, click “Create Repository.”
<img src="/images/bootcamp/bootcamp_2_repoinfo.jpg" width="558" height="437" alt="Fill in the info" />
Congratulations! You have successfully created your first repo!
##<span>Next:</span> Create a README for your repo.
While a README isn’t a required part of a GitHub repo, it is a good idea to have one. READMEs are a great place to describe your project or add some documentation such as how to install or use your project.
1. <span class="step-title">Create the README file</span>
In the prompt, type the following code:
<pre class="terminal bootcamp">
<span class="codeline">$ mkdir ~/Hello-World<span>Creates a directory for your project called "Hello-World" in your user directory</span></span>
<span class="codeline">$ cd ~/Hello-World<span>Changes the current working directory to your newly created directory</span></span>
<span class="codeline">$ git init<span>Sets up the necessary Git files</span></span>
<span class="bash-output">Initialized empty Git repository in /Users/<em>your_user_directory</em>/Hello-World/.git/</span>
<span class="codeline">$ touch README<span>Creates a file called "README" in your Hello-World directory</span></span>
</pre>
Open the new README file found in your Hello-World directory in a text editor and add the text “Hello World!.” When you are finished, save and close the file.
2. <span class="step-title">Commit your README</span>
Now that you have your README set up, it's time to commit it. A commit is essentially a snapshot of all the files in your project at a particular point in time. In the prompt, type the following code:
<pre class="terminal bootcamp">
<span class="codeline">$ git add README<span>Stages your README file, adding it to the list of files to be committed</span></span>
<span class="codeline">$ git commit -m 'first commit'<span></span>Commits your files, adding the message "first commit"</span>
</pre>
The code above executes actions locally, meaning you still haven’t done anything on GitHub yet. To connect your local repository to your GitHub account, you will need to set a remote for your repo and push your commits to it:
<pre class="terminal bootcamp">
<span class="codeline">$ git remote add origin git@github.com:<em>username</em>/Hello-World.git<span>Sets the origin for the Hello-World repo</span></span>
<span class="codeline">$ git push origin master<span></span>Sends your commit to GitHub</span>
</pre>
Now if you look at your repository on GitHub, you will see your README has been added to it.
<img src="/images/bootcamp/bootcamp_2_updatedreadme.jpg" width="558" height="577" alt="Your README has been created" />
##<span>Lastly:</span> Celebrate
Congratulations! You have now created a repository on GitHub, created a README, committed it, and pushed it to GitHub. What do you want to do next?
<ol class="next-steps">
<li><a href="/set-up-git-redirect/">Set Up Git</a></li>
<li>Create A Repository</li>
<li><a href="/fork-a-repo/">Fork A Repository</a></li>
<li><a href="/be-social/">Be Social</a></li>
</ol>
|
