I documenti DeScribe™ storicamente comprendono la gran parte della documentazione prodotta. Possono essere convertiti al sistema di documentazione. La metodologia di conversione prevede diversi passaggi, molti dei quali manuali. I passaggi sono:
- Estrarre le immagini dal documento DeScribe™. Importarle nel sistema di documentazione, creando gli appositi documenti Notes.
- Salvataggio del file DeStribe™ nel formato tagged-ascii.
- Predisporre i parametri del programma di traduzione. Questi parametri stabiliscono come va spezzato il manuale per produrre i singoli documenti. E' possibile creare:
- Un'unico documentodo.
- Un documento per capitolo. Questa è la spezzatura più facile da gestire.
- Un documento per sezione.
- Eseguire il programma di traduzione. Questo produce:
- Un file di riepilogo. Questo file può essere caricato direttamente in Notes e da origine ad un documento con dtd=man.
- Un file html per ogni documento generato --- in base ai parametri. Ad esempio un file per ogni capitolo.
- Caricare i documenti convertiti in notes. Si otterrà un singolo documento man di riepilogo ed un documento dcv per ciascun capitolo.
- L'ultimo documento contiene le note a piè pagina dell'intero manuale. Vanno collocate manualmente --- in notes --- nel capitolo di pertinenza.
- I documenti che contengono immagini vanno aggiornati inserendo il link al documento di immagine.
e-mail