# Applet GNOME Weather

Copyright © 1999-2000 Spiros Papadimitriou e Dan Mueth

Copyright © 2000 Leandro Noferini (Traduzione italiana)

# GNOME Weather Applet

L'applet `GNOME Weather`, mostrata in Figura 1, riceve e mostra alcune informazioni sulle condizioni atmosferiche. Per aggiungere questa applet ad un Pannello, cliccate con il tasto destro del mouse sul Pannello e scegliete Pannello->Aggiungi al pannello->Applet->Utilità->GNOME Weather.

Figura 1. Applet GNOME Weather

## Uso

`GNOME Weather` mostra la temperatura e le condizioni atomsferiche correnti in forma numerica e di icona all'interno dell'applet. Per ottenere ulteriori informazioni cliccate due volte sull'applet stessa, aprendo così la finestra Weather Information Window, mostrata in Figura 2 dove vengono mostrate le informazioni delle condizioni attuali e le previsioni per uno e cinque giorni (queste previsioni sono però disponibili solo per località statunitensi).

Figura 2. Finestra Weather Information

Cliccando con il tasto destro del mouse sull'applet appare un menù contenente le seguenti voci:

- Aggiorna — aggiorna le informazioni sulle condizioni atmosferiche e le mostra.

- Proprietà… — apre la finestra di dialogo `Proprietà`.

- Aiuto — mostra questo documento.

- Informazioni su… — mostra informazioni riguardo `Applet GNOME Weather`, come la versione dell'applet e il nome dell'autore.

## Personalizzazione

È possibile personalizzare l'applet `GNOME Weather` cliccandoci sopra con il tasto destro del mouse e scegliendo Proprietà…. Apparirà così la finestra di dialogo Proprietà (mostrata in Figura 3), con la quale è possibile modificare alcune impostazioni.

Figura 3. Finestra di dialogo Proprietà

Le proprietà nella sezione `Semplice` sono:

- Intervallo di aggiornamento — Questa opzione determina l'intervallo di tempo fra una connessione al server e la successiva in cui `GNOME Weather` ottiene le informazioni metereologiche (condizioni correnti, previsioni e mappa radar, se abilitata).

  | Nota sull'Intervallo di Aggiornamento
  | Notare che l'`Intervallo di aggiornamento` determina solo quante volte il vostro computer ottiene le informazioni dal server. L'aggiornamento mostrato nella sezione Condizioni Attuali (visibile cliccando due volte sull'applet) indica quando sono state effettuate le misurazioni sul server e non quando sono state ottenute.

  | Disabilitare l'Aggiornamento automatico e usare l'Aggiornamento Manuale
  | È possibile disabilitare l'aggiornamento automatico deselezionando il bottone `Aggiornamento abilitato`. D'altra parte è anche possibile forzare `GNOME Weather` ad effettuare un aggiornamento indicando l'opzione corrispondente dal menù popup. Queste due opzioni sono molto utili se siete connessi ad internet non in modo continuo, come ad esempio usando un computer portatile o una connessione via modem.

- Aggiornamento abilitato — Selezionate questa opzione se volete far sì che `GNOME Weather` si connetta automaticamente per ottenere le informazioni metereologiche aggiornate ad ogni intervallo indicato in `Aggiorna`. Deselezionando questa opzione potrete ottenere gli aggiornamenti solo cliccando con il tasto destro del mouse sull'applet e indicando Aggiorna.

- Usa la metrica — come default `GNOME Weather` usa il sistema metrico degli Stati Uniti d'America (Imperiale). Selezionando questo bottone verrà usato il sistema metrico europeo, come mostrato in Tabella 1.

  Tabella 1. Unità di Misura

  Quantità | Metrica | Imperiale
  --- | --- | ---
  Temperatura | gradi Celsius | gradi Farenheit
  Velocità del vento | km/h | mph
  Pressione | mmHg | inHg
  Visibilità | km | miles

- Previsioni dettagliate — Selezionate questa opzione se volete che `GNOME Weather` scarichi le previsioni complete per più di cinque giorni per la vostra area. Notate però che le previsioni non sono disponibili per alcune zone.

  Le previsioni ottenute se questo bottone non è premuto sono relative solo ad un'area ristretta intorno alla zona selezionata e sono validi normalmente solo per cinque giorni.

  | Disponibilità delle Previsioni
  | Notate che la previsioni dettagliate ottenute da IWIN sono disponibili solo per le città degli Stati Uniti d'America.

Le proprietà nella sezione `Network` possono essere usate nel caso in cui il vostro computer si trova dietro ad un firewall e sono:

- Usa server proxy — Selezionate questo bottone se il vostro computer è dietro ad un firewall e dovete usare un proxy HHTP per accedere al Web.

- Server Proxy — Indicate qui il numero IP del server proxy (nel caso lo stiate usando).

- Utente — Indicate qui il nome dell'utente da usare sul server proxy (nel caso questo sia necessario).

- Password — Indicate qui la vostra password sul server proxy. (Notate che questa password verrà salvata in un file di configurazione privato ma che non verrà criptata).

La sezione `Posizione` permette di specificare la posizione geografica che volete venga usata dall'applet `GNOME Weather` per mostrare le informazioni metereologiche. Cliccate sul simbolo "+" per espandere un ramo o sul simbolo "-" per ridurlo. Selezionate la città o la regione cliccando con il tasto destro del mouse.

Le posizioni sono organizzate con una gerarchia a tre livelli. Il livello più in alto contiene le aree geografiche più ampie, la seconda le sotto-regioni comprese nelle prime e nell'ultimo si trovano le posizioni particolari. Questa gerarchia rispecchia il modo in cui vengono immagazzinate queste informazioni da parte dell'US NWS (National Weather Service), ed è per questa ragione che gli Stati Uniti d'America e il Canada appaiono al livello più alto.

Fatti i cambiamenti voluti cliccate sul pulsante OK per salvarli e chiudete la finestra di dialogo Proprietà. Per annullare le modifiche e tornare alle impostazioni precedenti, cliccate sul pulsante Chiudi.

## Ulteriori informazioni

`GNOME Weather` ha una homepage a http://gweather.dhs.org/. Qui è possibile trovare la versione più aggiornata del file Posizioni, che viene periodicamente aggiornato con nuove città spedite da altri utenti. Se la vostra città non è inclusa nella distribuzione spedite una email a Spiros Papadimitriou (`<spapadim+@cs.cmu.edu>`) con le informazioni necessarie e questa verrà inclusa nella versione successiva.

È possibile anche visitare l'homepage se siete curiosi di vedere cosa c'è di nuovo.

## Bug conosciuti e limitazioni

### Input/Output bloccante

Anche se adesso `GNOME Weather` usa adesso un sistema di Input/Output di tipo non blocccante per ricevere i dati dalla rete, ci sono alcuni piccoli passi che possono bloccare l'esecuzione del programma. Più precisamente, stabilire una connessione TCP con un server remoto è un'operazione che può comportare il bloccamento dell'applicazione; poiché i server web di NWS e IWIN sono spesso molto sovraccarichi, questo passo può durare molto tempo e durante questo periodo l'applicazione non può rispondere alle richieste CORBA provenienti dal Pannello. Nella sua versione attuale il Pannello interagisce con tutte le applicazioni e invia frequentemente richieste CORBA (ad esempio per sapere lo stato del salvataggio). Se un'applet non può rispondere per una qualsiasi ragione allora il Pannello si bloccherà in attesa di una risposta

Mentre il Pannello è bloccato non potrà rispondere a nessuna richiesta dell'utente (o di un'altra applicazione). Per esempio i movimenti e i menù (quelli che apparirebbero cliccando con il tasto destro del mouse) del Pannello non funzionano. Le altre applet presenti sul Pannello dovrebbero comunque continuare a funzionare (a meno che non debbano inviare richieste CORBA al Pannello, ad esempio per conoscere la dimensione del Pannello). Appena l'operazione che ha causato il blocco di `GNOME Weather` termina le cose dovrebbero tornare al normale (e le richieste dell'interfaccia utente bufferizzate vengono eseguite).

Esiste una versione sperimentale di `GNOME Weather` che usa thread separati lavorando sull'HTTP, versione che verrà inclusa temporaneamente nella prossima versione. Comunque la soluione finale sarà `gnome-vfs` che farà parte di GNOME 2.0 e che permetterà supporto multi-piattaforma per operazioni di Input/Output completamente asincrone.

## Domande poste frequentemente (FAQ)

Questa è una lista di domande poste freuqentemente a proposito di `GNOME Weather`. Per ulteriori informazioni e aggiornamenti visitate la homepage di GNOME Weather. Se la vostra domanda rimane ancora senza risposta scrivete all'autore: `<spapadim+gweather@cs.cmu.edu>`.

### Perché GNOME Weather blocca il mio Pannello?

Questo è dovuto al fatto che alcune operazioni sulla rete bloccano le altre operazioni (vedi anche la sezione Input/Output bloccante) ed è dovuto al modo in cui lavora attualmente il Pannello.

### Perché la lista delle posizioni mi appare vuota?

Questo è dovuto al fatto che il file `Posizioni` non è stato installato nel posto corretto, normalmente perché `GNOME Weather` e GNOME non sono stati configurati allo stesso modo. Il file contenente le posizioni dovrebbe essere installato nella sottodirectory `gweather`, all'interno della directory dei dato di gnome, verificabile con il comando `gnome-config --datadir`.

Se avete compilato da soli le applet di gnome assicuratevi di aver usato il seguente comando: `configure --prefix=`gnome-config --prefix` --sysconfdir=`gnome-config --sysconfdir``. Le distribuzioni binarie in RPM assumono che prefix e sysconfdir siano rispettivamente in `/usr` e `/etc`. Se avete compilato GNOME da soli con opzioni differenti dovete scaricare e compilare le applet da soli.

### Perché GNOME Weather mostra un punto interrogativo e dei puntini per le condizioni correnti?

Questo accade se `GNOME Weather` non riesce a connettersi al server NWS per una ragione qualsiasi, come ad esempio nel caso in cui la connessione di o il server NWS rete siano inattivi, oppure il server non abbia a disposizione le informazioni per la vostra posizione.

### Perché GNOME Weather mi segnala che la previsione non è disponibile?

Se avete selezionato la previsione dettagliata allora è possibile che questa non sia disponibile per la vostra posizione. Nel caso provate a disabilitare la previsione dettagliata.

Un'altra possibile ragione è che il server IWIN non sia attivo e che `GNOME Weather` non possa ricevere le informazioni sulle previsioni. Il problema in questo caso dovrebbe scomparire appena il server IWIN torna attivo.

## Autori

`GNOME Weather` è stata scritta da Spiros Papadimitriou (`<spapadim+@cs.cmu.edu>`). Inviate tutti i commenti, suggerimenti e notifiche di errori al GNOME bug tracking database. (Le istruzioni per riportare errori possono essere trovate on-line. Se state usando la versione di GNOME 1.1 o una più recente è possibile usare anche il programma `bug-buddy` (bug-buddy), che si trova nel sotto-menù Utilità nel Menù Principale, per riportare errori.

Questo manuale è stato scritto da Spiros Papadimitriou (`<spapadim+@cs.cmu.edu>`) e Dan Mueth (`<d-mueth@uchicago.edu>`). Inviate tutti i commenti e i suggerimenti riguardo questo manuale allo GNOME Documentation Project mandando un email a `<docs@gnome.org>`. È possibile anche spedire commenti on-line usando lo GNOME Documentation Status Table.

La traduzione italiana è stata curata da Leandro Noferini (`<lnoferin@cybervalley.org>`). Inviate tutti i commenti e suggerimenti riguardo questa traduzione a `<gnome-i18n@it.gnome.org>`.

## Licenza

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included as an appendix to the GNOME Users Guide. You may also obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

Free Software Foundation, Inc.
59 Temple Place - Suite 330
Boston, MA 02111-1307
USA