Débuter avec ScribeUI

ScribeUI est un outil simplifiant l’édition de mapfiles avec Mapserver. Il supporte la syntaxe Scribe, qui accélère le travail de création de mapfiles.

1 Les Workspaces

ScribeUI est un outil simplifiant l’édition de mapfiles avec Mapserver. Il supporte la syntaxe Scribe, qui accélère le travail de création de mapfiles.

Un Workspace comprend:

• Des mapfiles
• Des Point Of Interest ( POI )

Au premier lancement de ScribeUI, créez un nouveau Workspace en appuyant sur New Workspace. Laisser le champ password permet d’avoir un Workspace sans mot de passe.

Pour changer de Workspace, rafraîchir la page.

2 Le Manager

Le Manager est l'endroit ou tous les mapfiles du Workspace sont disponibles. Lorsqu’un nouveau Workspace a été créé, le Manager est vide.

2.1 Créer une nouvelle carte

Cliquer sur le bouton New Map dans le Manager permet de créer une nouvelle carte.

Le champ Name correspond au nom de la carte.

Le Type permet de choisir entre une carte de type Scribe ou Standard. Le type Scribe donne accès à la syntaxe et aux fonctionnalités scribe. Les cartes de type standard sont des mapfiles mapserver normales.

Le Template permet de commencer une nouvelle carte à partir d’une autre carte déjà existante. Cela vous permet de facilement cloner l’une des cartes du Workspace et de l’éditer sans changer l’originale. ScribeUI offre un template par défaut qui est utilisé s’il s’agit de votre première carte dans ce Workspace.

La Description vous permet d’entrer des informations supplémentaires sur la carte. Il s’agit d’un champ facultatif.

Comme premier exemple, créez une carte de type Scribe avec le template Natural Earth. Lorsqu’elle sera créée, elle apparaîtra dans le manager. Pour ouvrir la carte, cliquer sur l’icône et ensuite cliquer sur Open Map.

2.2 Supprimer une carte

Simplement sélectionner la carte à supprimer et cliquer sur Delete Map.

3 Editor

L’onglet Editor permet d’accéder à l’éditeur de carte. Lorsqu’une carte est ouverte, il affiche le premier groupe de couches dans un éditeur de texte. Dans notre exemple, il s’agit du groupe océan.

Pour sauvegarder, utilisez le raccourci Ctrl+s ou appuyez sur le bouton Save.

3.1 Les Groupes de couches

ScribeUI permet de diviser ses mapfiles en Groupes de couche. Notre exemple comporte plusieurs groupes. Il est possible de les consulter en cliquer sur le menu déroulant suivant:

Un groupe peut contenir plusieurs layers. Comme pour une mapfile standard, la première couche définie dans un groupe est dessinée en premier, et les suivantes seront dessinées par-dessus.

3.1.1 Ajouter un groupe

Pour ajouter un groupe, appuyer sur le bouton suivant:

Et entrer le nom du groupe dans la fenêtre.

3.1.2 Réordonner les groupes

L’ordre des groupes est aussi important que l’ordre des couches. Le premier groupe sera dessiné en premier, le second par dessus et ainsi de suite. Pour réordonner les groupes, appuyer sur le bouton suivant:

Ensuite, sélectionnez le groupe que vous souhaitez réordonner et utilisez les flèches au bas de la fenêtre pour monter ou descendre le groupe:

Si vous êtes satisfait du nouvel ordre de vos groups, appuyer sur Apply.

3.1.3 Supprimer un groupe

Pour supprimer un ou plusieurs groupes, appuyez sur le bouton suivant:

Et dans la fenêtre, sélectionnez un groupe à supprimer et appuyez sur l’icône de poubelle:

Vous pouvez supprimer plus d’un groupe en en sélectionnant un autre et en cliquant sur la poubelle. Tous les groupes prêts à être supprimé sont grisés et barrés dans la liste, mais ils ne sont pas supprimés tant que vous n’avez pas appuyé sur Apply. Prenez donc soin de réviser vos choix, et appuyez sur Cancel ou fermez la fenêtre si vous vous êtes trompé.

3.2 L’éditeur secondaire

L’éditeur secondaire est un second panneau s’ouvrant au-dessus de l’éditeur principal. Il permet d’éditer les variables, les niveaux d’échelle et plus encore.

