[zdl-devel] altri lavori... in vista della nuova pagina web

[Gianluca Zoni]

Prima di modificare la pagina di manuale ho aspettato la fine di
una serie di potenziamenti, estensioni e test. Anche perché,
anziché aggiornare la pagina a cui http://nongnu.org/zdl è
reindirizzato, credo sia necessario un altro importante passo
verso la condivisione della stessa "pagina iniziale" sul server
di savannah-gnu (di questo tratterò in fondo a questa email).

Negli ultimi tre giorni ho fatto altri interventi nel codice (a
parte il lavoro di analisi sui controlli e lo sviluppo ulteriore
delle estensioni):

1) il parser dei link, che controlla preventivamente (in più
   tappe del processo) se si tratta di un url valido, escludendo
   anche gli url con protocolli non compatibili con Wget e Axel
   (il filtro sui protocolli va definito meglio. Per ora
   controlla solo se esiste almeno una delle seguenti
   sottostringhe: "ftp" e "http" dentro a una "STRINGA://" già
   estratta all'inizio del presunto url)

2) la directory di destinazione fra gli argomenti di
   ZDL. Riordinando i controlli in /usr/local/bin/zdl ho pensato
   si potesse inserire anche questo argomento in automatico, ma è
   necessario che sia controllato prima dell'inizializzazione del
   programma (che crea la cartella dei file temporanei). In
   seguito (dopo l'inizializzazione), ZDL procede con il
   controllo delle opzioni e quando le ha superate tutte verifica
   i file con l'elenco dei link e solo alla fine filtra i
   presunti URL (punto 1 di questa email). È molto importante
   l'ordine di questi controlli (e spero sia corretto) perché ZDL
   può essere avviato in un sacco di modi diversi e con gli
   argomenti mescolati e i controlli potrebbero essere in
   conflitto. 

3) installazione automatica delle dipendenze attraverso
   l'installer (da estendere anche nell'updater?). ZDL dipende da
   due pacchetti (essendo uno script bash, in realtà dipende da
   un casino di pacchetti, ma quelli che seguono è più facile che
   non siano installati, rispetto agli altri): Axel e XTerm. Sia
   nel primo che nel secondo caso, la dipendenza non è
   "stretta". Infatti ZDL può scaricare file anche solo con Wget
   (dobbiamo aggiungere anche questo o si trova già installato?
   se sì, come?) senza Axel. Inoltre, ZDL è un programma
   perfettamente utilizzabile senza ambiente grafico, quindi
   anche senza browser grafici e dunque senza XTerm. Questa
   semi-dipendenza può creare problemi, se si vogliono rispettare
   tutti i casi possibili. D'altra parte è più probabile che sia
   usato da chi ha già un ambiente grafico e vuole scaricare con
   Axel. 


Per quanto riguarda la documentazione online, raggiungibile da
http://nongnu.org/zdl, c'è da ragionare su come impostarla. Pare
proprio che non possa essere dinamica. Ho cercato spiegazioni
all'interno di savannah, ogni volta che avevo un po' di tempo per
fare ricerche, ma non ho trovato alcuna informazione a
riguardo. Dopo qualche test per php, perl, python, bash... senza
successo, ho fatto un'esplorazione fra le pagine di
documentazione di altri progetti e ho notato che sono tutte
statiche e alcune sono state realizzate con programmi tipo
"naturaldocs" e "sphinx" (che producono la documentazione html
statica in locale, da caricare sul server attraverso cvs [non si
può usare git]). Ho provato questi due programmi ma sono
inutilmente complicati per un progetto come ZDL.
Ho trovato però una via di mezzo, per non dover fabbricare un
sito web statico da zero: la documentazione del progetto
Quagga (http://nongnu.org/quagga). È gradevole e chiara,
semplice, minimale e offre molti spunti interessanti,
appoggiandosi agli strumenti di savannah/gnu. Possiamo scaricarne
la struttura, i fogli di stile ecc. e modificare il tutto come ci
pare. E non sarebbe male inventare anche un logo per ZigzagDL,
magari giocando sul zigzag... 



-- 
Z O N I N O Z
Gianluca Zoni

address@hidden
http://inventati.org/zoninoz
http://savannah.gnu.org/users/zoninoz