Installazione di rest2web.

Di Nunziante Esposito.

Seconda parte.

Come riferito nella prima parte, 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 e XHTML.
Lo pu usare facilmente chi mastica gi un poco di programmazione web, e studiandosi il tutorial del programma che  fornito solo in lingua inglese.
Come abbiamo visto nella prima parte, la struttura da me prevista era quella di avere la cartella rest2web in C e il programma CMS Plone normalmente installato
nella cartella "Plone 2" posta nella cartella programmi del disco C, ammesso che il sistema operativo sia installato in questo disco.
Vediamo ora come preparare i file che, come gi spiegato nella prima parte, occorrono al programma per funzionare, e generare le pagine HTML o XHTML per
una struttura di un sito, usando il linguaggio Python, software che viene installato assieme a Plone.
La struttura base da me prevista, qualora si acquisisca padronanza per la costruzione di un sito, pu essere ampliata a piacere e, anche se  possibile
creare una struttura solo statica, penso che sia una cosa che possiamo fare senza problemi trattandosi di preparare dei file di testo codificato e formattato
in un certo modo.
Avevamo detto che dentro alla cartella Rest2web posta in C, avevamo previsto una cartella sito al cui interno c'erano le cartelle Input e Output.
Sempre nella cartella Sito dobbiamo creare due file che sono precisamente: "sito.bat" e "sito.ini". Questi due file conterranno rispettivamente i comandi
da dare al programma restr2web per avviare la compilazione e le indicazioni che daremo al programma per dirgli da dove deve prendere i file sorgenti e
dove deve salvare i file html, generati secondo le nostre indicazioni che gli diamo nei file sorgenti. In questo secondo file ci sono anche le indicazioni
sul percorso del file di log, qs_log.txt, nel quale il programma rest2web potr memorizzare eventuali errori di compilazione.
Niente di trascendentale, si tratta di file txt e useremo il solo blocco note, quindi tutto a portata di mano con la consapevolezza di sempre.
Altri due file che dobbiamo creare, sempre nella cartella "Sito", sono i file di log che usa il programma per restituirci eventuali errori di compilazione
del codice HTML O XHTML. Questi due file sono rispettivamente log.txt e qs_log.txt. Sono file da creare vuoti, quindi creamoli subito.
Per farlo, faremo come segue:
1. Posizioniamoci nella cartella C:\rest2web\sito\.
2. Premiamo alt pi F, per aprire il menu file. Dal sottomenu nuovo, cerchiamo documento di testo e premiamo invio.
3. Scriviamo il nome del file, log.txt e premiamo invio.
4. Ci ritroveremo sul file log.txt e premiamo invio.
5. Si apre il file appena creato. Dal menu file scegliamo nuovo e premiamo invio.
6. Si apre il nuovo file senza nome.
7. Dal menu file, scegliamo salva con nome e premiamo invio.
8. Si apre la procedura per salvare il file sul disco. Ci troviamo sul nome del file e come nome metteremo qs_log.txt.
Nota bene:
attenzione al sottolineato tra qs e log.
9. Non ci resta che scegliere, dal campo salva in ...., la cartella dove salvare. Dovrebbe essere gi quella dove ci troviamo, cio C:\rest2web\sito\, ma
se non fosse quella, la sceglieremo.
10. Premiamo tab fino a salva e premendo invio salviamo anche questo file.
11. premendo alt pi F4, ritorneremo nella cartella e precisamente sul file log.txt.
Ritrovandoci sul file log, la cosa pi semplice da fare per creare gli altri due file,  quella di aprire di nuovo il file log.txt e, dal menu file, scegliere
il comando nuovo per aprire un nuovo file.
Il nuovo file sar un file vuoto nel quale cominceremo a scrivere i comandi per avviare l'applicazione rest2web, quindi, avrete capito che questo nuovo
file lo salveremo con il nome di sito.bat.
La prima riga, come certamente ricorderanno tutti coloro che hanno usato il sistema operativo Ms-Dos, sar: @echo off.
la seconda ed ultima riga del file sar quella che contiene i comandi di partenza del software di compilazione rest2web, con il richiamo al programma Python.
Il comando, comprensivo di virgolette,  il seguente:
"C:\programmi\plone 2\python\python.exe" "C:\rest2web\r2w.py" C:\rest2web\sito.ini
Nota bene:
Con questo comando non abbiamo fatto altro che dire a Python di usare il programma Rest2web e prendere tutti i dati per eseguire il lavoro di compilazione
dal file "sito.ini", posto nella cartella C:\rest2web\sito\.
Una volta scritte le due righe come suddette, si pu fare anche copia ed incolla, salviamo il file come segue:
1. Dal menu file scegliamo il comando salva con nome e premiamo invio.
2. Scriviamo il nome "sito.bat" senza le virgolette.
3. Premiamo tab e come tipo di file scegliamo tutti i file.
4. Ci portiamo con tab su salva in ..., ci assicuriamo di salvare nella cartella C:\rest2web\sito\.
5. Con il comando salva che raggiungiamo con tab, salveremo il file che sar il comando per la partenza del programma Rest2web.
6. Chiudiamo il file con il comando alt pi F4 e ci ritroveremo di nuovo sul file log.txt.
Per ricapitolare, abbiamo da creare solo il file sito.ini, che, se qualcuno non ci avesse riflettuto,  proprio il file che viene richiamato dal comando
scritto nel file "sito.bat" appena creato.
Ritrovandoci sul file log, per creare l'ultimo file di questa cartella, apriamo di nuovo il file log.txt e, dal menu file, scegliamo il comando nuovo per
aprire un nuovo file.
Questo file  da creare con cura perch ha i comandi di indirizzo di tutti i file e quindi un errore pregiudica il funzionamento del programma Rest2web.
Aperto il nuovo file txt, vediamo cosa scrivere al suo interno, contenuto che scriveremo riga per riga.
Davanti ad ogni riga avremo cura di assicurarci che ci siano due spazi, tranne che per la prima riga, e a fine riga non devono esserci spazi.
Ecco il testo da scrivere, lo racchiudo tra asterischi che non bisogna inserire nel file, e possiamo fare anche copia ed incolla:
***************
psyco = False
pause = False
log_file = 'C:\rest2web\sito\qs_log.txt'
DEBUG = False
compare_directory = ''
# these values we have edited for our site start_directory = 'C:\rest2web\sito\input'
target_directory = 'C:\rest2web\sito\output'
macros = ''
[uservalues]
site_title = 'Sito personale di Nunziante Esposito'
site_version = '1.0.0'
***************
Ora dobbiamo salvare il file con il nome sito.ini, quindi, facciamo come segue:
1. Dal menu file scegliamo il comando salva con nome e premiamo invio.
2. Scriviamo il nome "sito.ini" senza le virgolette.
3. Premiamo tab e come tipo di file scegliamo tutti i file.
4. Ci portiamo con tab su salva in ..., ci assicuriamo di salvare nella cartella C:\rest2web\sito\.
5. Con il comando salva che raggiungiamo con tab, salveremo il file che sar il file di riferimento per tutti gli indirizzi che user il programma Rest2web
per generare le pagine html che rappresenteranno il nostro sito e che le ricaver dai file txt sorgenti, preparati nelle modalit che vedremo in seguito.
6. Chiudiamo il file con il comando alt pi F4 e ci ritroveremo di nuovo sul file log.txt.
Questo file che abbiamo appena creato, "sito.ini", ha la sezione che precede la riga [uservalues] che divide il file in due parti:
- Quella superiore che ha tutti i perrcorsi di file e cartelle che il programma deve rispettare.
- quella inferiore che contiene tutte le variabili che possiamo dichiarare e che possiamo inserire nel file template per farle inserire nelle pagine create
in automatico.
queste cose sono tutte scritte nella documentazione a corredo dei programmi Python e Rest2web.
Vi rimando alla prossima volta per continuare il discorso.
per ulteriori chiarimenti, scrivere a:

Nunziante Esposito.

