Installazione e uso dei Worldmap Tool (nugsl-worldmap) su Linux

2011-03-28 - Utilizzo Ubuntu 9.10. Non sono riuscito a trovare alcuna documentazione dettagliata sull'uso di nugsl-worldmap;
ho usato il procedimento che segue, cercando di rimediare alle varie segnalazioni di errore che si sono presentate.
Se c'è qualche errore di procedimento o esiste un sistema migliore o una documentazione dettagliata, per favore, segnalatemelo.
P.S. Se qualcuno si prende la briga di tradurre i testi in inglese (durante le ore di inglese andavo a giro) sarò lieto di pubblicare la nuova pagina.

La pagina ufficiale dello script è World map tool
Per l'utilizzo dello script è necessario avere installati:

• Python Generalmente è già installato.
• rsvg si trova nei repository, spiegato in seguito.
• tagtool spiegato in seguito.
• nugsl-worldmap spiegato in seguito.

Installazione Torna su

• Dal gestore pacchetti installare i file librsvg (rsvg è necessario per creare le immagini png;
  Io ho installato: python-rsvg, librsvg2-2, librsvg2, librsvg2-dev, librsvg2-common, librsvg2-bin)
• Scompattare i file nugsl-tagtool-1.5.tgz e nugsl-worldmap-1.16.tgz (per esempio in /home/UTENTE/Scrivania/prova)
• Aprire il terminale ed entrare nella directory nugsl-tagtool-1.5 digitando:
  cd /home/UTENTE/Scrivania/prova/nugsl-tagtool-1.5
  e installarlo con:
  sudo python setup.py install
• Entrare nella directory nugsl-worldmap-1.16 digitando:
  cd /home/UTENTE/Scrivania/prova/nugsl-worldmap-1.16
  e installarlo con:
  sudo python setup.py install
  Verrà installato in /usr/local/bin/nugsl-worldmap.
• Copiare la directory nugsl-worldmap-1.16 in /usr/share/ e rinominarla per ottenere:
  /usr/share/nugsl-worldmap
  (credo che sia importante solo la directory "data", dovrei fare delle prove)
• Aprire un terminale e entrare in /home/UTENTE/Scrivania/prova/nugsl-worldmap-1.16/examples digitando:
  cd /home/UTENTE/Scrivania/prova/nugsl-worldmap-1.16/examples
  e all'interno di questa directory per eseguire l'esempio digitare:
  ./sample.sh

All'interno di examples verranno creati vari file tra i quali una mappa del mondo colorata demo_tropical_flat.svg vari file demo_NAZIONE.png più altri file demo_xxxxx.html

Impostazioni mediante i vari files di configurazione Torna su

clickablepage.html               È IL TEMPLATE PER LE PAGINE HTML CREATE

Le stringhe all'interno dei caratteri @@ sono variabili impostate negli altri file di impostazione

