Installazione di rest2web.

Di Nunziante Esposito.

Questo programma, usabile da riga di comando, serve a generare pagine html in una struttura che pu essere impostata con dei file di testo codificato, in
formato UTF-8 o altro similare, rispettando la sintassi del programma e quelle HTML, XHTML e PHP.
Lo pu usare facilmente chi mastica gi un poco di programmazione web, e studiandosi il tutorial del programma che  fornito solo in lingua inglese.
L'installazione non  complicata, ma bisogna farla con cura se si vuole avere la certezza che funzioni.
Ecco i software occorrenti che, al momento della stesura di questo articolo, sono quelli che sono elencati di seguito assieme agli indirizzi per il loro
prelievo, e li scarichiamo sul nostro computer, magari salvandoli in una stessa cartella che diventer il riferimento per l'installazione di questo programma.
Prelievi dei software:
scaricare i seguenti programmi:
1. Python: 
http://www.python.org/ftp/python/2.5/python-2.5.msi.
2. In alternativa, Plone: 
http://plone.org/products/plone.
3. Docutils: 
http://puzzle.dl.sourceforge.net/sourceforge/docutils/docutils-0.4.tar.gz
4. Rest2web: 
http://www.voidspace.org.uk/cgi-bin/voidspace/downman.py?file=rest2web-0.5.0.zip
Avendo prelevato i software come da indicazioni suddette, abbiamo tutto l'occorrente da installare per rendere operativo l'uso del programma Rest2web, quindi,
iniziamo le installazioni.
Installazione dei software:
Installare Python o Plone:
Per questi due software non ci sono problemi particolari e basta seguire le indicazioni che, volta per volta, fornisce il programma di installazione. Il
tutto si limita a dare invio su next o avanti, accettare la licenza e, se ritenuto opportuno, cambiare la cartella di installazione. Consiglio di lasciare
tutto come di default in modo che saranno valide tutte le indicazioni fornite di seguito.
Supponiamo di aver installato Plone, ma se avessimo deciso di installare Python da solo, avremmo come differenza solamente la variazione dei percorsi di
Python che bisognerebbe cambiare negli indirizzi indicati quando si danno i comandi da riga di comando o quando vengono usati nei file batch appositamente
creati.
Installando Plone, come indicato in un articolo di Uiciechi.it del mese di Settembre 2006, viene posta in programmi la cartella "Plone 2" che contiene tutto
il pacchetto del CMS, compreso Python. Ovviamente, ammesso che non abbiamo cambiato i percorsi di installazione di default.
Eseguire la verifica del software Plone, come indicato nell'articolo suddetto.
Installare la DLL di Python Docutils:
Portarsi sul file Docutils dove lo abbiamo salvato e lo copiamo negli appunti, con control pi C.
Il file lo dobbiamo scompattare in una cartella temporanea che dobbiamo creare, ad esempio C:\temporanea.
Per creare detta cartella, ci portiamo in C:\, menu file, nuovo, nuova cartella ed invio.
Scriviamo temporanea ed invio.
Apriamo con invio la cartella creata e copiamo il file docutils-0.4.tar.gz.
Scompattiamo questo file e dovrebbe essere generata la cartella "docutils" che contiene tutti i file che ci occorrono.
Se usassimo WinRar, la cartella verrebbe generata in automatico dal programma.
Eventualmente usassimo un programma diverso o, a causa di impostazioni diverse di Winrar, la scompattazione generasse file sciolti, avere cura di creare
la cartella "docutils" senza le virgolette e spostarvi i file al suo interno.
Diamo per scontato che abbiamo nella cartella C:\temporanea la cartella "docutils" come previsto, con i file al suo interno.
Chiudiamo o riduciamo ad icona e ed apriamo il prompt del Dos, da menu avvio, esegui, scriviamo cmd ed invio. In alternativa, menu avvio, programmi o tutti
i programmi, accessori, prompt dei comandi ed invio.
Dalla riga dei comandi che si apre, scrivere i comandi che seguono per installare la libreria Docutils:
cd C:\temporanea\docutils\ e premiamo invio.
Attenzione ai segni grafici.
Ci troviamo nella cartella che contiene tutto l'occorrente per installare la libreria, quindi sulla riga di comando avremo:
C:\temporanea\docutils\ con il prompt che aspetta un nuovo comando.
Scriviamo ancora "C:\Programmi\Plone 2\python\python.exe" setup.py install e premiamo invio. Fare sempre attenzione a digitare correttamente il comando
e in particolare ai segni grafici visto che non  possibile fare copia ed incolla.
Nota bene:
Se tutto  stato fatto come suddetto, questi due comandi si possono inserire in un file di testo creato con blocco note di Windows e salvandolo con estensione
bat.
Dando invio sul file bat, cos creato, si eseguono direttamente i due comandi.
Si evitano cos errori di digitazione, essendo possibile fare copia ed incolla.
Installazione di Rest2web:
Ridurre ad icona e portarsi dove abbiamo salvato il file "rest2web-0.5.0.zip" e copiarlo negli appunti con control pi C.
Portiamoci nella cartella C:\temporanea ed incolliamo con control pi V il file "rest2web-0.5.0.zip".
Scompattiamo "rest2web-0.5.0.zip" in questa cartella, avendo cura che nella scompattazione si generi la cartella:
"rest2web-0.5.0".
Rinominiamo la cartella "rest2web-0.5.0" in " rest2web".
Se dalla scompattazione risultassero file sciolti, avere cura di creare la cartella " rest2web" e copiare i file sciolti al suo interno.
Posizioniamoci sulla cartella" rest2web".
La tagliamo con control pi X.
Usciamo dalla cartella C:\temporanea con il tasto backspace.
Siamo in C:\ dove, con control pi V, spostiamo la nostra cartella precedentemente tagliata.
A questo punto la cartella C:\temporanea non ci occorre pi, ma provvederemo a cancellarla quando siamo sicuri che il programma funzioni correttamente.
Ricapitolando, se abbiamo fatto tutto correttamente, significa che abbiamo installato la libreria DocUtils in Python e abbiamo sul disco C il programma
rest2web, gi usabile, nella cartella" rest2web".
A questo punto, il programma e' gia' utilizzabile richiamando opportunamente l'interprete python, usando i comandi da prompt dei comandi, oppure, usando
un file batch appositamente preparato.
Preparazione cartelle per impostare la struttura del sito:
Ultimiamo la struttura delle nostre cartelle, in modo da dare al programma tutto quello che occorre per trasformare dei file sorgenti in file HTML o XHTML,
cio delle cartelle apposite che conterranno i file sorgenti del sito da creare e il sito creato.
Questa struttura serve per poter dare dei comandi precisi, sia se li volessimo dare da riga di comando, sia se li volessimo inserire in un file batch.
Portiamoci nella cartella C:\ rest2web e al suo interno dobbiamo creare la cartella "sito".
Creata la cartella Sito, ci portiamo al suo interno. Creare nella cartella Sito le cartelle Input ed Output.
Nota bene:
Questa struttura  stata creata per fornire dei comandi precisi, magari da inserire in un file batch, ma ognuno pu crearsi la struttura che vuole.
La cosa importante sono proprio i percorsi forniti nei comandi da impartire al programma e che sono i percorsi delle applicazioni Python e Rest2Web, quelli
che risultano al momento della loro installazione. Se si spostassero le cartelle di queste due applicazioni, occorre variare anche i percorsi nei comandi
forniti.
Se abbiamo rispettato tutte le indicazioni sin qui fornite, la struttura del sito ci risulter nella cartella "sito" che si trova all'interno della cartella
"C:\rest2web" e che contiene al suo interno le cartelle Input ed Output.
Quindi, se ho creato la cartella del sito in C:\rest2web\sito e dentro ho gia' creato le directory INPUT e OUTPUT, in questa stessa cartella devo crearmi
un file di configurazione del sito che chiamer sito.ini.
Dentro al tutorial ci sono tutte le spiegazioni per stabilire cosa inserire in questo file, nel quale si stabiliscono anche eventuali variabili occorrenti
per la creazione del sito.
Altro file da creare  il file template.txt che deve essere posizionato nella cartella Input.
In questa stessa cartella, dobbiamo creare un file index.txt che riporter tutte le specifiche del corpo della home page del sito che vogliamo creare.
Sempre all'interno di questa cartella, possiamo creare una cartella per ogni sezione del sito.
Allinterno di ogni cartella di ogni sezione dobbiamo creare il file index.txt che conterr il corpo della pagina che introduce alla sezione relativa del
sito.
Il template non  altro che le indicazioni che diamo al programma res2web per creare il layout, cio la struttura del sito, e, come gi detto in precedenza,
presume conoscenza di HTML, XHTML e PHP.
Nella cartella Output dobbiamo creare due cartelle che sono CSS e Immagini. Queste due cartelle conterranno rispettivamente i file CSs e le immagini del
sito. Essendo questa una struttura creata secondo le mie esigenze, chiunque ne potrebbe creare un'altra che soddisfi le sue esigenze, sempre rispettando
i percorsi che si devono inserire nei file di impostazioni e di comando, rispettivamente sito.ini e sito.bat.
Se tutto  stato predisposto secondo le indicazioni sin qui fornite, possiamo utilizzare rest2web richiamando, sempre da prompt dei comandi, il programma
rest2web che, sfruttando le potenzialit di Python, crea le pagine html del sito secondo la struttura che abbiamo impostato con le cartelle ed i file di
solo testo preparati ed inseriti nella cartella Input.
La struttura di questi file deve essere creata secondo le impostazioni descritte nel tutorial a corredo del programma Rest2Web che, come suddetto,  un
testo in inglese.
Spero di avere il tempo di studiarmi tali inpostazione e di acquisirne una padronanza tale da poter fornire in futuro delle informazioni semplici per poter
utilizzare al meglio questo programma.
Come avete potuto notare, siamo molto vicini a poter dare la possibilit anche a un disabile visivo di potersi costruire con semplicit un sito statico
e di pubblicarlo in piena autonomia usando uno dei programmi che consentono di poter trasferire i file creati dal proprio computer allo spazio Web che
si pu comprare dai tanti gestori di Hosting che ci sono in rete.
Alla prossima per proseguire questo discorso che chi ha voglia, pu continuare anche da solo.

Nunziante Esposito.

