[No German version, I'm too lazy.]

You may know it or not, I have been quite busy in the last month hacking on OpenRailwayMap code. I have introduced automated testcases to spot syntax errors and dangling icon references and much stuff like this. In fact, also the automation to build the new JavaScript stylesheets from the MapCSS ones was done by me.

I've also done a lot of things to improve the stylesheets, as well as the underlying software that drives them. Which usually resulted in me begging Alexander to put that stuff on the server so I can actually see if it works. Testing on a live system isn't a good idea anyway, and given the fact that every update has to go through another person doesn't make this solution scale anywhere.

So once I sat down and tried to set up a local server, but not a full-featured database one. I have only the frontend rendering code on my machines, happily using the vector tiles of the "real" server. This resulted in me fixing even more stuff. Since the important parts of that are already merged I'll now write down how to get there so you can hack on your own stuff.

My machines use openSUSE, so I will stick to those package names. And I don't list the dependencies explicitely here to keep things short. So, let's start installing:

zypper in git-core apache2-mod_php5 php5-ctype php5-gettext python-ply python- rsvg python-cairo libxml2-tools zip

Now get the actual code

git clone https://github.com/rurseekatze/OpenRailwayMap.git cd OpenRailwayMap git submodule init renderer

Now build the JavaScript stylesheets

cd styles make

That's pretty much it. Now tell your webserver where your OpenRailwayMap directory is and that it should be served, or put the whole directory in your ~/public_html. Put "php5" and maybe also "userdir" (if you use ~/public_html) in your /etc/sysconfig/apache2 in the APACHE_MODULES line, (re)start apache:

systemctl start apache2.service

You may want to make canvas.php the directory index, otherwise you always have to type it. The bitmap layer is of course also taken from the "real" instance, so you can't change how that looks.

And you should basically be done. Now you can e.g. hack on styles/*.mapcss to get different styling, just "make -C styles" afterwards and reload the page.

I hope some cool new pull requests will come in now, e.g. for signalling systems outside of central Europe. In case I have forgotten some thing just ask either on this list or in #OpenRailwayMap on irc.oftc.net.

Greetings,

Eike

P.S.: want to have a proof that this works? http://orm-dev.der-dakon.net, this usually runs a combination of most of my own branches that are waiting for upstream integration. I may or may not pick other peoples branches there, too, this is more or less random if I have an interest in them.