Scheda Argomento
La scheda Argomento consente di inserire riferimenti ad argomento nelle mappe DITA. Se si seleziona la scelta di menu > e la funzione Gestione risorse DITA non è già aperta, la finestra di Gestione risorse DITA viene visualizzata con la scheda Argomento attiva. Questa scheda è disponibile in Gestione risorse DITA quando si modifica una mappa o una specializzazione di una mappa.
La scheda Argomento può avere due stati diversi: il primo serve a inserire riferimenti ad argomento di documenti locali, il secondo serve a inserire riferimenti ad argomento di documenti su Internet.
Opzioni per l'inserimento di riferimenti ad argomento di documenti locali
Per inserire riferimenti ad argomento di documenti locali, la scheda Argomento include le opzioni riportate 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 Argomento cambia per consentire l'inserimento dei riferimenti di documenti su 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, diventerà 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.
◦ 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
Cartella documento corrente![](../../editor/editor_help/images/currentDirectory.png)
- Sposta la posizione visualizzata nel browser nella cartella che contiene il documento corrente.
• 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
Argomento in modo da consentire l'inserimento di riferimenti da Internet.
• Pulsante
Usa il browser oggetti CMS![](../../editor/editor_help/images/useCmsObjectBrowser.png)
- Visualizza il
browser per
PTC Server Connection o per 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 Argomento, il browser visualizza in un documento DITA gli elementi disponibili da usare come un riferimento ad argomento 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 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, per il riferimento inserito viene utilizzato il valore degli attributi
href,
scope,
type,
format e
navtitle dalla definizione chiave. 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 su un documento o su un suo elemento per inserire un riferimento a tale argomento nel documento. Per inserire un riferimento ad argomento è possibile selezionare e trascinare gli argomenti dal browser in una mappa DITA. È inoltre possibile fare clic tenendo premuto il tasto CTRL per selezionare più argomenti nel browser, quindi fare clic sul pulsante Inserisci o utilizzare il trascinamento della selezione per inserire riferimenti a tutti gli argomenti selezionati. Se è presente una cartella contenente uno o più argomenti DITA, è possibile selezionarla e fare clic sul pulsante Inserisci oppure utilizzare il trascinamento della selezione per inserire nel documento riferimenti a tutti gli argomenti della cartella. Se la cartella di inserimento contiene sottocartelle, nella mappa DITA verrà conservata la gerarchia delle cartelle. In questo caso, le cartelle diventano elementi topichead.
• 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.
• Inserisci - Determina il tipo di elemento da inserire nel documento.
Utilizzare questo elenco a discesa per selezionare il tipo di elemento di riferimento da inserire nel documento.
• 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 nella posizione indicata un riferimento 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 riferimenti ad argomento di documenti su Internet
Per inserire riferimenti ad argomento di un documento su Internet, la scheda Argomento include le opzioni indicate di seguito.
• Cerca in - Determina lo stato della scheda Argomento.
Quando si inserisce un riferimento ad argomento di 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
Cartella documento corrente![](../../editor/editor_help/images/currentDirectory.png)
- Sposta la posizione visualizzata nel browser nella cartella che contiene il documento corrente.
Lo stato della scheda diventa quello per la modifica dei riferimenti a documenti locali.
• 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
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 di riferimento da inserire nel documento.
• 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, nella posizione indicata, un riferimento all'URL specificato nella mappa che si sta modificando.
Se il contesto corrente nella mappa non è un punto di inserimento valido, questo pulsante è disattivato.