Pour l’ouvrir, sélectionner l’une des options dans ce menu déroulant:

Toutes les options sont décrites en détail ci-dessous:

3.2.1 L’éditeur Map

Cet éditeur contient l’objet MAP. Si vous êtes déjà familier avec Mapserver et les mapfiles, vous reconnaîtrez les différentes instructions.

3.2.2 L’éditeur Scales

Cet éditeur permet de définir les niveaux d’échelle dont Scribe se servira pour simplifier l’écriture de votre mapfile!

Par exemple, on peut voir dans le layer land que selon le niveau d’échelle, on utilise des données différentes:

3.2.3 L’éditeur Symbols

L’éditeur de Symbols permet simplement de définir des Symbols qui seront accessibles dans toute la carte. Les Symbols sont définis avec de la syntaxe de mapfile standard, et non pas Scribe.

3.2.4 L’éditeur Fonts

Les polices de caractères définies dans cet éditeur, sont accessibles dans toute la carte. Par exemple, dans le couche cities:

3.2.5 L’éditeur Projections

Tout comme l’éditeur de Fonts, l’éditeur de Projections permet de définir des Projections accessibles dans toute la carte.

3.2.6 L’éditeur Variables

L’éditeur de Variables donne accès à une fonction très intéressante de ScribeUI: la définition de variables. Les variables définies dans cet éditeur seront par la suite accessibles dans la carte en ajoutant un ‘@’ devant le nom de la variable.

Par exemple, dans la couche water, les couleurs des lacs, rivières et autres sont définis à l’aide de variables:

3.3 Le panneau de Debug

Le panneau de débug permet d’avoir accès à d’importantes informations à propos d’une carte. Pour y accéder, cliquer sur l’icône de drapeau:

3.3.1 Logs

L’onglet Logs affiche les erreurs Scribe. Par exemple, dans le groupe de couches land, si on change la ligne 13 “COLOR: '#EEECDF'” pour “COLOR '#EEECDF'”, l’erreur de syntaxe s’affichera:

3.3.2 Debug

Debug a une utilité semblable au panneau Logs, mais il affiche uniquement les erreurs Mapserver. Par exemple, si on introduit à nouveau une erreur dans la ligne 13 du groupe land, en changeant “COLOR: '#EEECDF'” pour “COLOR: '#EEECF'”, Scribe ne lancera pas d’erreur, car il s’agit d’une erreur de syntaxe Mapserver. Ainsi, le panneau Logs affichera Success, mais vous aurez une tuile rose!

Pour voir votre erreur, ouvrez l’onglet debug, et zoomez sur la carte:

3.3.3 Result

Toutes les cartes créées avec ScribeUI résultent en un mapfile valide et bien indentée, qu’il est possible de consulter. C’est ce à quoi sert l’onglet Result. Il vous permet de consulter la mapfile produite par votre code Scribe.

En ouvrant l’onglet Result de notre exemple, on peut voir tous les couches générées par scribe, triées par niveau de zoom.

3.4 Le greffon SetExtent

Le bouton Set Map Extent de l’éditeur permet de facilement choisir une étendue pour une carte.

En cliquant sur le bouton, une boîte de dialogue s’ouvre. Il est alors possible de dessiner un rectangle sur la carte. Ce rectangle définira l’étendue de la carte:

Cliquer sur SetExtent éditera alors l’étendue de la carte.

Note: Les niveaux de zoom sont définis dans l’éditeur de Scales. Changer l’étendue de la carte n’aura donc pas de conséquence visible dans ScribeUI.

4 Les points d’intérêt ( POI )

Les points d’intérêts permettent de rapidement se déplacer à un point précis de la carte. Dans le Template par défaut, un point d’intérêt est déjà défini sur la ville de Québec. Il suffit de cliquer sur Go! pour y accéder:

Ajouter un point d’intérêt est très simple. Dirigez-vous à l’endroit désiré sur la carte, et appuyez sur le +:

Donnez un nom à votre point d’intérêt, et il sera accessible pour toutes les cartes de votre Workspace.

5. Le Browser

Le Browser est une interface de gestion de fichiers vous permettant de téléverser dans ScribeUI des données, des polices de caractères, des icônes, etc.

Pour téléverser un fichier, vous pouvez glisser le fichier directement dans l’interface, ou utiliser l’icône suivante: