ROX-Filer: manuale dell'utente http://rox.sourceforge.net

Se si desidera che il filer gestisca lo sfondo del desktop, si deve usare l'opzione --pinboard seguito da un nome per la bacheca, come ad esempio:

$ rox --pinboard=MiaBacheca

Se si cambia qualcosa, per esempio se si rilascia un file sullo sfondo, la configurazione della bacheca viene salvata in `~/.config/rox.sourceforge.net/ROX-Filer/pb_MiaBacheca'. Si possono avere tutte le bacheche che si desiderano e per passare dall'una all'altra basta eseguire di nuovo «rox», come ad esempio:

$ rox --pinboard=AltraBacheca

Per disattivare la bacheca, lasciare vuoto il campo del nome:

$ rox --pinboard=

Vedere le note per i window manager se ci sono problemi nel visualizzare correttamente le icone. Si può anche attivare o disattivare la bacheca selezionando in una finestra del filer la directory applicativa `ROX-Filer' e scegliendo dal menù Attiva la bacheca o Disattiva la bacheca .

I pannelli funzionano come la bacheca, ma vengono visualizzati sui bordi dello schermo. Per creare un pannello:

$ rox -b=MioPannello

Il pannello viene visualizzato in una finestra senza la barra del titolo. Se questo non succede, consultare le note per i window manager. Trascinare i file sul pannello per aggiungerli ad esso. Le icone possono essere riposizionate trascinandole col tasto centrale del mouse. Le modifiche al pannello sono automaticamente salvate in `~/.config/rox.sourceforge.net/ROX-Filer/pan_MioPannello'. Come per la bacheca, è possibile passare a diverse configurazioni eseguendo di nuovo «rox» con un altro nome di pannello.

$ rox -b=AltroPannello

Con un menù a comparsa si può impostare su quale bordo dello schermo deve apparire il pannello, oppure si può specificare il nome del bordo al posto di -b (ad es. --bottom). Lasciare vuoto il campo del nome per rimuovere il pannello:

$ rox --bottom=

Bisogna modificare le impostazioni del proprio window manager per visualizzare correttamente la bacheca e i pannelli (ad es. per non avere i bordi e i titoli come nelle altre finestre). In particolare, si deve impostare il livello e la profondità di stacking al minimo (o a un valore negativo). Assicurarsi inoltre di disattivare qualsiasi opzione del tipo «Keep transients above other windows».

(require 'gnome)

      # Manage root window (EXPERIMENTAL - normally enabled!)
      GrabRootWindow=1 # 0/1
      # Bitmask of root window button click to use in window manager
      UseRootButtons=3 # [0-255]
      # Desktop mouse-button click to show the menu
      DesktopWinMenuButton=1 # [0-20]
      # Desktop mouse-button click to show the window list
      DesktopWinListButton=2 # [0-5]
      # Desktop mouse-button click to show the window list menu
      DesktopMenuButton=0 # [0-20]

      # ROX-Filer pinboard and panel
      ROX-Filer.icon: folder
      ROX-Panel.layer: Dock
      ROX-Panel.doNotCover: 1
      ROX-Panel.ignoreWinList: 1
      ROX-Panel.ignoreTaskBar: 1
      ROX-Panel.ignoreQuickSwitch: 1
      ROX-Pinboard.layer: Below
      ROX-Pinboard.ignoreWinList: 1
      ROX-Pinboard.ignoreTaskBar: 1
      ROX-Pinboard.ignoreQuickSwitch: 1
      ROX-Filer.layer: Normal

Se si avvia il filer come utente «root», viene mostrato un messaggio in alto su ciascuna finestra. L'utente «root» infatti ha i permessi di accesso e di modifica su ogni file del sistema, quindi bisogna stare molto attenti. Normalmente, si dovrebbe accedere al sistema come utente normale e passare a «root» solo quando è assolutamente necessario. Se sudo è installato e configurato, allora si può avviare il filer in questo modo:

$ sudo rox

Attenzione: ogni operazione su file e ogni programma avviato da questa finestra viene eseguito come utente «root».

Può accadere che il server X non permetta a «root» (o ad altri utenti) di connettersi. Leggere le pagine di manuale dei comandi xauth e xhost può aiutare a risolvere il problema, ma molte cose cambiano da sistema a sistema (ecco perché questa caratteristica non è stata inserita nel filer).

Nota: gnomesu può essere usato per eseguire il filer come root, ma è necessario usare setsid per eseguirlo in una nuova sessione, altrimenti gnomesu termina senza aprire alcuna finestra. Per esempio:

gnomesu -c 'setsid /usr/local/bin/rox /'

A volte è utile salvare la selezione attuale, per farlo basta premere Control+<numero> tra zero e nove. Per ripristinare la selezione, basta premere il numero di prima. È possibile farlo da directory differenti o da finestre di filer differenti.

Se si salva quando non c'è nessuna selezione, viene salvata la directory attuale.

I gruppi di selezione vengono salvati automaticamente e sono disponibili anche la prossima volta che si usa il filer.

Tutti i menù funzionano in modo simile. Per esempio, attivando il menù su qualche elemento selezionato, l'operazione si applica solo agli elementi selezionati. Attivando invece il menù su un elemento quando non c'è nessuna selezione, quell'elemento viene selezionato momentaneamente.

Attivando un menù né su un elemento né su una selezione, la finestra va in "modalità bersaglio": l'operazione viene eseguita sul prossimo elemento su cui si fa clic. Si esce dalla modalità bersaglio premendo Esc, facendo clic sullo sfondo della finestra o con il tasto destro del mouse. Questa modalità è utile con l'opzione Navigazione a singolo clic e con i tasti associati alle varie voci di menù.

Notare che le singole applicazioni possono aggiungere altri menù in cima ai sottomenù che si ottengono facendo clic sopra di esse. Vedere Directory applicative per ulteriori dettagli. In alto ci può essere un numero qualsiasi di azioni definite dall'utente, che dipendono dal tipo di file su cui si fa clic. Per aggiungere dei programmi, selezionare la voce Personalizza il menù.... Per esempio, è possibile far apparire come menù Gimp per le immagini e FreeFS per i punti di mount.

Nota sui collegamenti simbolici:  un collegamento simbolico memorizza il percorso di un altro file. Eliminando questo collegamento, non si influenza l'altro file. Eliminando invece l'altro file, il collegamento simbolico viene interrotto. Ci sono due tipi di collegamento simbolico: assoluto e relativo. Un collegamento simbolico assoluto memorizza il percorso partendo dalla radice («/» o «root»), per esempio: `/home/fred/MyFile'. Un collegamento simbolico relativo memorizza il percorso partendo dal collegamento stesso, per esempio `../fred/MyFile'. Se non si ha intenzione di spostare il file di destinazione, è meglio usare un collegamento assoluto, altrimenti uno relativo.

Questo menù permette di selezionare e di deselezionare i file in vari modi. Vedere la sezione Pulsanti del mouse e associazioni dei tasti per gli altri modi di selezionare i file.

Ciascuna voce di questo menù apre una finestra per creare un nuovo file o una nuova directory. Ci sono due voci predefinite, le altre sono il contenuto della directory `~/.config/rox.sourceforge.net/Templates', se esiste.

Per aggiungere nuove voci, scegliere Personalizza e mettere i file lì dentro. I file di quella directory compaiono quindi nel menù e vengono usati per creare i nuovi file. Per esempio, se si desidera creare un file HTML vuoto:

<html>
 <head>
  <title>Titolo della pagina</title>
 </head>
 <body>
  Il contenuto della pagina.
 </body>
</html>

Salvando questo file come `index.html' dentro la directory `Templates' si possono creare facilmente file HTML. È possibile anche salvare documenti vuoti di vario tipo, come ad es. un foglio di calcolo, una lettera, ecc...

Notare che al momento non è possibile impostare le scorciatoie per questi tipi di voci.

Il menù «Invia a...» fornisce un modo veloce per inviare file a un'applicazione. Il filer analizza tutte le directory `SendTo' nel $XDG_CONFIG_DIRS/rox.sourceforge.net/SendTo (vedere [BaseDir]) ed elenca il contenuto in questo menù.

