11# Atom Remote Sync
2-
32This package provides functionality for:
4-
5- * Uploading changes automatically when you save a file
6- * Uploading/downloading files to/from the server
7- * Displaying diffs between the local and remote files with your favourite diff tool
8- * set difftoolCommand in AtomSettingView of ` remote-sync ` — The path to your diff tool executable
3+ - Uploading changes automatically when you save a file
4+ - Uploading/downloading files to/from the server
5+ - Displaying diffs between the local and remote files with your favourite diff tool
6+ - Monitor files for external change and automatically upload
7+ - set difftoolCommand in AtomSettingView of ` remote-sync ` -- The path to your diff tool executable
98
109Currently, both SCP/SFTP and FTP are supported.
1110
1211## Installation
13-
1412You can install this like any other Atom package, with one of these methods:
15-
16- * Open your settings in Atom, select the "Install" tab, search for "remote-sync", and click install on it
17- * Run ` apm install remote-sync ` in a terminal
18- * Download or clone this repository to your ` ~/.atom/packages/ ` directory and enter the directory run ` apm install `
13+ - Open your settings in Atom, select the "Install" tab, search for "remote-sync", and click install on it
14+ - Run ` apm install remote-sync ` in a terminal
15+ - Download or clone this repository to your ` ~/.atom/packages/ ` directory and enter the directory run ` apm install `
1916
2017## Usage
21-
2218Create file ` .remote-sync.json ` in your project root with these settings:
23-
24- * ` transport ` — ` scp ` for SCP/SFTP, or ` ftp ` for FTP
25- * ` hostname ` — Remote host address
26- * ` port ` - Remort port to connect on (typically 22 for SCP/SFTP, 21 for FTP)
27- * ` username ` — Remote host username
28- * ` password ` — Remote host password
29- * ` keyfile ` — Absolute path to SSH key (only used for SCP)
30- * ` passphrase ` — Passphrase for the SSH key (only used for SCP)
31- * ` useAgent ` — Whether or not to use an agent process, default: false (only used for SCP)
32- * ` target ` — Target directory on remote host
33- * ` source ` — Source directory relative to project root
34- * ` ignore ` — Array of [ minimatch] ( https://github.com/isaacs/minimatch ) patterns of files to ignore
35- * ` uploadOnSave ` — Whether or not to upload the current file when saved, default: false
36- * ` useAtomicWrites ` — Upload file using a temporary filename before moving to its final location (only used for SCP), default: false
37- * ` uploadMirrors ` — transport mirror config array when upload
38- * ` deleteLocal ` - whether or not to delete the local file / folder after remote delete
39- * ` saveOnUpload ` - Whether or not to save a modified file before uploading, default: false
19+ - ` transport ` -- ` scp ` for SCP/SFTP, or ` ftp ` for FTP
20+ - ` hostname ` -- Remote host address
21+ - ` port ` - Remort port to connect on (typically 22 for SCP/SFTP, 21 for FTP)
22+ - ` username ` -- Remote host username
23+ - ` password ` -- Remote host password
24+ - ` keyfile ` -- Absolute path to SSH key (only used for SCP)
25+ - ` passphrase ` -- Passphrase for the SSH key (only used for SCP)
26+ - ` useAgent ` -- Whether or not to use an agent process, default: false (only used for SCP)
27+ - ` target ` -- Target directory on remote host
28+ - ` source ` -- Source directory relative to project root
29+ - ` ignore ` -- Array of [ minimatch] ( https://github.com/isaacs/minimatch ) patterns of files to ignore
30+ - ` uploadOnSave ` -- Whether or not to upload the current file when saved, default: false
31+ - ` useAtomicWrites ` -- Upload file using a temporary filename before moving to its final location (only used for SCP), default: false
32+ - ` uploadMirrors ` -- transport mirror config array when upload
33+ - ` deleteLocal ` - whether or not to delete the local file / folder after remote delete
34+ - ` saveOnUpload ` - Whether or not to save a modified file before uploading, default: false
4035
4136SCP example:
37+
4238``` json
4339{
4440 "transport" : " scp" ,
@@ -57,6 +53,7 @@ SCP example:
5753```
5854
5955SCP ` useAgent ` example:
56+
6057``` json
6158{
6259 "transport" : " scp" ,
@@ -73,6 +70,7 @@ SCP `useAgent` example:
7370```
7471
7572FTP example:
73+
7674``` json
7775{
7876 "transport" : " ftp" ,
@@ -89,6 +87,7 @@ FTP example:
8987```
9088
9189Upload mirrors example:
90+
9291``` json
9392{
9493 "transport" : " scp" ,
@@ -114,7 +113,7 @@ Upload mirrors example:
114113 "passphrase" : " your_passphrase" ,
115114 "target" : " /home/vagrant/dirname/subdirname_one" ,
116115 "ignore" : [
117- " .remote-sync.json" ,
116+ " .remote-sync.json" ,
118117 " .git/**"
119118 ]
120119 },
@@ -126,7 +125,7 @@ Upload mirrors example:
126125 "password" : " vagrant" ,
127126 "target" : " /home/vagrant/dirname/subdirname_two" ,
128127 "ignore" : [
129- " .remote-sync.json" ,
128+ " .remote-sync.json" ,
130129 " .git/**"
131130 ]
132131 }
@@ -135,17 +134,14 @@ Upload mirrors example:
135134```
136135
137136## Usage example
138-
139137### Existing project
140-
1411381 . Add a file named ` .remote-sync.json ` to your project, with the contents above
1421392 . Open the command palette by pressing cmd + shift + P on a Mac, or ctrl + shift + P on Linux/Windows
1431403 . Type in ` remote sync reload config ` and press enter
144141
145142That's it!
146143
147144### From scratch, with a remote server
148-
1491451 . Create a folder for your project, and create a file named ` .remote-sync.json ` in it with the contents above
1501462 . In the Atom editor, open the command palette by pressing cmd + shift + P on a Mac, or ctrl + shift + P on Linux/Windows
1511473 . Type in ` remote sync reload config ` and press enter
@@ -154,6 +150,5 @@ That's it!
154150
155151The package will download all of the files from the remote server for you.
156152
157-
158- #Make a donation via Paypal ![ Make a donation via Paypal] ( https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif )
153+ # Make a donation via Paypal ![ Make a donation via Paypal] ( https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif )
159154Click 'Send Money' after login PayPal, and my PayPal account is: lx1988cyk#gmail.com
0 commit comments