Bookmark
I bookmark (o segnalibri) PDF funzionano in modo simile ai sommari. Offrono un modo semplice e conveniente per sfogliare un documento PDF. I bookmark degli script di disegno consentono di accedere a sezioni, viste, fogli di documenti PDF, visualizzare collegamenti Web, riprodurre clip audio, estrarre informazioni dai file di disegno e visualizzarle con un segnalibro.
È possibile creare i seguenti tipi di segnalibri:
| Tipo di segnalibro |
|---|
| Area di interesse |
| Documento |
| Collegamento Web |
| Clip audio |
| Descrizione testo |
I segnalibri sono visualizzati nel riquadro di navigazione Adobe Reader/Acrobat e sono generalmente organizzati in una struttura gerarchica ad albero. Alcune voci dei segnalibri potrebbero non avere azioni associate, come quelli di descrizione testo. Sono invece impiegati come segnaposto per strutturare la gerarchia bookmark.
Il software crea sempre un segnalibro principale per ogni foglio presente nel documento. Questa voce è configurata in base al valore della parola chiave sheet_name. Facendo clic sulla voce del segnalibro principale, il visualizzatore mostra l'intero foglio adattato alle dimensioni dello schermo. Tutti gli altri segnalibri di tale foglio sono creati come secondari in relazione al principale.
Grazie alle parole chiave dello script di disegno, è possibile creare segnalibri che consentono al lettore/visualizzatore Acrobat di ingrandire una determinata sezione o vista di un documento. La sezione o vista è definita dalla casella rettangolare di intervallo di accumulo degli elementi che corrispondono ai criteri dello script di disegno. Lo zoom o fattore di scala è definito dalla casella di intervallo di accumulo degli elementi e può essere regolato mediante la parola chiave zoom_percentage.
La parola chiave action_spec consente di specificare la posizione del segnalibro all'interno della gerarchia bookmark. Per ulteriori informazioni, consultare Template di bookmark.
Bookmark dell'area di interesse
È possibile creare un segnalibro per una determinata sezione o vista del documento. Questa sezione o vista è definita dalla casella rettangolare di intervallo di accumulo degli elementi che corrispondono ai criteri dello script di disegno.
La tabella seguente mostra i valori necessari/predefiniti per le parole chiave di azione, quando si crea un bookmark dell'area di interesse.
| Parola chiave | Valore | Valore predefinito |
|---|---|---|
| action_item | BOOKMARK | Necessari |
| action_name | Una stringa univoca impiegata per identificare la voce del segnalibro nella scheda Bookmark. | Necessari |
| action_type | AREA_OF_INTEREST | Valore predefinito - facoltativo |
| action_spec | Specifica la posizione del segnalibro nella gerarchia dei segnalibri. Se il valore non viene specificato, il segnalibro sarà posizionato in fondo alla gerarchia corrente. | facoltativi |
| action_range | Element_range | cell_range | Element_range |
| action_instance | Single_instance | Multiple_instance | Single_instance |
Il seguente script di disegno crea un segnalibro per un campo di firma digitale.
Esempio:
! Create a area of interest Digital Signature Field ! The accumulated range box of the elements below ! defines the Digital Signature field in the PDF document. if ((level eq 1) and (color eq 9) and (type eq 3)) then action_item = field action_name = "Chief Engineer" action_type = digsig_field action_spec = "John Doe, P.E." ! Create a bookmark to the Digital Signature Field action_item = bookmark action_name = "Signature Field" !Bookmark name (unique) action_type = AREA_OF_INTEREST action_spec = "./digsig/engineer" endif
L'esempio di script di disegno precedente crea il seguente segnalibro.
Bookmark dei documenti
I segnalibri dei documenti consentono di accedere a un determinato foglio di un documento PDF. Il software crea sempre un segnalibro principale per ogni foglio presente nel documento, tuttavia è possibile creare segnalibri aggiuntivi per passare ad altri fogli del documento.
Durante la creazione di un segnalibro dei documenti, la parola chiave action_name specifica il nome del foglio richiamato dal segnalibro quando viene cliccato. Ogni foglio può essere definito con un nome mediante la parola chiave sheet_name.
La tabella seguente mostra i valori necessari/predefiniti per le parole chiave di azione, quando si crea un bookmark dei documenti.
| Parola chiave | Valore | Valore predefinito |
|---|---|---|
| action_item | BOOKMARK | Necessari |
| action_name | sheet_name (definisce il nome del foglio di destinazione) | Necessari |
| action_type | DOCUMENTO | Necessari |
| action_spec | Specifica la posizione del segnalibro nella gerarchia dei segnalibri. | Necessari |
| action_range | Non disponibile | Non disponibile |
| action_instance | Non disponibile | Non disponibile |
Esempio:
! Create a bookmark that jumps to a particular ! sheet in a document for all sheet names beginning with plan*. if (sheet_name eq "plan*") then action_item = BOOKMARK action_name = "details" ! Sheet to jump to action_type = DOCUMENT action_spec = "./Related pages/Details drawing" endif
L'esempio di script di disegno precedente crea il seguente segnalibro.
Bookmark dei collegamenti Web
I segnalibri dei collegamenti Web consentono di accedere a una pagina Web. Per tutti i tipi di bookmark è necessario impostare la parola chiave action_item su bookmark. La parola chiave action_name specifica l'indirizzo URL e non il nome della voce del segnalibro. Il nome della voce di segnalibro è derivato dall'ultima voce nella parola chiave action_spec. Per esempio, se si specifica action_spec="/Related Web Links/TDOT Standards Specifications" per la parola chiave action_spec, "TDOT Standards Specifications" è il nome della voce di segnalibro.
La parola chiave action_spec specifica inoltre la posizione del segnalibro all'interno della gerarchia bookmark. La parola chiave action_type deve essere impostata su web_url.
La tabella seguente mostra i valori necessari/predefiniti per le parole chiave di azione, quando si crea un bookmark dei collegamenti Web.
| Parola chiave | Valore | Valore predefinito |
|---|---|---|
| action_item | BOOKMARK | Necessari |
| action_name | Specifica URL HTTP (il valore definisce l'URL del collegamento Web) ) | Necessari |
| action_type | WEB_URL | Necessari |
| action_spec | Specifica la posizione del segnalibro nella gerarchia dei segnalibri e definisce il nome di voce del segnalibro. | Necessari |
| action_range | Non disponibile | Non disponibile |
| action_instance | Non disponibile | Non disponibile |
Esempio:
! Create a bookmark that jumps to a Web page. ! action_item = BOOKMARK action_name = "http://www.dot.state.tx.us/cst/2003SpecProj/index.htm" action_type = WEB_URL action_spec = "./Related Web Links/TDOT Standards Specifications"
L'esempio di script di disegno precedente crea il seguente bookmark dei collegamenti Web.
Bookmark delle clip audio
I bookmark delle clip audio consentono di riprodurre clip audio all'interno di un documento PDF. Per tutti i tipi di bookmark è necessario impostare la parola chiave action_item su bookmark.
La parola chiave action_name identifica la specifica del file audio e non il nome della voce del segnalibro. Il nome della voce di segnalibro è derivato dall'ultima voce nella parola chiave action_spec.
Quando si crea un bookmark delle clip audio, è necessario impostare la parola chiave action_type su play_sound. La parola chiave action_spec specifica la posizione del segnalibro all'interno della gerarchia bookmark.
La tabella seguente mostra i valori necessari/predefiniti per le parole chiave di azione, quando si crea un bookmark delle clip audio.
| Parola chiave | Valore | Valore predefinito |
|---|---|---|
| action_item | BOOKMARK | Necessari |
| action_name | Determina la specifica del file audio. | Necessari |
| action_type | PLAY_SOUND | Necessari |
| action_spec | Specifica la posizione del segnalibro nella gerarchia dei segnalibri e definisce il nome di voce del segnalibro. | Necessari |
| action_range | Non disponibile | Non disponibile |
| action_instance | Non disponibile | Non disponibile |
Esempio:
! Create a bookmark that plays a sound clip. ! action_item = BOOKMARK action_name = "c:\my audio files\instructions.wav" action_type = PLAY_SOUND action_spec = "./Audio Instructions/Listen Before Installing!"
Bookmark di descrizione testo
I bookmark di descrizione testo consentono di visualizzare informazioni sul testo. Grazie a questi segnalibro è possibile estrarre informazioni testuali a partire da un file DGN e visualizzarle. È possibile impostare una stringa di testo all'interno del segnalibro oppure visualizzare le parole chiave Caratteri al suo interno.
Per tutti i tipi di bookmark è necessario impostare la parola chiave action_item su bookmark. Per i bookmark di descrizione testo, la parola chiave action_name specifica sia la stringa che identifica il segnalibro che il valore della sua voce. La parola chiave action_type deve essere impostata su text_description.
La parola chiave action_spec specifica la posizione del segnalibro all'interno della gerarchia bookmark.
La tabella seguente mostra i valori necessari/predefiniti per le parole chiave di azione, quando si crea un bookmark di descrizione testo.
| Parola chiave | Valore | Valore predefinito |
|---|---|---|
| action_item | BOOKMARK | Necessari |
| action_name | Stringa univoca per identificare questa particolare voce di segnalibro. Questo valore funge da nuova voce per il segnalibro. | Necessari |
| action_type | TEXT_DESCRIPTION | Valore predefinito — facoltativo |
| action_spec | Specifica la posizione del segnalibro nella gerarchia dei segnalibri. Se il valore non viene specificato, il segnalibro sarà posizionato in fondo alla gerarchia corrente. | facoltativi |
| action_range | Non disponibile | Non disponibile |
| action_instance | Non disponibile | Non disponibile |
Il seguente script di disegno crea un segnalibro che visualizza la descrizione del foglio a partire dal blocco titolo del disegno.
Esempio 1:
! Display the sheet description from the title block.
!
if (type .eq. text) then
if ((level_name .eq. "titleblock") and (weight .eq. 1)) then
! Create a text description bookmark
action_item = BOOKMARK
action_name = characters !Text string from the drawing.
action_type = text_description
action_spec = "./Description"
endif
endif
L'esempio di script di disegno precedente crea il seguente segnalibro di descrizione testo.
Il seguente script di disegno crea un segnalibro che visualizza il numero di fogli presenti in un documento.
Esempio 2:
! Use a bookmark to display the number of sheets ! in the document. if (sheet_name eq "index of sheets") then ! Create a text description bookmark action_item = BOOKMARK action_name = total_pages action_type = TEXT_DESCRIPTION action_spec = "./Number of pages in document" endif
Template di bookmark
È possibile creare un file XML che definisce il layout della gerarchia bookmark. La parola chiave bookmark_template determina la specifica del file XML. Ad esempio, bookmark_template = "d:\anystreet\book.xml".
La parola chiave action_spec consente di specificare la posizione del segnalibro all'interno della gerarchia bookmark. Il valore di action_spec è composto dai nomi delle diramazioni gerarchiche della struttura bookmark, in cui ogni nome è separato da una barra (/). Il carattere punto (.) denota la radice o parte superiore della gerarchia bookmark ("./branch name 1/branch name 2/branch name 3").
Se viene impiegato un bookmark template, ogni nome di diramazione presente nel valore action_spec (a partire da sinistra) è confrontato a ogni titolo di segnalibro template, finché non viene trovato un nome di diramazione non definito nel template. In questo caso, verrà creata una nuova diramazione utilizzando il nome di diramazione specificato. Nel seguente esempio di bookmark template (qui di seguito), vengono creati i seguenti bookmark quando action_spec è impostato su ./StormWater/Pit15/MyBookmark.
Storm Water System
1.2 Kerb Opening (PIT15)
MyBookmark
Le diramazioni gerarchiche vuote sono rimosse dalla struttura ad albero dei bookmark. Tuttavia, è possibile conservare queste diramazioni vuote impostando il valore dell'attributo XML KeepAlways su 1 nell’elemento XML. Questa funzionalità consente di definire le strutture dei bookmark, che possono essere compilate o modificate successivamente mediante Acrobat Professional.
Esempio di file template di un segnalibro:
<?xml version="1.0" encoding="UTF-8" ?> <bookmark-tree> <bookmark title="WasteWater">Waste Water Supply</bookmark> <bookmark title="WaterSupply">Water Supply System</bookmark> <bookmark title="StormWater">Storm Water System <bookmark title="PIT12">1.2 Kerb Opening (PIT12)</bookmark> <bookmark title="PIT13">1.2 Kerb Opening (PIT13)</bookmark> <bookmark title="PIT14">1.2 Kerb Opening (PIT14)</bookmark> <bookmark title="PIT15">1.2 Kerb Opening (PIT15)</bookmark> <bookmark title="PIT16">1.2 Kerb Opening (PIT16)</bookmark> <bookmark title="PIT17">1.2 Kerb Opening (PIT17)</bookmark> <bookmark title="PIT18">1.2 Kerb Opening (PIT18)</bookmark> <bookmark title="PIT19">1.2 Kerb Opening (PIT19)</bookmark> <bookmark title="PIT20" KeepAlways="1">1.2 Kerb Opening (PIT20)</bookmark> </bookmark> <bookmark title="digsig">Digital Signatures <bookmark title="engineer">Project Engineer</bookmark> <bookmark title="project">Project Manager</bookmark> </bookmark> </bookmark-tree>