Per cambiare le applicazioni che appaiono, scegliere Personalizza in fondo al menù. Si apre quindi la directory `SendTo'. Si possono creare collegamenti simbolici alle applicazioni, trascinandole qui e scegliendo Collegamento dal menù.

Aprire «Invia a...» dal menù principale è piuttosto scomodo, normalmente lo si apre facendo clic col tasto destro del mouse su un file e tenendo premuto il tasto Shift.

Il menù segnalibri viene usato per memorizzare un elenco di directory usate frequentemente. È possibile aprirlo anche dal menù principale (sottomenù Finestra) e creare una scorciatoia associandolo a un tasto. Dal menù segnalibri è possibile aggiungere alla lista la directory attualmente visualizzata, spostarsi in una directory memorizzata, o aprire una finestra di dialogo per modificare l'elenco. Se necessario, si possono rimuovere le voci, riordinarle (usando le frecce o trascinandole) e modificare direttamente i percorsi.

Il sottomenù Visitati di recente mostra le ultime directory viste. Sceglierne una per entrarci subito. La directory attuale è ombreggiata, dal momento che ci si trova già lì.

Per creare le impostazioni predefinite per gli altri utenti come l'icona «Home» che punta alla directory dell'utente stesso, prima si deve creare una nuova icona, poi si deve usare Modifica elemento per cambiare il percorso in `~' e infine rinominarlo «Home».

Notare che facendo clic su certe applicazioni, queste possono aggiungere alcuni menù in cima al menù principale. Vedere Directory applicative per ulteriori dettagli.

ROX-Filer permette di eseguire dentro il pannello piccole applicazioni di nome applet. Per eseguirne una, trascinarla nel pannello dalla finestra del filer. La sua icona non viene visualizzata, ma l'applet viene eseguita.

Quando è attiva la bacheca, ROX-Filer può visualizzare le finestre ridotte a icona (o «minimizzate») mostrando un'opportuna icona sulla bacheca. Attivare questa funzione nella finestra «Opzioni». Le finestre ridotte a icona hanno uno sfondo semitrasparente e possono essere spostate. Fare clic sopra per ripristinare la finestra. Alcuni vecchi window manager non supportano questa funzione, quindi nessuna icona viene mostrata.

È possibile scegliere un'immagine per lo sfondo, scegliendo Sfondo... dal menù della bacheca (tasto destro del mouse sullo sfondo se la bacheca è attiva).

Selezionare Centra, Scala, Stira o Affianca per impostare lo stile, poi trascinare un'immagine nell'area sottostante. Per ritornare a un colore uniforme, (definito nella finestra «Opzioni»), fare clic su Pulisci.

Si può usare l'applicazione «Wallpaper» [Wallpaper] per creare effetti più complessi, come la scelta casuale di un'immagine ogni ora o il rendering dell'immagine della Terra come è attualmente illuminata dal sole.

Per i programmatori.  Se si desidera creare un'applicazione che imposta lo sfondo, per es. che sceglie un'immagine casuale o una sequenza di diapositive, è necessario prima creare una directory applicativa (vedere Directory applicative).

Se eseguita senza argomenti, l'applicazione dovrebbe attivare il metodo SOAP SetBackdropApp (vedere Appendice C, SOAP RPC). Il filer quindi la riesegue immediatamente e, questa volta, con l'opzione --backdrop.

Se eseguita con --backdrop, il programma dovrebbe scrivere lo stile e il nome del file immagine da visualizzare nel suo standard stream di output, es:

tile /tmp/image.png

centre e scale sono gli altri stili possibile. Il filer quindi carica l'immagine e la visualizza. L'applicazione non imposta lo sfondo, ma dice solamente al filer cosa visualizzare.

Nel caso di uno sfondo con immagine casuale, il programma può terminare immediatamente. Se l'applicazione ha creato un'immagine temporanea, dovrebbe leggere la riga "ok\n" dal suo standard input prima di cancellare l'immagine.

Se l'applicazione desidera mostrare una sequenza di immagini, dovrebbe ancora leggere "ok\n", quindi aspettare fino al momento di visualizzare l'immagine successiva e poi scrivere quel nome di file, e così via.

Chiudendo i due stream, il filer indica che il programma si deve fermare. A questo punto il programma dovrebbe terminare. Per eliminare qualunque file temporaneo, assicurarsi di catturare SIGPIPE quando si scrive sullo standard output.

Per un esempio completo, vedere l'applicazione «Wallpaper» [Wallpaper] (scritta in python).

Se le miniature sono attive, ROX-Filer controlla la directory `~/.thumbs/normal' per cercare una miniatura per ogni file che scansiona. Se la miniatura esiste, la carica e continua con il file successivo.

Per generare la miniatura di un file di un certo tipo di «media/subtype», il filer cerca un programma prima in `~/.config/rox.sourceforge.net/MIME-thumb/media_subtype' e poi in `~/.config/rox.sourceforge.net/MIME-thumb/media' (come quando si visualizzano applicazioni differenti per tipi di file differenti). Se non viene trovato niente e se il file è di tipo «image/*» allora vengono usate le routine interne. Se il file non è di tipo «image/*», non viene creata alcuna miniatura.

Se viene trovato il programma per generare le miniature, allora viene eseguito con i parametri

generatore_miniature /percorso/al/file /percorso/alla/miniatura dim_pixel

Non appena il processo figlio termina, si tenta di caricare `/percorso/alla/miniatura'. In caso di fallimento, non viene mostrata alcuna miniatura.

Notare che a causa dell'ordine di come avvengono le cose, ROX-Filer usa senza problemi qualunque miniatura preesistente, anche senza sapere come è stata generata.

Permette di inserire direttamente un percorso. Subito dopo averlo digitato la finestra viene aggiornata. L'uso principale è quello di trovare velocemente un file in una grande directory, ma lo si può usare anche per spostarsi tra le directory, per selezionare un percorso completo da un'altra parte e incollarlo direttamente nella barra.

Inserendo un nome che inizia per «.», la funzione «Mostra file nascosti» è attivata momentaneamente e il file può essere mostrato.

Il completamento automatico prova a ricostruire il nome con più caratteri possibili. Per esempio, se nella directory ci sono due file di nome `posta-salvata-nov-1999' e `posta-salvata-dic-1999' allora digitando posta e premendo Tab si espande posta fino a posta-salvata- e viene emesso un beep per indicare che la corrispondenza non è completa. Se il completamento automatico avviene su una directory ed è unico, allora il filer entra automaticamente in quella directory. Questo comportamento dovrebbe essere familiare agli utenti che usano una shell.

È un modo veloce per eseguire comandi di shell senza aprire un xterm. Chi non sa cosa sono i comandi di shell, salti questa sezione.

Basta digitare il comando e premere Invio per eseguirlo. Con le frecce Su e Giù ci si sposta tra i comandi precedentemente inseriti. Il tasto Tab è per il completamento automatico in stile shell. Facendo clic su un elemento si inserisce il suo nome nel minibuffer. Se vengono selezionati alcuni elementi, questi sono assegnati ai parametri di posizione $1, $2, ecc...

Se si apre il minibuffer quando c'è una selezione, alla fine del comando viene aggiunto "$@" che espande tutti i file selezionati.

Da usare se si desidera selezionare automaticamente tutti i file di una directory che corrispondono a una condizione.

Vengono quindi selezionati solo i file più grandi di 5 Mb. Le espressioni da inserire sono simili a quelle descritte nella sezione «Trova», ad eccetto di prune dal momento che il contenuto delle sottodirectory non è mai controllato. Premere Tab per passare su ciascun file selezionato.

Alcune azioni hanno delle opzioni, che appaiono nella parte inferiore della finestra. Esse sono:

Si possono modificare le impostazioni predefinite nella finestra «Opzioni».

Si possono inserire i metacaratteri dentro gli apici, come ad esempio:

Vedere la pagina di manuale di glob(7) per ulteriori informazioni sui metacaratteri.

Se il modello inserito contiene una barra («/»), la corrispondenza è sul percorso completo, altrimenti è solo sul nome. Per esempio: '*tmp*' trova `tmp' e `tmpfile' ma non `/tmp/file'; '/*tmp*' li trova tutti e tre.

Oltre a cercare i file in base al loro nome, è possibile farlo in base ad altri attributi. Notare che file è usato con il significato di «qualunque cosa si trova dentro un file system»: sono incluse le directory, i device, ecc...

È possibile usare anche una forma breve per ciascuna condizione (sono mostrate tra parentesi). Si possono combinare anche più condizioni: per esempio, «-rw» sta per «IsReadable and IsWriteable».

Per fare ricerche avanzate, si possono combinare in vari modi le condizioni semplici descritte sopra. Un'espressione è effettivamente composta da una lista di casi, separati da virgole. Il filer prova a cercare corrispondenze fino a trovarne una o fino all'esaurimento dei casi. Per esempio, per cercare file con diverse estensioni:

'*.gif', '*.htm', '*.html'

Inoltre, ciascun caso è effettivamente una lista di condizioni. C'è corrispondenza solo se tutte le condizioni sono soddisfatte. Quindi, per trovare una directory di nome `lib' o un file regolare con estensione `.so':

IsDir 'lib', IsReg '*.so'

Per negare una condizione, mettere davanti ad essa un !. Si può considerare una condizione anche un'espressione raggruppata in parentesi tonde, come ad esempio:

     !(IsDir, IsReg)

     !IsDir !IsReg

     Not isdir and not isreg

     !-d !-f

Tutti e quattro fanno la stessa cosa.

Per confrontare due numeri, usare gli operatori <, <=, =, !=, >, >= (cioè minore-di, minore-o-uguale-a, uguale-a, diverso-da, maggiore-di, maggiore-o-uguale-a). Per confrontare due date, usare after e before invece di > e < perché rendono più chiare le cose.

Il tempo è misurato come il numero di secondi trascorsi da Unix Epoca (00:00:00 UTC, 1 gennaio 1970). Le dimensioni sono misurate in byte. Si possono specificare altre unità di misura:

Ecco alcuni esempi che rendono più chiare le cose.

     mtime dopo 1 giorno fa

     dimensione > 10 Mb

     IsReg e nlinks > 1

Il primo trova i file modificati entro le ultime 24 ore. Si poteva usare > invece di dopo, ma non sarebbe stato altrettanto chiaro.

Il secondo trova i file più grandi di 10 Mb. Il terzo trova i file regolari con più di una voce nella directory.

Attenzione: il filer non controlla il contesto, quindi dimensione > 1 giorno fa è permesso, sebbene non abbia molto senso. Inoltre, dimenticarsi di usare fa o futuro provoca effetti insoliti (il tempo è relativo a Unix Epoca invece che al presente). Infine, mai usare = con le date atime = 1 giorno fa cerca un file il cui ultimo accesso è stato esattamente 86400 secondi fa.

Esempi:

     '*.old' system(rm '%')

     'src' prune, '*.c'

Il primo elimina ogni file con estensione `.old'. Il secondo cerca i file `.c', ma non controlla dentro le directory di nome `src'. L'espressione si legge così:

se il file si chiama `src' allora «Prune». Altrimenti, controlla se termina per `.c' e se è così, includilo nei risultati.

Scegliendo Imposta azione... dal menù «File», appare la finestra usata per impostare quale applicazione caricare quando si fa clic su quel tipo di file.

Per esempio, supponiamo che si voglia che un file `.gif' debba essere aperto con Gimp. Per prima cosa, clic destro su un'immagine gif per aprire il menù e quindi scegliere Imposta azione... dal sottomenù File. Ora ci sono due modi per impostare l'azione.

Scegliendo Imposta icona... dal menù «File», appare una finestra nella quale è possibile scegliere l'immagine da usare per rappresentare quel file.

Funziona come «Imposta azione...» descritto sopra, eccetto che si può specificare un'icona anche per un file singolo (dal nome) o per tutti i file di quel tipo. Quando si imposta l'icona per un file singolo, il filer memorizza il nome del file e il nome dell'icona dentro la directory `~/.config/rox.sourceforge.net/MIME-icons'. Se uno dei due si sposta, l'icona non viene più visualizzata.

Quando si imposta l'icona per una directory, si può anche memorizzare l'immagine dentro la directory stessa come file nascosto. Il vantaggio è che anche gli altri utenti possono vedere l'icona e poi si può anche eliminare l'immagine originale (notare che, se necessario, l'immagine viene ridimensionata e convertita nel formato PNG).

L'icona raffigurante una directory (che si trova dentro l'area Trascinare qui un'icona) permette di andare velocemente nella directory in cui ci sono già una o più icone.

ROX-Filer usa due sottodirectory della directory `~/.config/rox.sourceforge.net' per i tipi di file:

In `MIME-types' è possibile fornire le azioni predefinite per ciascun tipo di media. Per esempio, se non si trova `text_html', il filer prova semplicemente a usare `text'.

Il filer trova il tipo di file dal suo nome. Le regole vengono dai vari file `globs'. Vedere [SharedMIME] per ulteriori dettagli.

The filer normalmente determina il tipo di file dal suo nome. Se fallisce, prova a supporlo dal contenuto del file. È possibile ignorare questa supposizione impostando un attributo esteso sul file con il tipo corretto, usando il menù Tipo di file....

`AppInfo.xml' è un file XML con la seguente struttura (alcuni elementi possono essere omessi e il file stesso è opzionale):

<?xml version="1.0"?>
<AppInfo>
  <Summary xml:lang="en">A graphical file manager</Summary>
  <Summary xml:lang="de">Ein grafische Datei-Manager</Summary>
  <Summary xml:lang="nl">Een grafisch bestandsbeheerprogramma</Summary>
  <Summary xml:lang="it">File manager grafico</Summary>
  <About xml:lang="en">
    <Purpose>File manager</Purpose>
    <Version>1.3.5 PREVIEW</Version>
    <Authors>Thomas Leonard and others</Authors>
    <License>GNU General Public License</License>
    <Homepage>http://rox.sourceforge.net</Homepage>
  </About>
  <About xml:lang="it">
    <Purpose label="Scopo">gestione file</Purpose>
    <Version label="Versione"/>
    <Authors label="Autori">Thomas Leonard e altri</Authors>
    <License label="Licenza"/>
    <Homepage label="Sito web"/>
  </About>
  <AppMenu>
    <Item option="-p=Default">
      <Label>Enable pinboard</Label>
      <Label xml:lang="it">Attiva la bacheca</Label>
    </Item>
    <Item option="-p=">
      <Label>Disable pinboard</Label>
      <Label xml:lang="it">Disattiva la bacheca</Label>
    </Item>
  </AppMenu>
</AppInfo>

ROX-Filer è disponibile in varie lingue. Per sceglierne una, procedere in questo modo:

Vedere la pagina info di gettext per avere ulteriori istruzioni su come creare una traduzione.

La prima volta che si compila il programma è necessario eseguire AppRun --compile, ma quando si modificano i file `.c' e `.h' è sufficiente digitare make nella directory `src'. Si può anche eseguire make depend.

Le piccole modifiche ai sorgenti sono spesso distribuite come file patch. Di solito si fa così nella mailing list. Per applicare una patch, andare nella directory `src' ed eseguire patch con il file patch. Poi è necessario ricompilare.

     $ cd ROX-Filer/src
     $ patch < patchfile
     $ ../AppRun --compile

È possibile rimuovere la patch ripetendo semplicemente la sequenza sopra descritta. patch si accorge che la patch è già stata applicata e chiede se la si vuole rimuovere.

Per creare una patch bisogna prima avere l'ultima versione del filer dal CVS (le istruzioni su come usare CVS si trovano nel sito web). Modificare quindi il programma come si desidera e poi, nella directory opportuna, creare la patch usando cvs diff:

$ cvs diff -u > mia_patch

Questo crea un file patch leggibile dall'uomo e dalla macchina. Spedirlo quindi alla mailing list. Ci sono diverse ragioni per spedire patch invece dei file modificati:

Ecco una breve spiegazione del sistema autoconf nel caso non lo si abbia mai usato prima d'ora. Vedere info autoconf per ulteriori dettagli.

C'è un file di nome `configure.in' che contiene diversi test (info autoconf). Eseguendo autoconf, questo legge il file e genera uno script di shell per eseguire i test e lo salva come `configure'. `configure' è solitamente distribuito con il programma perché non tutti hanno autoconf.

Poi si esegue `configure' (infatti, lo script `AppRun' lo fa e gli passa alcuni argomenti), che esegue tutti i test. Legge `Makefile.in' e `config.h.in' e riempie i valori mancanti con i risultati del test e produce `Makefile' e `config.h'.

Eseguendo make, vengono creati i file `.o' dai file `.c' e linkati per produrre `ROX-Filer'.

Il file `global.h' elenca le principali strutture di dati usate nel filer e ne spiega lo scopo. È un buon punto di partenza per chi vuole sapere come funziona il filer.