Realizzazione di un sito web utilizzando reST e Sphinx
Clicca qui per visitare il sito-in-costruzione.
PRIMO step: conversione da docx a txt
Utilizzare lo script bash per la conversione massive dei file. E' necessario aver installato pandoc.
SECONDO step: inserimento markup reStructuredText
Per convertire un documento ci si può aiutare usando il semplice editor online: RestructuredText-on-line
o, in alternativa, si può utilizzare un qualunque editor di testo aggiungendo i simboli grafici necessari ad individuare i titoli e i paragrafi.
Al termine delle modifiche, rinominare l'estensione del file da .txt a .rst, aiuterà a capire quali file sono stati modificati.
TERZO step: creazione indici
Ordinare i documenti in sottocartelle in base ai temi delle schede e creare una pagina di indice.
Le sottocartelle conterranno i file ed eventuali immagini. Queste verranno salvate nella stessa cartella del file ed avranno lo stesso nome file del file .rst a cui si riferiscono ed eventualmente, se sono presenti più di una immagine, un numero progressivo, per esempio: nomefile01.jpg.
Note
Guarda la prima scheda 01_volgoccia.rst per il formato della scheda standard. Edita cliccando la matita per guardare i marcatori utilizzati.