sample.countryconfig            ELENCO DEGLI STATI DI CUI CREARE LE PAGINE HTML
[id]                            (tra parentesi quadre inserire il codice della nazione, Codici a fondo pagina)
title: Indonesia                (dopo i due punti inserire cosa dovrà apparire all'interno del tag title)
url: demo_indonesia.html        (dopo i due punti inserire il nome che dovrà avere la pagina html)
...

sample.pins                     IMPOSTAZIONI DEI BULLET(pinpoints)
[DEFAULT]
default_pinwidth: 120%          (le dimensioni relative del bullet(pinpoints))

[Jakarta]                       (tra parentesi quadre il nome della nazione
latitude: 6s08                  (dopo i due punti inserire la latitudine)
longitude: 106e45               (dopo i due punti inserire la longitudine)
country: id                     (dopo i due punti inserire il codice della nazione)
url: http://www.google.com/search?q=jakarta            (dopo i due punti inserire l'indirizzo a cui dovrà puntare il link
...

tropical_world.sty              STILI PER LA PAGINA INDICE CON IMMAGINE DEL MONDO

sepia_world.sty                 STILI PER LA PAGINA INDICE CON IMMAGINE DEL MONDO IN SEPIA

pins_only.sty                   STILI PER LE PAGINE CON BULLET(pinpoints)

Sono elencate le classi da applicare "stroke" per gli stili di linea e "fill" per il riempimento

sepia_country.sty                STILI PER LE PAGINE CON IMMAGINI DEGLI STATI IN SEPIA COMPRESI I BULLET(pinpoints)

sepia_country_nopins.sty         STILI PER LE PAGINE CON IMMAGINI DEGLI STATI IN SEPIA SENZA MOSTRARE BULLET(pinpoints)

Sono rilevanti le classi .pinpoint {opacity:0;} e .circle{opacity:0;} che nascondono gli eventuali bullet(pinpoints)

sample.sh                        FILE ESEGUIBILE CON LE OPERAZIONI DA COMPIERE

Estratto del file tradotto e commentato

#!/bin/sh                                                                       # INDICA L'INTERPRETE DA UTILIZZARE PER ESEGUIRE LO SCRIPT

echo Sto generando una mappa piatta "tropicale" con bullets ...                 # echo stampa la frase che lo segue
nugsl-worldmap -t flat \                                                        # -t = "rotated", "flat" o "orig").(predefinito: flat)
               -o demo_tropical_flat.svg \                                      # -o = URL e nome del file in uscita
           -P sample.pins \                                                     # -P = file con le impostazioni di stile dei bullets
           -S tropical_world.sty                                                # -S = file con le impostazioni di stile per la mappa

echo ''                                                                         # stampa una riga vuota

echo Sto generando una mappa PNG "sepia" cliccabile del Laos ...
echo '(con livelli separati per stato e bullet, per il postprocessing)'
nugsl-worldmap -o demo_laopdr.svg \
               -c la \
               -C sample.countryconfig \                                        # -C = file con le impostazioni di stile per gli Stati
               -P sample.pins \
           -S sepia_country.sty,sepia_country_nopins.sty,pins_only.sty \        # -S = elenco file con le impostazioni di stile per la mappa
           -T clickablepage.html \                                              # -T = file template per le pagine HTML
           -x 1024 -y 450 -D -X                                                 # -x = larghezza in pixel, -y = altezza,
                                                                                # -D = no-imagemap, -X = cancella file usati
echo ''
....

Help Shell Torna su

Per il significato di altre opzioni non trattate digitare nel terminale: nugsl-worldmap
che stamperà:

Options:
  -h, --help            show this help message and exit
  -c COUNTRY, --country=COUNTRY
                        Write a file containing only COUNTRY.
  -C FILE, --country-config=FILE
                        List of config files from which to read country
                        formatting data.  (Meaningless with -t orig)
  -D, --suppress-country-imagemap
                        Suppress creation of country imagemap in HTML
                        templates
  -e VALUE, --extend-poles=VALUE
                        Factor by which to extend the poles when calculating
                        units of latitude. (Default: 1.112)
  -f RENDER_TYPE, --render-file-type=RENDER_TYPE
                        Type of rendered file to write ("png" or "jpg").
                        (Default: png)
  -H, --extended-help   Display sample content for pinpoint and stylesheet
                        configuration files.
  -i INPUT, --input-file=INPUT
                        WikiMedia Robinson projection of the world in SVG
                        format (Defaults to internal copy)
  -m MERIDIAN, --meridian=MERIDIAN
                        Line of longitude to place at the center of the image.
                        Form is 179E59.  Range is 180W to 180E. (Default: 0W)
  -o FILE, --output=FILE
                        Write output on FILE (mandatory)
  -p STRING, --pins=STRING
                        List of coordinates to mark in the map.  Format is
                        100n20:23w43.  (Meaningless with -t orig)
  -P FILE, --pin-file=FILE
                        List of config files from which to read pin data.
                        (Meaningless with -t orig)
  -Q, --suppress-pinpoint-imagemap
                        Suppress creation of pinpoint imagemap in HTML
                        templates
  -S FILE, --style-file=FILE
                        Comma-delimited list of files containing CSS style
                        code.  Stylesheet of SVG output file is replaced with
                        this code.  If multiple files are specified, files
                        after the first are distinguished by a numeric
                        extension to the base filename.
  -t TYPE, --type=TYPE  Type of projection to write ("rotated", "flat" or
                        "orig").  (Default: flat)
  -T FILE, --html-template=FILE
                        Use FILE as HTML template for clickable imagemap page.
  -w SIZE, --pin-width=SIZE
                        Width of pin markers, either in map units, or as a
                        percentage (i.e. 110%) of the default.  (Default:
                        10.0)
  -W SIZE, --rendered-pin-width=SIZE
                        Width of pin markers, in pixels.  Requires -x or -y.
  -X, --cleanup         Clean up working files after producing rendered images
  -x SIZE, --render-width=SIZE
                        Renders image as bitmap, with this as maximum width.
                        Default is 0.
  -y SIZE, --render-height=SIZE
                        Renders image as bitmap, with this as maximum height.
                        Default is 0.

Spero che sia abbastanza chiaro come modificare i files per utilizzare lo script e che queste indicazioni siano utili a qualcuno che, come me, non sia riuscito ad usare subito nugsl.