ScribeUI

MapServer Mapfile Development Made Easy

View project onGitHub

FAQ

General Questions

What is scribe? How do I use it?

What is the difference between scribe and scribeui?

Installation

I have mod_wsgi 3.3 instead of 3.4, will it still work?

How do I install mod_wsgi 3.4 on ubuntu precise or earlier ?

I am on windows, can I install ScribeUI?

Troubleshooting

I have segfaults in my Apache error log

Sometimes, it looks like a CSS file is not loading

Sometimes, there is no code displayed in the editor, or the browse tab is broken

My problem is not listed here, what should I do?

General Questions

What is scribe? How do I use it?

Scribe is an alternative mapfile syntax, learn how to use it in our guide: Getting started with Scribe syntax

What is the difference between scribe and scribeui?

ScribeUI is a web-based application that help you edit standard mapfiles and scribe maps through a friendly UI featuring an instant preview of the map, points of interest and other functionalities. Scribe is an alternate syntax for mapserver mapfiles that adds new features to make your life easier, while still generating a valid regular mapfile. Learn more

Installation

I have mod_wsgi 3.3 instead of 3.4, will it still work?

For the most part, yes. However, there is a bug in mod_wsgi 3.3 which causes some css files to load incorrectly (more info the issue). It is an unpredictable bug, which can happen often as it can never happen. It is not recommended to use mod_wsgi 3.3 or earlier for this reason, especially on a production setup.

How do I install mod_wsgi 3.4 on ubuntu precise or earlier ?

As there is no package ready yet, you will have to compile a version of mod_wsgi. It is fairly easy on ubuntu. Uninstall any previous version of mod_wsgi you may have. Make sure you have the python-dev, build-essential and apache2-prefork-dev installed, then download the source and compiling it is a matter of a few commands:

./configure
make
sudo make install

And you must edit scribeui's apache config file, which should be located at /etc/apache2/sites-enabled/ScribeUI.conf and add the path of your mod_wsgi version, for example:

  LoadModule wsgi_module     /usr/lib/apache2/modules/mod\_wsgi.so

I am on windows, can I install ScribeUI?

It's possible, all the required softwares are available for windows. Installation instructions are being worked on!

Troubleshooting

I have segfaults in my Apache error log

Restarting apache should fix the problem. If it doesn't, make sure your version of mod_wsgi is compiled with the same version of python ScribeUI is running with.

Sometimes, it looks like a CSS file is not loading, or sometimes, there is no code displayed in the editor, or the browse tab is broken

You are probably running mod_wsgi 3.3. Why you should install mod_wsgi 3.4

My problem is not listed here, what should I do?

Feel free to post your question on the mapserver-user mailing list or open a issue on the project's github!