Mirror of Potlatch's subversion repository
ActionScript Perl
Latest commit 40b2080 Jun 25, 2013 bnesbitt We're sorry, the source code you have reached has changed. The new ad…
…dress is....

git-svn-id: http://svn.openstreetmap.org/applications/editors/potlatch@29695 b9d5c4c9-76e1-0310-9c85-f3177eceb1e4
Permalink
Failed to load latest commit information.
fonts
icons_dbl new icons Jan 14, 2010
icons_png
README.TXT
advice.as
anchorpoint.as
changeset.as
error.as
gps.as
help.as
history.as
iconpanel.as
inspector.as
node.as
offline.as #2351: Make strings in offline.as translatable Oct 15, 2009
photos.as
poi.as
potlatch.as
potlatch.pl
potlatch_assets.pl
potlatchtweet.cgi
properties.as
relation.as
start.as last point release of Potlatch 1.x... Apr 8, 2010
tagfinder.as
test.html
tiles.as
ui.as last point release of Potlatch 1.x... Apr 8, 2010
undo.as
way.as
world.as

README.TXT

NOTE:
The Potlatch 2 source code has moved.  Please see:
http://wiki.openstreetmap.org/wiki/Potlatch_2/Developer_Documentation
http://git.openstreetmap.org/potlatch2.git/





============================================================================
============================================================================
============================================================================
============================================================================
============================================================================
============================================================================
============================================================================
============================================================================
============================================================================
============================================================================



== Compiling Potlatch ==

=== Requirements ===

You will need Ming (www.libming.net) and the Perl bindings.

=== Against a local installation ===

If you have the Rails port (full OSM codebase) set up on your machine, it's best to run Potlatch directly against that.

To compile Potlatch, simply run:
	perl potlatch.pl /path/to/rails_port/public/potlatch/potlatch.swf
	
If you'd like to enable a debug window, add --trace:
	perl potlatch.pl --debug /path/to/rails_port/public/potlatch/potlatch.swf

You can write to the debug window from the Potlatch source like this:
	_root.chat.text="Some text";
	
If you're using Ming 0.3, add --ming3 to ensure that line widths are correct.

=== Against the main OSM server ===

You can also run Potlatch locally, talking to the main openstreetmap.org server. In this case, to compile it, run:
	perl potlatch.pl --absolute potlatch.swf
	
This will compile the SWF to the current source directory. Then, to run Potlatch, open test.html in your web browser.

Note 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:
	
	file:///Users/richard/Sites/potlatch/test.html - DOESN'T WORK
	http://127.0.0.1/~richard/potlatch/test.html - works
	http://localhost/~richard/potlatch/test.html - works
	

== Authentication ==

When 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.

If 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.

To do this, find the reference to 'token' in test.html:
    fo.addVariable('token','VeSiWDkofUzgLLx5DgAU4rh1Wn23ro');

and change it to:
    fo.addVariable('token','your_username:your_password');



Richard Fairhurst
richard@systemeD.net