Confirmed users
195
edits
Open Design: Difference between revisions
Jump to navigation
Jump to search
adding screenshots
(formatting) |
(adding screenshots) |
||
| Line 49: | Line 49: | ||
=== Clone the Alopex Repository === | === Clone the Alopex Repository === | ||
Github repositories on your computer are called "local repos." Local repos are where you save your work. Then you "push" your work to the remote repo on Github, where other people can see it. | |||
Repositories on Github are called "remote repos" because they are remote from your computer where you work with the files. Remote repos are also sometimes called "upstream repos." | |||
To get started with Alopex, you need the files from the [https://github.com/fxos-product-design/alopex Alopex's remote repo on Github]. This is called "cloning." When you "clone" a remote repo from Github, you copy the current state of the remote repo and paste it to your computer as a new local repo. | |||
:1. '''Decide on a location for your local repositories.''' | |||
::Choose the location thoughtfully - moving a repo to a different directory after you've done Step 4 can cause problems later. See the example directory structure below. | |||
::[[File:Open design example folder structure.png|none|400px|Example Directory Structure]] | ::[[File:Open design example folder structure.png|none|400px|Example Directory Structure]] | ||
:2. '''Go to ''File > Clone Repository''.''' | |||
::[[File:19 clonerepo.png|none|400px|Clone Alopex repo]] | |||
:3. '''Select the remote repo you want to clone.''' | |||
::If you're new to Github, you will only see "alopex" as an option. | |||
::If you're a member of other Github repositories, you can search for "alopex" in the list. | |||
::Select the "alopex" repository, and then click "Clone alopex." | |||
::[[File:20 selectrepo.png|none|400px|Select remote repo]] | |||
:4. '''Navigate to the location where you plan to store your remote repos.''' | |||
::[[File:21 clone 1.png|none|400px|Browse to location]] | |||
::You may need to expand the down arrow to navigate to the right location. | |||
::[[File:21 clone 2.png|none|400px|Browse to specific location]] | |||
:6. '''When you've navigated to the right folder, click ''Clone.''''' | |||
::[[File:21 clone 3.png|none|400px|Clone it]] | |||
:7. '''You're done!''' | |||
::When cloning is complete, you'll see history of the remote repo in the History tab of Github Desktop. | |||
::[[File:25 cloned repo.png|none|400px|Clone it]] | |||
::If you go back to your Finder and navigate to where you're storing your Github repositories, you'll see that a new folder called "alopex" has been added. Inside that folder are all the project files. | |||
::[[File:26 cloned folder.png|none|400px|Clone it]] | |||
''If you want to use the command line, go for it, though be mindful of how we're using Github.'' | ''If you want to use the command line, go for it, though be mindful of how we're using Github.'' | ||