Updated WorkingOffline.txt

loren authored
revision 97b583ff3f5a01f881c6f6d4dbbae98c650a0fad
working-offline/WorkingOffline
# Working Offline with Git

Internally, Penflip uses [Git](http://git-scm.com) to manage versions, changes, and merges. By using Git or a Git-enabled tool, you can sync writing projects on your computer with Penflip. This allows you to work offline (using any text editor you want), then _push_ your changes to Penflip with a single click.

### Using command-line Git

If you are familiar with using Git from the command-line, you can have at it. The clone URL to use is available from your project's "Settings" page.

If you want to work offline with command-line Git on a version of another's project, here are some pointers to make it work:

1. Get the clone link of the project. This is the link you see on top of the page of the project + .git. For example with this project you do

git clone https://www.penflip.com/Penflip/help.git

2. Work locally
3. Push to your version branch, for example user `loren` would do

git push origin master:loren


### Using the GitHub desktop app

_Note: I'll be using the Mac app here, but the steps should be similar for the Windows app._

**1) Download and install the GitHub desktop app**

For Mac: http://mac.github.com/

For Windows: http://windows.github.com/


**2) Create a project on Penflip**

If you don't have a project yet, create a project here: http://www.penflip.com/projects/new


**3) Download your project**

You can download your project and add it to the GitHub app at the same time.

For Mac, type this in your browser:

**github-mac://openRepo/PENFLIP-LINK-TO-YOUR-PROJECT**

For Windows, type this in your browser:

**github-windows://openRepo/PENFLIP-LINK-TO-YOUR-PROJECT**

Make sure to include the full link to your Penflip project. For example:

github-mac://openRepo/http://www.penflip.com/loren/how-to-work-offline

The GitHub app will open. Select where you want to download your project to, and click 'Clone'.

![Screen_Shot_2013-09-28_at_2.32.08_PM.png](images/Screen_Shot_2013-09-28_at_2.32.08_PM.png)

You now have a copy of your project on your computer, including the full history of changes you (and your collaborators) have made.

![Screen_Shot_2013-09-28_at_2.34.59_PM.png](images/Screen_Shot_2013-09-28_at_2.34.59_PM.png)


**4) Make changes**

Your project is now on your computer like any other file or folder. You can make changes using and text editor. Here, I'm using textmate.

![Screen_Shot_2013-09-28_at_2.39.21_PM.png](images/Screen_Shot_2013-09-28_at_2.39.21_PM.png)


**5) Sync changes with Penflip**

The following steps are done through the GitHub app.

Switch to the 'Changes' tab:

![Screen_Shot_2013-09-28_at_2.42.33_PM.png](images/Screen_Shot_2013-09-28_at_2.42.33_PM.png)

Turn on 'Commit & Sync' (square toggle switch):

![Screen_Shot_2013-09-28_at_2.41.49_PM.png](images/Screen_Shot_2013-09-28_at_2.41.49_PM.png)

Type a description of your changes in the 'Commit summary' box:

![Screen_Shot_2013-09-28_at_2.43.59_PM.png](images/Screen_Shot_2013-09-28_at_2.43.59_PM.png)

Click 'Commit & Sync':

![Screen_Shot_2013-09-28_at_2.46.12_PM.png](images/Screen_Shot_2013-09-28_at_2.46.12_PM.png)


**6) Done!**

Verify that your changes have been synced with Penflip by looking at your project page.

![Screen_Shot_2013-09-28_at_2.48.09_PM.png](images/Screen_Shot_2013-09-28_at_2.48.09_PM.png)

---
Still confused? Email support@penflip.com for help!