Scheda Link/riferimento incrociato
La scheda Link/riferimento incrociato consente di inserire link o riferimenti incrociati negli argomenti DITA. Se si seleziona la scelta di menu > o il pulsante della barra menu degli strumenti Link e Gestione risorse DITA non è già aperto, Gestione risorse DITA viene aperto con la scheda Link/riferimento incrociato attiva. Questa scheda è disponibile in Gestione risorse DITA quando si modifica un argomento o una specializzazione di un argomento.
La scheda Link/riferimento incrociato può avere due stati diversi: il primo serve a inserire link o riferimenti incrociati a documenti locali, il secondo serve a inserire link o riferimenti incrociati a documenti su Internet.
Opzioni per l'inserimento di link o riferimenti incrociati a documenti locali
Per inserire link o riferimenti incrociati a documenti locali, la scheda Link/riferimento incrociato include le opzioni indicate di seguito.
• Cerca in - Determina la posizione dei contenuti visualizzati nel browser di Gestione risorse DITA.
Selezionare una posizione dall'elenco a discesa. Questo campo contiene sempre la posizione attualmente disponibile nel browser. Se si fa doppio clic su una cartella nel browser, tale cartella viene visualizzata nel campo Cerca in. Se si seleziona The Web in questo elenco, lo stato della scheda Link/riferimento incrociato cambia per consentire l'inserimento dei riferimenti ai documenti Internet.
L'elenco contiene una scelta
Posizioni preferite![](../../editor/editor_help/images/favoriteLocations.png)
Selezionando questa opzione, ci si sposta nella posizione visualizzata nel browser al nodo
Posizioni preferite in cui si trova un elenco delle posizioni preferite salvate.
L'elenco contiene anche una scelta di
Cronologia![](../../editor/editor_help/images/lastFolder.png)
. Selezionando questa scelta, ci si sposta nella posizione visualizzata nel browser al nodo
Cronologia in cui si trova un elenco di tutte le posizioni visitate nella sessione corrente.
• Pulsante
Menu![](../../editor/editor_help/images/menuButton.png)
- Visualizza un menu contenente le opzioni riportate di seguito.
◦ Apri (con suffisso Documento) - Se nel browser è selezionato un documento, tale documento viene aperto in una nuova finestra.
I documenti XML, DITA, SGML e HTML selezionati vengono aperti in una nuova finestra di Arbortext Editor. Altri tipi di documenti o di immagini vengono aperti nell'applicazione associata. Ad esempio, un'immagine viene visualizzata nell'applicazione per la gestione delle immagini di default.
◦ Cancella cronologia - Cancella l'elenco di posizioni visitate dal nodo Cronologia nel browser.
Questa scelta è disponibile solo se è selezionato il nodo Cronologia.
◦ Aggiungi a preferiti - Aggiunge la posizione selezionata all'elenco Posizioni preferite.
Questa scelta è disponibile solo se nel browser è selezionata una cartella del file system, una cartella del sistema di gestione dei contenuti (CMS) o una posizione simile.
◦ Rimuovi da preferiti - Rimuove la posizione selezionata dall'elenco Posizioni preferite.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Sposta su - Sposta un elemento nell'elenco Posizioni preferite di un livello superiore nell'elenco.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Sposta giù - Sposta un elemento nell'elenco Posizioni preferite di un livello inferiore nell'elenco.
Questa scelta è disponibile solo se è selezionato un elemento nell'elenco Posizioni preferite.
◦ Esporta preferiti - Visualizza la finestra di dialogo Salva con nome in cui è possibile salvare l'elenco delle posizioni preferite correnti in un file XML.
Questa scelta è disponibile solo se nel browser è selezionato il nodo Posizioni preferite. Con questa opzione è possibile salvare in un file XML i preferiti che possono essere quindi importati come elenco dei preferiti utilizzando la scelta di menu Importa preferiti. Non modificare questo file XML, poiché è destinato esclusivamente al salvataggio di un elenco dei preferiti.
◦ Importa preferiti - Visualizza la finestra di dialogo Apri in cui è possibile selezionare un file XML contenente un elenco dei preferiti Gestione risorse DITA esportato.
Questa scelta è disponibile solo se nel browser è selezionato il nodo Posizioni preferite. Questa opzione consente di importare come elenco dei preferiti esportati utilizzando la scelta di menu Esporta preferiti.
Dopo avere selezionato un file nella finestra di dialogo Apri e avere fatto clic su Apri, si apre un'altra finestra di dialogo in cui viene chiesto: Unire all'elenco o sostituire l'elenco dei preferiti corrente? Fare clic su Unisci per aggiungere all'elenco dei preferiti le posizioni presenti nell'elenco importato ma non ancora disponibili nell'elenco corrente. Fare clic su Sostituisci per sostituire completamente l'elenco dei preferiti corrente con l'elenco importato.
◦ Check-Out e modifica - Consente di aprire l'oggetto CMS selezionato in Arbortext Editor per la modifica.
Se l'oggetto non è stato sottoposto a Check-Out, Gestione risorse DITA esegue tale operazione, bloccandolo. È possibile sottoporre a Check-Out anche qualsiasi oggetto dipendente, nella stessa operazione. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Check-Out - Sottopone a Check-Out (blocca) l'oggetto CMS sbloccato selezionato.
È possibile sottoporre a Check-Out anche qualsiasi oggetto dipendente, nella stessa operazione. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Annulla Check-Out - Annulla il Check-Out di un oggetto CMS e ignora le modifiche apportate alla versione sottoposta a Check-Out.
Dopo l'annullamento del Check-Out di un oggetto, se l'oggetto documento è aperto in Arbortext Editor, diventa di sola lettura. Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Proprietà - Visualizza la finestra di dialogo
Proprietà oggetto, che contiene le proprietà dell'oggetto selezionato.
Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Cerca CMS - Visualizza la finestra di dialogo
Cerca.
Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection. La finestra di dialogo Cerca consente di immettere un'interrogazione per individuare tutti gli oggetti CMS corrispondenti a specifici criteri di ricerca. I risultati della ricerca vengono visualizzati nella parte Risultati ricerca CMS del browser Gestione risorse DITA.
◦ Cancella risultati ricerca CMS - Cancella tutti gli oggetti CMS aggiunti alla parte Risultati ricerca CMS del browser Gestione risorse DITA.
Questa scelta di menu è disponibile solo per gli adattatori CMS supportati. Questa azione non rimuove questi oggetti da CMS, ma solo dal browser Gestione risorse DITA.
Questa scelta di menu è disponibile solo nella scheda Link/riferimento incrociato quando si crea un link all'immagine intelligente. Se si utilizza il menu nella versione della scheda Link/riferimento incrociato per modificare un link, questa scelta di menu è denominata Modifica link evidenziazione. Se invece questo menu viene utilizzato nella finestra di dialogo Aggiungi link, la scelta di menu è denominata Aggiungi link evidenziazione.
Questa scelta di menu è disponibile solo nella scheda Link/riferimento incrociato quando si crea un link all'immagine intelligente. Se si utilizza il menu nella versione della scheda Link/riferimento incrociato per modificare un link, questa scelta di menu è denominata Modifica link animazione. Se invece questo menu viene utilizzato nella finestra di dialogoAggiungi link, la scelta di menu è denominata Aggiungi link animazione.
Questa scelta di menu è disponibile solo nella scheda Link/riferimento incrociato quando si crea un link all'immagine intelligente. Se si utilizza il menu nella versione della scheda Link/riferimento incrociato per modificare un link, questa scelta di menu è denominata Modifica link vista. Se invece questo menu viene utilizzato nella finestra di dialogoAggiungi link, la scelta di menu è denominata Aggiungi link vista.
◦ Sincronizza posizione tra schede - Determina se la prima posizione selezionata nel browser Gestione risorse DITA venga mantenuta o meno quando si passa a una scheda diversa o si apre un'altra finestra di dialogo Gestione risorse DITA.
L'impostazione della preferenza avanzata ditasynctabs determina lo stato di attivazione o disattivazione per default.
• Pulsante
Cartella precedente![](../../editor/editor_help/images/lastFolder.png)
- Sposta la posizione visualizzata nel browser sull'ultima cartella visualizzata nel browser.
Gestione risorse DITA conserva una cronologia delle cartelle visualizzate nella sessione corrente, quindi è possibile utilizzare questo pulsante per spostare la vista del browser indietro attraverso tale cronologia. Se è stata visualizzata solo una cartella nella sessione corrente, il pulsante è disattivato.
• Pulsante
Su di un livello![](../../editor/editor_help/images/upOneLevel.png)
- Sposta la posizione visualizzata nel browser di un livello in alto nella gerarchia corrente.
Se la posizione è già al livello superiore della gerarchia, tale pulsante è disattivato.
• Pulsante
Aggiorna ![](../../editor/editor_help/images/Refresh.png)
- Aggiorna la vista del browser in modo che rifletta eventuali modifiche apportate agli oggetti visualizzati nel browser.
• Pulsante
Cerca nel Web![](../../editor/editor_help/images/browseTheWeb.png)
- Cambia lo stato della scheda
Link/riferimento incrociato in modo da consentire l'inserimento di riferimenti da Internet.
• Pulsante
Documento corrente![](../../editor/editor_help/images/currentDocument.png)
- Apre il documento corrente nella vista del browser.
• Pulsante
Usa il browser oggetti CMS![](../../editor/editor_help/images/useCmsObjectBrowser.png)
- Richiama il
browser per
PTC Server Connection o un adattatore repository.
Questo pulsante è disponibile solo quando si è connessi a un sistema di gestione dei contenuti (CMS) tramite PTC Server Connection o un adattatore repository.
• Pulsante
Cerca CMS![](../../editor/editor_help/images/searchCMS.png)
- Richiama la finestra di dialogo
Cerca.
Questo pulsante è disponibile solo per gli oggetti PTC Server Connection. La finestra di dialogo Cerca consente di immettere un'interrogazione per individuare tutti gli oggetti CMS corrispondenti a specifici criteri di ricerca. I risultati della ricerca vengono visualizzati nella parte Risultati ricerca CMS del browser Gestione risorse DITA.
• Filtro - Consente di filtrare l'elenco dei file e degli elementi dei documenti visualizzati nel browser.
Quando si immette del testo in questa opzione, l'elenco dei file e degli elementi dei documenti visualizzati nel browser viene filtrato esclusivamente per mostrare i file o gli elementi le cui etichette contengono il testo immesso. In questo caso, l'opzione Filtro e il browser sono visualizzati in un colore di sfondo giallo chiaro a indicare che si sta filtrando il contenuto del browser.
Ad esempio, se si immette "test", solo gli oggetti con le etichette che contengono "Test", "testing", "test cases" e così via vengono visualizzati nel browser. Se un documento è stato espanso per visualizzare gli elementi all'interno del documento, vengono filtrati anche gli elementi visualizzati. In questo caso, il documento continua a essere visualizzato nel browser anche se la sua etichetta non contiene il testo per il filtro.
Il filtro non distingue tra caratteri maiuscoli e minuscoli. Cartelle e oggetti simili non vengono filtrati. Se si immettono più termini nell'opzione Filtro, le etichette corrispondenti devono contenere tutti i termini.
• Browser di Gestione risorse DITA - Fornisce un file system, un sistema di gestione dei contenuti (CMS) o la gerarchia dei documenti.
Il browser di Gestione risorse DITA consente di individuare il contenuto in un file system o in un sistema CMS da inserire nel documento. Il browser fornisce una visualizzazione gerarchica del contenuto del file system o del sistema CMS. Oltre a mostrare cartelle e file, il browser consente di visualizzare il contenuto dei documenti DITA. Ad esempio, quando si utilizza la scheda Link/riferimento incrociato, il browser visualizza in un documento DITA gli elementi disponibili da usare come link o riferimento incrociato in base al contesto corrente nel documento. Se è disponibile un titolo per un elemento, il titolo viene visualizzato nel browser accanto all'elemento. Viene anche visualizzato l'ID dell'elemento, a seconda dell'impostazione della preferenza avanzata ditahideids.
Se il documento contiene immagini intelligenti, a tali immagini è associata una particolare icona,
![](../../editor/editor_help/images/isoIcon.png)
. Questa icona viene visualizzata sotto l'immagine nel browser e mostra il tipo di link a immagini intelligenti che è possibile inserire per la specifica immagine, ad esempio
Inserisci link evidenziazione. Tali immagini consentono di creare link che modificano l'immagine quando vengono selezionati. Rendono inoltre possibile l'apertura di diverse viste dell'immagine, avviano animazioni o evidenziano parti dell'immagine. Se si desidera creare questi tipi di link per un'immagine intelligente, selezionare l'immagine e fare doppio clic sulle scelte
![](../../editor/editor_help/images/isoIcon.png)
nel browser o utilizzare il pulsante
Menu o il menu di scelta rapida
Gestione risorse DITA per indicare il tipo di link che si desidera creare. Qualora si intenda inserire un link regolare nell'immagine, fare clic normalmente sul pulsante
Inserisci.
Se si sta esplorando il contenuto di una mappa DITA che contiene definizioni chiave, è possibile espandere la mappa e le definizioni chiave vengono indicate da un'icona a forma di chiave,
![](../../editor/editor_help/images/ditainsertkeyref.png)
. Se si seleziona una definizione chiave, il nome della chiave viene inserito nell'opzione
Riferimento chiave. Se si inserisce il riferimento con la definizione chiave selezionata, i valori degli attributi
href,
scope,
type e
format dalla definizione chiave vengono utilizzati per il link o il riferimento incrociato inserito. Il valore dell'attributo
navtitle viene utilizzato per il testo del link. L'impostazione della preferenza avanzata
ditakeyrefui determina l'eventuale disponibilità di questa opzione nel browser di
Gestione risorse DITA.
Il browser contiene un nodo
Posizioni preferite![](../../editor/editor_help/images/favoriteLocations.png)
contenente l'elenco delle posizioni preferite salvate. Facendo doppio clic su uno dei preferiti, tale posizione viene aperta nel browser. Se una posizione preferita non è al momento disponibile, ad esempio se la posizione è stata eliminata o è una cartella CMS e non è stato effettuato l'accesso al CMS, la cartella presenta una particolare icona,
![](../../editor/editor_help/images/favoriteNotAvail.gif)
che indica lo stato.
Il browser contiene inoltre un nodo
Cronologia![](../../editor/editor_help/images/lastFolder.png)
con un elenco di tutte le posizioni visitate nella sessione corrente. Facendo doppio clic su una delle posizioni, tale posizione viene aperta nel browser.
Fare clic sul segno più (+) nella gerarchia per aprire un livello nella gerarchia o il contenuto di un documento. Fare clic sul segno meno ( – ) per chiudere un livello o un documento. Fare clic su un oggetto nella gerarchia per selezionarlo. Fare doppio clic su una cartella per spostare l'attivazione del browser su tale cartella. Fare doppio clic sull'elemento di un documento per inserire un link o riferimento incrociato a tale elemento nel documento.
È possibile inserire un riferimento al contenuto visualizzato nel browser all'interno del documento, come segue:
◦ Evidenziando un elemento e selezionando il pulsante Inserisci
◦ Facendo doppio clic su un elemento
◦ Utilizzando il trascinamento selezione
Se si fa doppio clic sul nodo Il Web del browser, lo stato della scheda Link/riferimento incrociato cambia per consentire l'inserimento dei riferimenti in documenti Internet.
• Tipo - Determina il tipo di documento visualizzato nel browser di Gestione risorse DITA.
Utilizzare questo elenco a discesa per filtrare i documenti visualizzati nel browser in base al tipo di documento. È possibile scegliere i seguenti tipi di documenti:
◦ Argomento - Visualizza solo i documenti argomento DITA.
◦ Topic or Map - Consente di visualizzare documenti mappa o argomento DITA.
◦ Map - Consente di visualizzare solo i documenti mappa DITA.
◦ Immagine - Consente di visualizzare solo i file delle immagini.
◦ PDF - Visualizza solo i documenti PDF.
◦ HTML - Consente di visualizzare solo i documenti HTML.
◦ Qualsiasi - Consente di visualizzare tutti i tipi di documenti.
• Mostra - Determina il tipo di elementi visualizzati per i documenti DITA nel browser di Gestione risorse DITA.
Utilizzare questo elenco a discesa per filtrare gli elementi visualizzati per i documenti nel browser in base al tipo di elemento.
• Inserisci - Determina il tipo di elemento da inserire nel documento.
Utilizzare questo elenco a discesa per selezionare il tipo di elemento da inserire nel documento. Per gli argomenti DITA non specializzati sono disponibili solo gli elementi xrefo link.
• Riferimento chiave - Consente di immettere il nome di una chiave da inserire nell'attributo keyref per il riferimento.
Utilizzare questa opzione quando si desidera aggiungere un riferimento chiave al riferimento che si sta inserendo. L'impostazione della preferenza avanzata ditakeyrefui determina l'eventuale disponibilità di questa opzione in Gestione risorse DITA. Se sono state definite delle chiavi in una delle mappe di definizione della chiave impostate nella preferenza avanzata ditakeycontext o ditakeybaselist per l'oggetto selezionato nel browser, tali chiavi vengono visualizzate per default nell'elenco a discesa.
• Pulsante Inserisci - Inserisce un link o un riferimento incrociato all'elemento selezionato nel documento che si sta modificando.
Se il contesto corrente nel documento non è un punto di inserimento valido, questo pulsante è disattivato.
Opzioni per l'inserimento di link o riferimenti incrociati a documenti su Internet
Per inserire link o riferimenti incrociati a un documento su Internet, la scheda Link/riferimento incrociato include le opzioni indicate di seguito.
• Cerca in - Determina lo stato della scheda Link/riferimento incrociato.
Quando si inserisce un link o un riferimento incrociato a un documento su Internet, questa opzione è sempre impostata su The Web. Se si seleziona una posizione diversa dall'elenco a discesa, lo stato della scheda cambia per consentire l'inserimento dei riferimenti ai documenti locali.
Pulsante
Menu![](../../editor/editor_help/images/menuButton.png)
- Visualizza un menu contenente le opzioni riportate di seguito.
◦ Apri (con suffisso Documento) - Questa scelta è disabilitata.
◦ Cerca CMS - Visualizza la finestra di dialogo
Cerca.
Questa scelta di menu è disponibile solo per gli oggetti di PTC Server Connection.
◦ Cancella risultati ricerca CMS - Cancella tutti gli oggetti CMS aggiunti alla parte Risultati ricerca CMS del browser Gestione risorse DITA.
◦ Sincronizza posizione tra schede - Determina se la prima posizione selezionata nel browser Gestione risorse DITA venga mantenuta o meno quando si passa a una scheda diversa o si apre un'altra finestra di dialogo Gestione risorse DITA.
L'impostazione della preferenza avanzata ditasynctabs determina lo stato di attivazione o disattivazione per default.
• Pulsante
Cartella precedente![](../../editor/editor_help/images/lastFolder.png)
- Sposta la posizione visualizzata nel browser sull'ultima cartella visualizzata nel browser.
Se l'ultima posizione visualizzata nel browser non è The Web, lo stato della scheda cambia per consentire l'inserimento dei riferimenti ai documenti locali.
• Pulsante
Su di un livello![](../../editor/editor_help/images/upOneLevel.png)
- Questo pulsante è disattivato.
• Pulsante
Aggiorna![](../../editor/editor_help/images/Refresh.png)
- Questo pulsante è disattivato.
• Pulsante
Cerca nel Web![](../../editor/editor_help/images/browseTheWeb.png)
- Questo pulsante è disattivato.
• Pulsante
Documento corrente![](../../editor/editor_help/images/currentDocument.png)
- Apre il documento corrente nella vista del browser.
Lo stato della scheda diventa quello per l'inserimento dei riferimenti nei documenti locali.
• Pulsante
Usa il browser oggetti CMS![](../../editor/editor_help/images/useCmsObjectBrowser.png)
- Richiama il
browser per
PTC Server Connection o un adattatore repository.
Questo pulsante è disponibile solo quando si è connessi a un sistema di gestione dei contenuti (CMS) tramite PTC Server Connection o un adattatore repository.
• Pulsante
Cerca CMS![](../../editor/editor_help/images/searchCMS.png)
- Richiama la finestra di dialogo
Cerca.
Questo pulsante è disponibile solo per gli oggetti PTC Server Connection. La finestra di dialogo Cerca consente di immettere un'interrogazione per individuare tutti gli oggetti CMS corrispondenti a specifici criteri di ricerca. I risultati della ricerca vengono visualizzati nella parte Risultati ricerca CMS del browser Gestione risorse DITA.
• URL - Visualizza l'URL da inserire per il link o il riferimento incrociato.
È possibile modificare questo campo per aggiungere l'URL desiderato o selezionare il pulsante Recupera URL browser per inserire l'URL per la pagina Web visualizzata nel browser Web attivo all'interno dell'opzione.
• Apri browser - Apre il browser Web di default.
Se è presente un URL nell'opzione
URL, il browser Web viene aperto con quella pagina Web visualizzata. Per utilizzare questa opzione è necessario disporre di un browser Web di default impostato nel sistema operativo o nelle preferenze di
Posizioni dei file nella finestra di dialogo Preferenze.
• Recupera URL browser - Consente di inserire l'URL della pagina Web visualizzata nel browser Web attivo all'interno dell'opzione URL.
Per utilizzare questa opzione è necessario disporre di un browser Web di default impostato nel sistema operativo o nelle preferenze di
Posizioni dei file nella finestra di dialogo Preferenze.
• Inserisci - Determina il tipo di elemento da inserire nel documento.
Utilizzare questo elenco a discesa per selezionare il tipo di elemento da inserire nel documento. Per gli argomenti DITA non specializzati sono disponibili solo gli elementi xrefo link.
• Riferimento chiave - Consente di immettere il nome di una chiave da inserire nell'attributo keyref per il riferimento.
Utilizzare questa opzione quando si desidera aggiungere un riferimento chiave al riferimento che si sta inserendo. L'impostazione della preferenza avanzata ditakeyrefui determina l'eventuale disponibilità di questa opzione in Gestione risorse DITA. Se sono state definite delle chiavi in una delle mappe di definizione della chiave impostate nella preferenza avanzata ditakeycontexto ditakeybaselist per l'URL visualizzato nel browser, tali chiavi vengono visualizzate per default nell'elenco a discesa.
• Pulsante Inserisci - Inserisce un link o un riferimento incrociato all'URL designato nel documento che si sta modificando.
Se il contesto corrente nel documento non è un punto di inserimento valido, questo pulsante è disattivato.