source: subversion/applications/editors/potlatch/README.TXT @ 19967

Last change on this file since 19967 was 18526, checked in by richard, 10 years ago

Potlatch 1.2e

File size: 1.9 KB
RevLine 
[15001]1== Compiling Potlatch ==
2
3=== Requirements ===
4
5You will need Ming (www.libming.net) and the Perl bindings.
6
7=== Against a local installation ===
8
9If you have the Rails port (full OSM codebase) set up on your machine, it's best to run Potlatch directly against that.
10
11To compile Potlatch, simply run:
12        perl potlatch.pl /path/to/rails_port/public/potlatch/potlatch.swf
13       
14If you'd like to enable a debug window, add --trace:
15        perl potlatch.pl --debug /path/to/rails_port/public/potlatch/potlatch.swf
16
17You can write to the debug window from the Potlatch source like this:
18        _root.chat.text="Some text";
19       
[18526]20If you're using Ming 0.3, add --ming3 to ensure that line widths are correct.
21
[15001]22=== Against the main OSM server ===
23
24You can also run Potlatch locally, talking to the main openstreetmap.org server. In this case, to compile it, run:
25        perl potlatch.pl --absolute potlatch.swf
26       
27This will compile the SWF to the current source directory. Then, to run Potlatch, open test.html in your web browser.
28
29Note that Flash Player has (really annoying) security restrictions that may prevent your local machine talking to a remote server, and vice versa. So on my OS X machine:
30       
31        file:///Users/richard/Sites/potlatch/test.html - DOESN'T WORK
32        http://127.0.0.1/~richard/potlatch/test.html - works
33        http://localhost/~richard/potlatch/test.html - works
34       
35
36== Authentication ==
37
38When Potlatch is run on the OSM site (or your local install of the same), it gets a token from Rails which it uses to authenticate.
39
40If you're running it locally without a full install of the Rails port, you won't have a token. Happily, Potlatch can also authenticate by user ID and password.
41
42To do this, find the reference to 'token' in test.html:
43    fo.addVariable('token','VeSiWDkofUzgLLx5DgAU4rh1Wn23ro');
44
45and change it to:
46    fo.addVariable('token','your_username:your_password');
47
48
49
50Richard Fairhurst
51richard@systemeD.net
Note: See TracBrowser for help on using the repository browser.