Importare Documenti Describe

La conversione dei documenti describe prevede diversi passaggi:

1. Da describe a Describe tagged ascii (v. Markup Describe Tagged Ascii).
2. Da Describe tagged ascii ad html.
3. Da html a notes.

Il procedimento manuale prevede tre diversi momenti:

1. Preparazione
2. Esecuzione della conversione
3. Caricamento in Notes.

Preparazione

Si devono eseguire i seguenti passaggi:

1. Copiare il documento describe --- con suffisso dwp --- nella directory dardat/in/dwp -- Directory Input Describe. In questa sede bisogna assegnare un nome breve al documento (ad. es. icu).
2. Aprire in descrbe il documento:
1. Eliminare la prima pagina di intestazione.
2. Eliminare il contenuto dell'indice.
3. Eliminare i seguenti frame: titolo, logo ar, dati ar e header.
4. Il documento inizia dunque con un titolo di livello 1.
5. Salvare il documento in formato descrbe nativo.
6. Salvare il documento --- con suffisso dta --- in formato Describe Tagged Ascii.
7. Estrarre gli eventuali grafici dal documento in formato eps (vedi Importare Immagini da Describe). Salvare tali file nella directory dardat/in/dwp/gif -- Directory Grafici Describe.
3. Preparare il file bat di lancio della conversione.
4. Preparare il file degli argomenti --- con suffisso arg --- per la conversione.

BAT di lancio

Va creato nella directory dardat/in/dwp -- Directory Input Describe. Lo si esegue passandogli come parametro il nome breve del file dta (senza estensione). Ha questo contenuto: nella riga di esecuzione di dwp2sgml si deve indicare il nome del file arg che si è creato (ad. es. icu.arg)

set FILE=%1
rem Nella prossima riga, al posto di dwp.arg va messo il nome vero del file arg che si è creato
dwp2sgml @dwp.arg

File degli argomenti

Il file ha questo contenuto. I campi Title, Category, Author, DateComposed, DateChanged vanno posizionati con i valori relativi al documento che si sta caricando

Il campo Split contiene il livello di rottura che il programma deve effettuare, ossia a che livello viene spezzato il documento in tali file separati. Se Split=1 viene prodotto un file per capitolo. Se Split=2 viene prodotto un file per sezione, etc.

[Dwp2Sgml]
InFile=q:\svi\rs\dar\in\dwp\%FILE%.dta
OutDir=q:\svi\rs\dar\in\dwp\cnv
Dcl=MAN
Name=%FILE%
Title=Procedura Icu
Category=tax.icu
Author=Gabriella Bozzolo
DateComposed=1-1-1996
DateChanged=31-10-1999
SplitAt=2

Esecuzione

Si devono eseguire i seguenti passaggi:

1. Si esegue il bat. I file html vengono creati nella directory dardat/in/dwp/cnv -- Directory Input Convertiti Describe. Hanno il nome composto da man seguito dal nome del file dta, seguito da sequenze numeriche separate da punti che indicano il livello del frammento di documento all'interno del capitolo. Ad. es: man.icu.01.02.html è il file contenente la seconda sezione del primo capitolo del manuale icu.
2. Si aprono i file html con un browser e si scorrono per vedere se sono a posto. Se si trovano anomalie nel file, solitamente si tratta di anomalie di formattazione del documento describe. Si correggono le anomalie in describe, si ricrea il file dta e si ritorna al punto 1. Tutto questo finchè gli hmtl non sembrano a posto

Caricamento in Notes

Si devono eseguire i seguenti passaggi:

1. Si crea un documento notes di tipo man (Disegno Logico - MAN) avente nome uguale al nome del file dta. Si indica il titolo del manuale, la categoria, la lingua.
2. Caricare il contenuto del manuale: posizionandosi sul documento appena creato, utilizzare il bottone Dwp -- Importa Manuale Convertito. Questa fase cerca tutti i documenti html che contengono il nome del manuale, riempie il documento manuale con l'elenco degli elementi, crea un nuovo documento notes per ciascun file html. Questi documenti notes vengono creati nella zona Testi - Cat, pertanto hanno tutti dcl=man.
3. Per ciascuno dei documenti creati nella fase precedente, importare il file html ed eliminare il nome del file dal testo del documento.
4. L'importazione da describe crea un ultimo documento che contiene tutte le note a piè pagina. Devono essere riportate in calce al documento a cui si riferiscono. I numeri delle note aiutano a capire quali vanno messe in ciascun documento. Una volta spostate tutte le note, il documento di sole note può essere cancellato.
5. Se necessario si può raggruppare o spezzare ulteriormente i documenti. Se lo si fa, occorre correggere l'elenco dei documenti nel manuale.
6. I documenti devono essere spostati nel dcl corretto. Si selezionano i documenti che vanno nel medesimo dcl e si utilizza il bottone modDcl -- Modifica DCL per cambiarli tutti insieme.
7. Al termine nel gruppo dei Testi - Cat non dovrebbe restare più nulla, se non eventualmente qualche mini-documento di colla.
8. Tornare sul documento manuale ed eseguire lo scarico in sgml
9. Su tutti i nuovi documenti si effettua lo scarico in sgml.

Caricamento in più passate

Qualora il documento non possa essere spezzato tutto allo stesso livello ma a livelli differenti a seconda dei capitoli (le leggi vengono solitamente spezzate a livello 3, articolo, mentre le parti di disegno logico spesso vanno bene spezzate a livello 2), occorre procedere in più passate.

Si devono preventivamente individuare i livelli di rottura per ciascun capitolo. I capitoli di pari livello verranno trattati insieme. Per ogni blocco di capitoli di pari livello si procede con quanto spiegato qui di seguito:

1. Si esegue la produzione dell' html con l'indicazione nel file dei parametri del livello desiderato.
2. Nella dardat/in/dwp/cnv -- Directory Input Convertiti Describe insieme ai file html è stato generato un file con estensione man. Questo una testata con le caratteristiche del manuale e la lista dei documenti da importare. Da questa lista devono essere rimossi i documenti che sono spezzati al livello sbagliato.
3. Si carica il manuale parziale in notes usando il comando Dwp -- Importa Manuale Convertito. Si importano tutti i documenti previsti. Si rinomina il documento notes.
4. Si cambia il livello e si torna al punto 1.
5. Tramite cut & paste si fondono insieme i documenti man eliminando quelli intermedi.

Produzione del manuale

La produzione del manuale si effettua con il bottone Print -- Stampa Documento. Viene prodotto un file pdf che deve essere verificato e confrontato con il documento originale describe. In particolare vanno verificate le figure e le tabelle.

Termine delle Operazioni

Al termine delle operazioni, i file html devono essere rimossi dalla directory dar\in\dwp\cnv.

Il file dwp originario deve essere spostato dalla directory in cui si trovava (tipicamente N:\ nd \ fase03) nella directory n:\ nd \ fase04_Trasferiti_in_Notes \ completi). Da questa periodicamente viene fatto un cd di salvataggio e i file vengono cancellati. Il pdf viene cancellato dalla directory n:\ nd \ fase03 \ pdf.