Documentation/Screenshots/it

Schermate da inserire nella documentazione
Questa pagina descrive come creare delle schermate delle finestre di LibreOffice per inserirle nella documentazione o nell'aiuto di LibreOffice. Come prerequisito è necessario avere una copia da git del repository dell'aiuto di LibreOffice e/o compilare il codice di LibreOffice compreso l'aiuto (  switch). Per le schermate in più lingue, dovete compilarlo con l'opzione, dove $language list è una lista dei codici delle lingue formati da due o tre lettere separati da un spazio, per esempio

Concetti basilari
Ogni finestra di LibreOffice ha un suo ID per l'Aiuto che la identifica in modo univoco (in modo che il browser dell'aiuto sappia quale pagina visualizzare quando un utente richiama l'aiuto per una determinata finestra). L'ID per l'Aiuto di solito si presenta come segue:

in pratica rappresenta il percorso nel quale è memorizzato il file .ui di quella finestra. È stato deciso che gli ID delle schermate relative alle finestre (e quindi i percorsi dei file nei quali sono memorizzate) sia la copia degli ID dei loro aiuti in modo da evitare di dover mantenere mappature differenti. Ciò considerato, la schermata della finestra di cui sopra si troverà nel seguente percorso:

e la sua versione tradotta (dove $language_code è il codice di due o tre lettere della lingua) si troverà in:

All'interno della struttura ad albero dei sorgenti di LibreOffice (aiuto), i file contenenti le immagini con le schermate inserite nelle pagine di aiuto (file .xhp) sono memorizzati nella seguente cartella:

nei percorsi corrispondenti ai loro ID, come sopra evidenziato.

Creare automaticamente delle schermate in serie
Per creare in un unico passaggio una schermata di ciascuna finestra di LibreOffice, eseguite:

all'interno della cartella radice del vostro albero dei sorgenti di LibreOffice. Potete anche creare delle schermate per i singoli moduli. Ad esempio, il seguente comando crea le schermate di tutte le finestre di LibreOffice Calc (sc):

Al termine dell'esecuzione di questo comando, le schermate saranno memorizzate nel seguente percorso all'interno dell'albero dei sorgenti di LibreOffice:

nel percorso corrispondente al loro ID, come sopra esposto. Se avete compilato LibreOffice con il supporto per più lingue/impostazioni locali (, vedete sopra), questo comando creerà automaticamente le schermate in tutte le lingue che avete compilato.

Creare manualmente le schermate
Per creare le schermate delle finestre dalla versione di LibreOffice in esecuzione, dovete attivare la modalità screenshot (tra le funzionalità sperimentali) dal menu. La chiave di configurazione in questione è. Una volta che la modalità screenshot è attiva, fate un clic con il tasto destro del mouse nell'area di azione di qualsiasi finestra (dove si trovano i pulsanti "'", "'", ecc.), apparirà un menu contestuale:



Per creare la schermata della finestra attiva, fate clic sulla voce Schermata del menu contestuale. Nella finestra di dialogo che compare, vedrete un anteprima della schermata ed un area di testo. Se siete soddisfatti del risultato, fate clic sul pulsante  per poterla memorizzare in una cartella di vostra scelta, preferibilmente direttamente nella cartella  e nel percorso corrispondente al relativo ID.

Spiegazioni in video
(il video è in francese - n.d.t) Attivate i sottotitoli in Inglese:

Inserire le schermate nelle pagine di aiuto

 * 1) se avete creato le schermate con il comando , copiate le schermate dalla cartella   nella cartella
 * 2) se avete creato le schermate manualmente, l'approccio migliore è quello di salvarle direttamente in , rispettando il percorso del loro ID.

Ora potete usare il vostro metodo preferito per modificare i file di aiuto (sia manualmente, sia usando l'estensione HelpAuthoring). Un frammento di .xhp da inserire nel file di aiuto può apparire ad esempio come segue (per la scheda della finestra di dialogo di cui sopra, con evidenziato il percorso della schermata):

Area dialog

In alternativa, quanto create manualmente una schermata, potete copiare e incollare il frammento di markup generato nell'annotazione presente nella finestra:



Inviare le vostre modifiche
Il modo per inviare le vostre modifiche non è differente da quello usato per le altre modifiche al contenuto dell'aiuto, l'unica cosa che dovete fare è aggiungere i nuovi file contenti le schermate al controllo di versione di git: