Il sistema della Guida Eclipse può essere configurato e strutturato in
base al prodotto specificando impostazioni predefinite personalizzate relative
al numero di preferenze.
La guida stessa è suddivisa in un certo numero di plugin separati.
In queste tabelle vengono illustrate le preferenze disponibili e il
plugin che le definisce. Fare riferimento alla sezione
Personalizzazione di
un prodotto per informazioni su come sostituire alcune preferenze.
Chiave della preferenza | Utilizzo |
Impostazione predefinita |
baseTOCS | Ordine del sommario. Elenco ordinato dei sommari (rappresentati dalla figura di un libro) della Guida, così come vengono visualizzati. Tutti gli altri sommari saranno seguiti da queste immagini dei libri. I sommari non presenti nell'elenco verranno ignorati. Utilizzare il percorso di ciascun sommario come /pluginId/path/to/toc.xml. | /org.eclipse.platform.doc.user/toc.xml, /org.eclipse.jdt.doc.user/toc.xml, /org.eclipse.platform.doc.isv/toc.xml, /org.eclipse.jdt.doc.isv/toc.xml, /org.eclipse.pde.doc.user/toc.xml |
ignoredTOCS | Disattivazione dei sommari. Elenco dei sommari della guida (manuali) che saranno ignorati dal sistema della guida. I sommari disattivati non appariranno nell'elenco dei manuali, non è possibile effettuare il collegamento. Gli argomenti definiti nei sommari disattivati non saranno disponibili per la ricerca. I sommari non presenti nell'elenco verranno ignorati. Utilizzare il percorso di ciascun sommario come /pluginId/path/to/toc.xml. |
Chiave della preferenza | Utilizzo |
Impostazione predefinita |
banner | Percorso della pagina del banner da visualizzare nel riquadro superiore Esempio: banner=/org.eclipse.help.webapp/advanced/banner.html |
|
banner_height | Altezza del riquadro del banner Esempio: banner_height=60 |
|
help_home | La pagina da visualizzare nell'area dei contenuti all'apertura della Guida. Specificare la pagina html come /pluginId/path/to/home.html. | /org.eclipse.help.base/doc/help_home.html |
linksView | Impostata su true o false per controllare la visibilità
della vista dei collegamenti correlati. Nota: questa opzione non ha alcun effetto nel centro informazioni. |
true |
bookmarksView | Impostata su true o false per controllare la visibilità
della vista dei segnalibri. Nota: questa opzione non ha alcun effetto nel centro informazioni. |
true |
windowTitlePrefix | Impostata su true o false per controllare la visibilità della finestra del browser. Se è impostata su true, il titolo presenterà il formato "Help - <PRODUCT_NAME>", in caso contrario il titolo sarà "<PRODUCT_NAME>", dove <PRODUCT_NAME> è il nome del prodotto Eclipse impostato nella funzione principale. | true |
loadBookAtOnceLimit | Il numero massimo di argomenti che un libro può contenere, per far sì che il browser possa scaricarlo come un documento unico da consultare. La navigazione per libri più grandi viene caricata dinamicamente, vari livelli alla volta. Quando i rami vengono espansi, vengono scaricati più argomenti se necessario. | 1000 |
dynamicLoadDepthsHint | Numero consigliato di livelli nella navigazione degli
argomenti scaricati sul browser per libri di grandi dimensioni.
Il valore deve essere superiore a 0. Il numero effettivo di argomenti
può differire nel caso di strutture più grandi se il numero consigliato di
livelli contiene un numero di argomenti maggiore. |
3 |
imagesDirectory | Directory contenenti le immagini utilizzate bella vista della Guida. Le immagini devono avere lo stesso nome riportato nei plugin org.eclipse.help.webapp. Utilizzare il formato /pluginID/directory. | images |
advanced.toolbarBackground | Sfondo CSS per le barre degli strumenti. Il valore viene utilizzato nei browser che visualizzano la UI della guida avanzata. | ButtonFace |
advanced.viewBackground | Sfondo CSS per la vista Selezione. Il valore viene utilizzato nei browser che visualizzano la UI della guida avanzata. | Window |
advanced.toolbarFont | Font CSS per le barre degli strumenti. Il valore viene utilizzato nei browser che visualizzano la UI della guida avanzata. | icon |
advanced.viewFont | Font CSS per le viste Selezione. Il valore viene utilizzato nei browser che visualizzano la UI della guida avanzata. | icon |
basic.toolbarBackground | Colore di sfondo per le barre degli strumenti. Il valore viene utilizzato nei browser che visualizzano la UI della guida di base. | #D4D0C8 |
basic.viewBackground | Colore di sfondo per le viste Selezione. Il valore viene utilizzato nei browser che visualizzano la UI della guida di base. | #FFFFFF |
locales | Elenco di impostazioni internazionali che il centro informazioni
riconoscerà e per le quali fornirà un contenuto personalizzato. Se le
impostazioni internazionali (o le lingue) accettate dal client del browser
non corrispondono a quelle riportate nell'elenco, il browser presenterà il
contenuto relativo alle impostazioni internazionali predefinite, quelle del
server o quelle specificate dall'impostazione della riga comandi
-nl di eclipse. Se non viene
specificato alcun elenco, il browser presenterà il contenuto relativo
all'impostazione internazionale preferita. Nota: la mancata specifica di tale
opzione può determinare l'utilizzo di una grande quantità di memoria e di
spazio su disco in quanto le navigazioni e gli indici verranno creati
per ogni singola impostazione internazionale preferita tra i browser che
accedono al centro informazioni. Esempio: locales=en ja zh_CN zh_TW |
|
productIndex | Se l'indice della documentazione per prodotto già incorporato viene fornito insieme al prodotto, l'ID del plugin che fornisce l'indice deve essere specificato nel sistema della Guida in questa posizione. | |
always_external_browser |
Utilizzare incorporato se possibile (in
Windows o Linux) o sempre esterno. L'impostazione su true comporterà
l'utilizzo del browser esterno. L'opzione non ha effetto se il browser
incorporato non è disponibile su una determinata piattaforma. |
false |
default_browser | Browser esterno predefinito. ID di uno dei browser Web esterni fornito al punto di estensione org.eclipse.help.base.browser extension che il sistema della Guida utilizzerà. Il metodo available() dell'adattatore del browser deve restituire true sul sistema corrente. Questa preferenza controlla i browser esterni nella modalità della guida autonoma. Nella modalità workbench, la guida utilizza i browser forniti dal supporto browser del workbench. |
valore predefinito impostato dinamicamente in base al browser
disponibile su un determinato sistema. |
custom_browser_path | Percorso eseguibile per il browser personalizzato Questa preferenza controlla i browser esterni nella modalità della guida autonoma. Nella modalità workbench, la guida utilizza i browser forniti dal supporto browser del workbench. |
C:\Program
Files\Internet Explorer\IEXPLORE.EXE" %1 - su Windows, "konqueror %1" - su Linux "mozilla %1" - su altre piattaforme |
showDisabledActivityTopics | Il sistema della Guida filtra gli argomenti dalle funzionalità
disattivate. Questa opzione controlla questo comportamento e
l'esistenza del pulsante Visualizza tutti gli argomenti. Valori accettati: never, off, on, always never - gli argomenti dalle funzionalità disattivate non vengono visualizzati off - l'utente può scegliere di visualizzare tutti gli argomenti, gli argomenti disattivati inizialmente nascosti on - l'utente può scegliere di visualizzare tutti gli argomenti, gli argomenti disattivati inizialmente visualizzati always - vengono visualizzati gli argomenti dalle funzionalità disattivate (filtro disattivato) |
off |
activeHelp | Consente l'attivazione e la disattivazione dell'esecuzione
della guida attiva.
L'opzione non ha alcun effetto nell'impostazione del centro informazioni, in
cui la
guida attiva è disattivata. Valori accettati: true - azioni della guida attiva predefinite attivate false - framework della guida attiva disattivato |
true |
window_infopop | Consente l'attivazione degli aiuti a comparsa nel vecchio stile quando si preme un tasto di aiuto nelle finestre del workbench. Se impostata su false, verrà invece aperta la nuova vista della guida dinamica. | false |
dialog_infopop |
Consente l'attivazione degli aiuti a comparsa nel vecchio stile quando si preme un tasto di aiuto
nelle finestre di dialogo. Se impostata su false, verrà invece aperta la nuova finestra della guida dinamica. |
false |
Chiave della preferenza | Utilizzo |
Impostazione predefinita |
port | Il numero di porta su cui il server si mette in ascolto delle richieste http. Se non viene fornita una porta, una porta arbitraria viene scelta dal sistema. | |
host |
L'indirizzo o il nome dell'host da utilizzare per la connessione al server. L'impostazione predefinita consiste nel non specificarne alcuno in quanto sarà Eclipse a scegliere un indirizzo locale disponibile. I prodotti che utilizzano la guida in modalità locale (workbench o autonoma, non Centro
informazioni), possono impostare questa preferenza a
"127.0.0.1" per assicurare che il server della guida
non sia esposto ad altri utenti nella rete. |
Chiave della preferenza | Utilizzo |
Impostazione predefinita |
acceptCount | La lunghezza massima della coda per le richieste di connessione in arrivo quando sono già in uso tutti i thread di elaborazione delle richieste possibili. Qualsiasi richiesta ricevuta quando la coda è piena verrà rifiutata. | 100 |
maxProcessors |
Il numero massimo di thread di
elaborazione delle richieste che questo Connector può creare, che determina
quindi il numero massimo di richieste simultanee che è possibile gestire. |
75 |
minProcessors |
Il numero di thread di elaborazione
delle richieste che verrà creato al primo avvio del Connector. Questo valore
deve essere impostato su un valore inferiore rispetto a quello impostato
per maxProcessors. |
5 |