UICIECHI.IT: MARZO 2007 - Numero 3.
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:
2. In alternativa, Plone: http://plone.org/products/plone.
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.