Stampa della documentazione

Il Generatore di documentazione ISaGRAF consente di stilare e stampare la documentazione completa del progetto evidenziato. La finestra Generatore documentazione viene visualizzata con il comando "Stampa" del menù "Progetto" dalla finestra Gestione progetti. Diversamente dai comandi "Stampa" delle altre finestre ISaGRAF, il generatore di documentazione può essere usato per stampare più di un componente del progetto nello stesso documento, con impaginazione e numerazione di pagina.

Personalizzazione delle tavole dei contenuti

Opzioni

Con i comandi del menù "Modifica" della finestra Generatore documentazione si determinano i componenti del progetto da inserire nella documentazione. In questo modo si costruisce una lista che elenca gli elementi che si desidera includere nel documento. Nella documentazione del progetto possono essere inserite tutte le informazioni riguardanti il progetto (programmi, variabili, opzioni, connessioni I/O…). In questo documento non possono apparire informazioni riguardanti altri progetti di librerie ISaGRAF.

 Il comando "File / Stampa" genera il documento e lo invia alla stampante, secondo la lista che è stata costruita. L'operazione richiede pochi minuti per generare e stampare il documento. Si raccomanda vivamente di attendere la conclusione dell'operazione di stampa. La generazione del documento può richiedere molto spazio sull'hard disk. Qualora lo spazio non sia sufficiente, appare un messaggio di errore. In questo caso è necessario o liberare spazio su disco eliminando file o riducendo la dimensione della stampa. Una volta dato il comando "Stampa" appare una finestra di dialogo che permette di inserire una descrizione dell'attuale stampa. Queste note vengono archiviate in un file cronologico e vengono stampate sulla prima pagina di ogni documento futuro (compreso l'attuale).


Personalizzazione delle tavole dei contenuti

l menù "Modifica" contiene i comandi necessari a definire la lista di contenuti del documento. Una serie di comandi consente di usare una lista predefinita (con tutti i componenti del progetto), di costruire una lista particolare (solo con alcuni componenti) o di spostare i componenti e modificare il contenuto della lista.

Lista predefinita

 	Taglia e incolla

Svuotare la lista

Inserimento delle voci nella lista


Lista predefinita

Il comando "Lista predefinita" del menu "Modifica" definisce una lista standard per il documento comprendente tutti i componenti del progetto. La lista standard consiste in:

-	Descrizione del progetto

-	Albero gerarchico (collegamenti tra programmi)

-	Codice sorgente per ogni programma

-	File Diario per ogni programma

-	Definizioni comuni

-	Definizioni globali

-	Definizioni locali per ogni programma

-	Variabili globali

-	Variabili locali per ogni programma

-	Opzioni dell'applicazione

-	Connessioni di I/O

-	Elenco delle variabili

-	Tavole di conversione

-	Riassunto dei riferimenti incrociati

-	Dettaglio dei riferimenti incrociati

-	Sommario delle dichiarazioni

-	Mappa degli indirizzi di rete

-	Elenco cronologico delle modifiche.

La tavola dei contenuti può essere salvata su disco usando il comando "File / Salva". Questo comando viene disabilitato quando il generatore di documentazione è chiamato da un editor ISaGRAF (Programma, Dizionario, File, Stampa) per stampare un singolo documento.


 	Taglia e incolla

Per spostare il contenuto degli elenchi o per personalizzare l'ordine della lista si usano i comandi "Modifica / Taglia" e "Modifica / Incolla". E' possibile selezionare, tagliare ed incollare gruppi di più voci.


Svuotare la lista

Il comando "Modifica / Cancella tutto". permette di svuotare la lista, in questo modo è possibile ricostruirla completamente inserendo le singole voci.


Inserimento delle voci nella lista

Il comando "Modifica / Inserisci" apre una finestra di dialogo. Servirà ad inserire le voci (componenti del progetto) nella lista.

Per inserire una voce relativa ad un programma si seleziona il nome del programma nella casella elenco "Programma" e si seleziona la voce desiderata nella lista sottostante. Per inserire la voce selezionata nella lista premere il pulsante "Aggiungi". La stessa voce relativa ad un programma può comparire una sola volta nella lista.


Opzioni

Per definire e personalizzare il formato del documento generato si usano i comandi del menu "Opzioni".

Diagrammi SFC

Formato pagina

Schema del titolo della pagina

 	Scelta del front di caratteri

Altre opzioni sono disponibili direttamente dalla finestra del Generatore di documentazione:

Quando si seleziona l'opzione "Copertina", viene stampata una pagina di intestazione all'inizio del documento, contenente il titolo del progetto e le stampe eseguite. Quando tale opzione non è selezionata, la prima pagina inizia con il primo elemento da stampare.

Quando si seleziona l'opzione "Sommario " viene stampato, un sommario alla fine del documento generato.

Quando il Generatore di documentazione viene lanciato con un comando Stampa da uno degli editor ISaGRAF (es: nell'editor del Dizionario con il comando File/Stampa), entrambe le opzioni sono inizialmente non selezionate.


Diagrammi SFC

L'opzione "Separa livelli SFC" fa si che il sistema stampi, per ogni programma, prima il livello 1 di SFC (diagrammi e commenti) e poi il livello 2 di programmazione. Quando non è selezionata questa opzione i livelli 1 e 2 appaiono assieme nella stessa stampa.


Formato pagina

Il comando "Formato pagina" del menu "Opzioni" permette di definire i principali parametri che utilizza il Generatore di documentazione per l'impostazione della pagina. Possono essere specificati i seguenti parametri:

-	Margine sinistro: (1 o 2 centimetri, oppure margine assente)

-	Bordo pagina: Quando è selezionata questa opzione, attorno ad ogni pagina stampata viene tracciato un bordo.


Schema del titolo della pagina

Il comando "Titolo pagina" del menu "Opzioni" viene utilizzato per definire il contenuto della casella di titolo stampata nella parte inferiore di ogni pagina. L'impostazione standard di questa casella è la seguente:

La prima riga del titolo principale (col nome del progetto ISaGRAF), la data corrente ed il numero di pagina vengono generati automaticamente non possono essere modificati.

Le tre righe di testo sulla parte sinistra della casella (text1, text2, text3) e la seconda riga del titolo principale vengono definite dall'utente. L'utente può modificare anche il logo stampato nella casella di sinistra. Per usare un logo diverso è necessario specificare il percorso del file immagine tipo bitmap (.BMP). L'immagine scelta potrà avere qualsiasi dimensione e verrà adattata all'esatta dimensione della pagina di stampa. Facendo click nella casella del logo della finestra di dialogo verrà visualizzata la nuova immagine specificata. Il file immagine deve trovarsi sul disco (nella cartella e con il nome specificati) quando viene dato il comando di stampa "Stampa".


 	Scelta dei font di caratteri

I comandi "Carattere testo" e "Carattere titolo" del menu "Opzioni" permettono di definire i font di caratteri utilizzati per la stampa del testo e dei titoli di ogni parte del documento. Per i testi ed i titoli è possibile scegliere la dimensione ed il tipo di carattere. La selezione di un font è fatta con la finestra di dialogo standard di Windows. Ogni testo (programmi testuali, nomi all'interno dei diagrammi,..) viene stampata con la dimensione, lo stile ed il font di carattere selezionato. I titoli vengono stampati con il font scelto per i titoli.

Se non vengono definiti i font di caratteri, per ogni testo verrà usato il font standard della stampante con i seguenti stili:

-	Stile "Normale" per i testi ed i nomi all'interno dei diagrammi

-	Stile "Grassetto" per i titoli