NL:Potlatch/Development overview/Installeren en compileren

From OpenStreetMap Wiki
Jump to: navigation, search

Installeren

Potlatch is ontworpen om geinstalleerd te worden op een OSM server, maar je kunt het ook "standalone" draaien om te communiceren met de main.dev.openstreetmap.org server. Wanneer je OSM hebt draaien op je eigen machine, zou je Potlatch kunnen installeren, hoewel dit dan natuurlijk alleen naar je lokale database wegschrijft!

Om de ontwikkel versie op te halen:

svn co http://svn.openstreetmap.org/applications/editors/potlatch

Vereisten vooraf

  • Ming (idealiter versie 0.4.0 of later) - deze library compileerd de Flash SWF applet
    • Als je Ming 0.3.0 gebruikt, is het nodig de Ming source enigszins te patchen (uitgezonderd versie 0.4.0)
    • Als je Ming ge-ungzipped hebt, wijzig src/ming.c, vervang simpelweg version > 7 in regel 103 in version > 8.
    • Ming heeft flex nodig. (Op Debian bases systemen kun je het installeren met sudo apt-get install flex)
    • Dan build zoals gebruikelijk (./configure, make, make install).
  • Ming Perl language wrapper
    • Haal perl_ext van sourceforge (als het al niet in je Ming archive zit).
    • Ungzip het in je Ming install directory.
    • cd perl_ext, perl Makefile.PL, make, make test, make install
  • Flash Player 8 of later om Potlatch te draaien!

Als onderdeel van een volledige OSM installatie

Je hebt een volwaardig werkende Rails port nodig, en een gevulde OSM database (b.v. van planetosm-to-db.pl of Osmosis).

Laten we een aanpassing maken in de code, en het live bekijken op je lokale installatie.

Navigeer naar applications/editors/potlatch, en wijzig potlatch.as. Zoek de regel met var signature="Potlatch ... (waarschijnlijk rond regel 100) en pas het versie nummer aan.

Nu moet je de SWF compileren. Nog steeds in applications/editors/potlatch, voer deze opdracht uit:

 perl potlatch.pl ~/osm/sites/rails_port/public/potlatch/potlatch.swf

(wijzig ~/osm naar de lokatie van je OSM installatie!). De SWF is nu gecompileerd. Start je browser, ga naar 'Edit' en test het!

Standalone

Je kunt ook spelen met de Potlatch source zonder het gedoe van een volledige OSM installatie. In dat geval zal Potlatch de test server aanspreken op main.dev.openstreetmap.org.

Om dit te doen moet je test.html hebben en je gecompileerde potlatch.swf draaiend op je lokale webserver.

  perl potlatch.pl --dev --trace ~/de/zelfde/directory/op/je/lokale/webserver/potlatch.swf

De '--dev' optie betekend 'praat met de test server'. De '--trace' optie houdt in 'toon me debug windows'. Deze windows hebben de namen _root.chat en _root.coordmonitor, dus kun je er naar toe schrijven op de volgende manier:

  _root.chat.text="Hier is een debug boodschap";

Schrijven naar de dev server

Als je wijzigingen op de dev server wilt opslaan, heb je een geldig token nodig. Om dit te krijgen moet je aanmelden op http://main.dev.openstreetmap.org/ - je kunt hiervoor het user ID 'Potlatch' en het wachtwoord 'potlatch' gebruiken. Dan daar de edit tab openen (niet op je lokale installatie). Bekijk de source, en zoek op 'token'. Kopieer de token string van hieruit naar test.html op je lokale webserver.