mapgears / scribeui Goto Github PK

License: MIT License

Shell 0.03% Python 3.11% Mako 0.01% CSS 1.68% JavaScript 85.98% HTML 7.79% C 0.11% PHP 1.25% Makefile 0.04% TSQL 0.01%

scribeui's Introduction

ScribeUI

ScribeUI is an application to create mapfiles with many scale levels.

To get the latest release, clone this repo and then checkout the latest tag. git describe --abbrev=0 to view the latest tag.

Migrating from ScribeUI v0.5 to v1.0 is explained at the end of this file.

The following instruction installations were tested on ubuntu precise.

Requirements

Mapserver 6.4.1
Apache 2.2
Make

Production installation

You need to install apache2 with mod_wsgi:

sudo apt-get install libapache2-mod-wsgi

Note mod_wsgi 3.4 or more is recommended. How to compile mod_wsgi 3.4 on ubuntu precise

Configuration

First, clone the repository in a folder www-data will be able to access. In this configuration example, the scribeui folder will be located at /opt/scribeui

Then, copy the default production settings:

cp production.ini local.ini

Make sure the mapserver url in local.ini points to your mapserver path: - line 35: mapserver.url

Edit the proxy.cgi file and add your server host to the list of allowed hosts if different from localhost (localhost is already included.)

Create a file 'pyramid.wsgi' with the following content, editing the path to your scribeui installation:

from pyramid.paster import get_app, setup_logging
ini_path = '/opt/scribeui/local.ini'
setup_logging(ini_path)
application = get_app(ini_path, 'main')

You can use the Makefile to automatically setup ScribeUI for you, simply run:

   export CPLUS_INCLUDE_PATH=/usr/include/gdal
   export C_INCLUDE_PATH=/usr/include/gdal
   sudo make
   sudo chown -R youruser .
   make install
   sudo make perms

Next step is adding the app to apache, here is an example configuration for Apache 2.2:

WSGIDaemonProcess scribeui user=www-data group=www-data threads=10 \
        python-path=/opt/scribeui/lib/python2.7/site-packages
WSGIScriptAlias /scribeui /opt/scribeui/pyramid.wsgi

<Directory /opt/scribeui>
        WSGIApplicationGroup %{ENV:APPLICATION_GROUP}
        WSGIPassAuthorization On
        WSGIProcessGroup scribeui
        Order deny,allow
        Allow from all
</Directory>

If you use Apache 2.4, the configuration is slightly different:

WSGIDaemonProcess scribeui user=www-data group=www-data threads=10 \
        python-path=/opt/scribeui/lib/python2.7/site-packages
WSGIScriptAlias /scribeui /opt/scribeui/pyramid.wsgi

<Directory /opt/scribeui>
        WSGIApplicationGroup %{ENV:APPLICATION_GROUP}
        WSGIPassAuthorization On
        WSGIProcessGroup scribeui
        Require all granted
</Directory>

Once apache is restarted, ScribeUI should be available!

sudo service apache2 restart

Downloading template data is optional, but recommended for a better experience:

    sudo make load-demo-data

If you omit this step, the maps you create from default templates will display pink tiles.

Development installation

These instructions are for running a development version of ScribeUI. It is pretty good for a local version of the application. Production installation instructions are available below.

cp development.ini local.ini

Review the following parameters in local.ini, and edit them if needed:

- sqlalchemy.url
- workspaces.directory
- scribe.python
- cgi.directory
- mapserver.url

Edit the proxy.cgi file and add your server host to the list of allowed hosts if different from localhost (localhost is already included.)

You can use the Makefile to automatically setup ScribeUI for you, simply run:

    export CPLUS_INCLUDE_PATH=/usr/include/gdal
    export C_INCLUDE_PATH=/usr/include/gdal
    sudo make
    make install

This will download and install the required dependencies, setup the differents configurations files and install them in the proper directories.

To launch the server at http://localhost:6543/:

    make start

Downloading template data is optional, but recommended for a better experience.

    sudo make load-demo-data

This will download some natural earth data and will help you get started with ScribeUI by making templates readily working so you don't start with an empty mapfile. (The template code is still available if you don't download the data, but the result will be pink tiles).

Migrating from v0.5 to v1.0

Before pulling and installing ScribeUI v1.0, first change all file's permission back to your own user:

sudo chown -R user application/

You may now follow the production installation instructions and install ScribeUI v1.0

Once the installation is finished and ScribeUI up, you may import your old workspaces changing the workspace folder and the database to your user:

sudo chown -R user scribeui.sqlite workspaces/

Then executre the update script:

python update.py

Then change the database and workspace folders back to www-data:

sudo chown -R www-data scribeui.sqlite workspaces/

Your workspaces and maps will then be imported, although passwordless.

Each map will have to be edited to delete or comment the following line in the map editor:

CONFIG "MS_ERRORFILE" "../debugFile.log"

scribeui's People

Contributors

Stargazers

Watchers

Forkers

adube solution-globale-informatique kurdiplyas eox-a smercier kleopatra999 nicenboim fblackburn vpicavet jivechang gpprojekt-marcin alexbrault geographika yodeski samtux

scribeui's Issues

Import map

Add "Import map" in "Manager view" base on "Export" zip file. This would be a usefull enhancement.

ScribeUI 0.3 doesn't work on Chrome

There's a JS error in Chrome with scribe 0.3.

Logs view

"Logs" view is moved up the screen when I try to expand it with mouse

Integrating new Scribe script

This will allow for better error logging when doing mistakes in the scribe syntax. The UI needs to be changed to handle the new group management system of the new Scribe script.

SetExtent Plugin

Have the dialogs fit better the size of their contents

Sometimes the dialogs are too big for their content. For example, if you add a new layer group, the dialog is big even if it contains a single input.

Pressing enter to submit forms in popups doesn't work / bugs

Map Name in Manager view

If map name is too long, they override on screen each other

Resize browser windows

When I resize browser windows, it does not resize Scribeui app

Deleting maps makes the last map of the list unselectable until the page is refreshed

Resizing breaks the layout

Editor has a scrollbar in Chrome

There is a scrollbar on the right of the editor on chrome, it will not go away.

Logs view also has some.

Clearer separation between editors

is not quite fit with the mapscript view. When I move the size of this view, would be nice to have a visible line to see the line between views

Workspaces with passwords are bugged

You cannot create or delete a workspace with a password.

No module named config

I try to install scribeui on a Debian machine, I installed all the requirements but when I run

from init import init_db

it return

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "init.py", line 21, in <module>
    from config import *
ImportError: No module named config

Thumbnail image of map project

Would be cool to let user set a thumbnail image of map project.

Delete file

The "delete file" function in browser, does not work

Renaming groups

It is currently impossible to rename groups.

Add and Delete Group in Standard mode

It just doesn't work ... :-(

Resize log view in Chrome

crash. But it's ok in FF.

When browser window is too narrow, editor toolbar glitches

The right floated elements bug, but the left elements act as expected, forming a two-line toolbar.

Smarter makefile

The current makefile will download again heavy files if run twice. It should be able to detect if only a few files are missing, and proceed accordingly.

highlight syntax comment

highlight syntax does not work for this type of /* comment */ :-(

ScribeUI Demo

Needs a cron job that wipes the workspaces and DB clean.
Might also be best to disable the browse tab.

Better error messages

We need better error messages, especially in the ajax calls.

Ex. Creating a map with the name of another map in the workspace alerts "Existing" which is not very friendly.

Mapfile Keyword helper

Would be nice to integrate in scribeui design, online mapfile keyword help(http://mapserver.org/mapfile/index.html)

Add POI

It works but it save one level higher than active map is. In Scribe maps only, standard works normally.

Save button

Should be on top view. I suggest just beside the "Group Setting" Button. At the bottom is not usefull.

Displaying Scale level

This will help to edit scribe maps.

Log tabs don't stick to the bottom of the screen when resizing the window

If the log tabs are open, and you resize the window, the tabs stay where they were.

Resizable left panel

It would be useful to let the user resize the left/editor panel.

Create simple self-contained package for development

The current instructions are actually production instructions, and are very complex #45

There is too much room for user errors in the current instructions, a self contained package which installs scribeui with a few clicks is necessary.

CTRL-z on layer groups may result in loss the the group

Windows Installation Instructions

Zoom level number too small

Larger font size for zoom level, mouse coordinates and scale. Zoom number is one of the major information on map status must so it might be interesting to Have a larger zoom level number on top right corner.

CSS files returned with corrupted headers

Sometimes, a css file is returned and the Content-Type in the response Headers is wrong.

Examples:
Content-Type http://127.0.0.1/ScribeUI
Content-Type Apache/2.2.22
Content-Type /usr/local/etc/mime.types
Content-Type application/x-go-sgf

This problem happens very intermittently and pretty randomly.

In flask's helpers.py, in the send_file function, I tried adding this as a debug message:

pprint.pprint(filename_or_fp+' '+mimetype)

But at this point, the file's mimetype is all good.

I was able to find someone with a similar problem: https://groups.google.com/forum/#!topic/web2py/5F3UUMkDPRI

We both use Flask and mod_wsgi, that's pretty much all we have in common. But otherwise, it's exactly the same issue.

A CSS file having this issue won't be rendered by firefox. But if you open it, the content is there. The only problem is the corrupted content-type.