El sistema de ayuda de Eclipse puede configurarse y personalizarse para adaptarlo al producto especificando valores por omisión personalizados para diversas preferencias de la ayuda.
El sistema de ayuda propiamente dicho está dividido en varios conectores independientes.
Estas tablas muestran las preferencias disponibles y el conector que las define.
Consulte la sección Personalizar un
producto para obtener información acerca de cómo alterar temporalmente algunas de estas preferencias.
Clave de preferencia | Utilización |
Valor por omisión |
baseTOCS | Orden de archivos Toc. Lista ordenada de los TOC (libros) de ayuda tal como aparecerán en la estantería.Todos los demás TOC seguirán estos libros.Los TOC que no estén presentes en esta lista se pasarán por alto.Utilice la ubicación de cada TOC como /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 | Inhabilitar TOC. Lista de TOC (manuales) de ayuda que el sistema de ayuda pasará por alto. Los TOC inhabilitados no aparecerán en la lista de manuales y no se pueden crear enlaces a los mismos. Los temas definidos por TOC inhabilitados no estarán disponibles en las búsquedas. Los TOC que no estén presentes en esta lista se pasarán por alto. Utilice la ubicación de cada TOC como /pluginId/path/to/toc.xml. |
Clave de preferencia | Utilización |
Valor por omisión |
banner | Ubicación de la página de mensaje de cabecera en el marco superior Ejemplo: banner=/org.eclipse.help.webapp/advanced/banner.html |
|
banner_height | Altura del marco de mensaje de cabecera Ejemplo: banner_height=60 |
|
help_home | Página que debe aparecer en el área de contenido al abrir la ayuda. Especifique la página html como /pluginId/path/to/home.html. | /org.eclipse.help.base/doc/help_home.html |
linksView | Establézcala en true o false para controlar la visibilidad de la vista de enlaces relacionados. Nota: esta opción no afecta en absoluto al centro informativo. |
true |
bookmarksView | Establézcala en true o false para controlar la visibilidad de la vista de favoritos. Nota: esta opción no afecta en absoluto al centro informativo. |
true |
windowTitlePrefix | Establézcala en true o false para controlar el título de la ventana del navegador. Si es true, el título tendrá el formato "Ayuda - <NOMBRE_PRODUCTO>"; de lo contrario, será <NOMBRE_PRODUCTO>", donde <NOMBRE_PRODUCTO> es el nombre del producto Eclipse establecido en la característica primaria. | true |
loadBookAtOnceLimit | Número máximo de temas que puede tener un libro, para que el navegador cargue la navegación como un solo documento. La navegación de libros más grandes se carga dinámicamente, con menos niveles cada vez. Se bajan más temas cuando es necesario, expandiendo las ramas. | 1000 |
dynamicLoadDepthsHint | Número sugerido de niveles de la navegación de temas bajada al navegador para libros grandes.
El valor debe ser superior a 0. El número real de niveles puede ser diferente en un árbol grande si el número de niveles sugerido contiene un gran número de temas. |
3 |
imagesDirectory | Directorio que contiene imágenes utilizadas en la vista de ayuda. Las imágenes deben tener el mismo nombre que las del conector org.eclipse.help.webapp. Utilice el formato /IDconector/directorio. | images |
advanced.toolbarBackground | Fondo de CSS para barras de herramientas. El valor se utiliza en navegadores que visualizan la UI de ayuda avanzada. | ButtonFace |
advanced.viewBackground | Fondo de CSS para vistas de navegación. El valor se utiliza en navegadores que visualizan la UI de ayuda avanzada. | Window |
advanced.toolbarFont | Font de CSS para barras de herramientas. El valor se utiliza en navegadores que visualizan la UI de ayuda avanzada. | icon |
advanced.viewFont | Font de CSS para vistas de navegación. El valor se utiliza en navegadores que visualizan la UI de ayuda avanzada. | icon |
basic.toolbarBackground | Color de fondo para barras de herramientas. El valor se utiliza en navegadores que visualizan la UI de ayuda básica. | #D4D0C8 |
basic.viewBackground | Color de fondo para vistas de navegación. El valor se utiliza en navegadores que visualizan la UI de ayuda básica. | #FFFFFF |
locales | Lista de entornos locales que el centro informativo reconocerá y para
los que suministrará contenido personalizado; si los entornos locales (o
idiomas) aceptados por el navegador cliente no se comparan con los entornos
locales de esta lista, el navegador recibirá contenido del entorno local por
omisión (el entorno local del servidor o el entorno local especificado por la
opción de línea de mandatos -nl de
Eclipse; si no se especifica la lista, el navegador recibirá contenido de su
entorno local preferido. Nota: el hecho de no especificar esta opción puede
significar requisitos de memoria y espacio de disco de grandes dimensiones, ya
que se crearán navegaciones e índices para cada entorno local preferido en los
navegadores que accedan al centro informativo. Ejemplo: locales=en ja zh_CN zh_TW |
|
productIndex | Si se suministra un índice de documentación preconstruido con el producto, debe especificarse aquí el ID del conector que suministra el índice al sistema de ayuda. | |
always_external_browser |
Utilice incorporado siempre que sea posible (en
Windows o Linux), o siempre externo. El establecimiento en true forzará la utilización de un navegador externo. La opción no tiene ningún efecto si no hay ningún navegador incorporado disponible en una plataforma determinada. |
false |
default_browser | Navegador externo por omisión. ID de uno de los navegadores Web externos añadidos al punto de extensión org.eclipse.help.base.browser que el sistema de ayuda utilizará.El método available() del adaptador del navegador devolverá true en el sistema actual. Esta preferencia controla los navegadores externos en la modalidad de ayuda autónoma. En la modalidad de entorno de trabajo, la ayuda utiliza los navegadores proporcionados por el soporte de navegadores de entorno de trabajo. |
valor por omisión establecido dinámicamente en función del navegador disponible en un sistema determinado |
custom_browser_path | Vía de acceso ejecutable del navegador personalizado Esta preferencia controla los navegadores externos en la modalidad de ayuda autónoma. En la modalidad de entorno de trabajo, la ayuda utiliza los navegadores proporcionados por el soporte de navegadores de entorno de trabajo. |
C:\Program
Files\Internet Explorer\IEXPLORE.EXE" %1 - en
Windows, "konqueror %1" - on Linux "mozilla %1" - en otras plataformas |
showDisabledActivityTopics | El sistema de ayuda filtra los temas de las posibilidades inhabilitadas. Esta opción controla este comportamiento y la existencia del botón Mostrar todos los temas. Valores aceptados: never, off, on, always never - no se muestran los temas de las posibilidades inhabilitadas off - el usuario puede elegir mostrar todos los temas, los temas inhabilitados quedan ocultos inicialmente on - el usuario puede elegir mostrar todos los temas, todos los temas se muestran inicialmente always - se muestran los temas de las posibilidades inhabilitadas (filtrado inhabilitado) |
off |
activeHelp | Permite habilitar e inhabilitar la ejecución de la ayuda activa.
Esta opción no tiene ningún efecto sobre la configuración de centro
informativo, donde la ayuda activa está inhabilitada. Valores aceptados: true - acciones de ayuda activa por omisión habilitadas false - infraestructura de ayuda activa inhabilitada |
true |
window_infopop | Permite habilitar las ventanas emergentes de información a la antigua cuando se pulsa la tecla de ayuda en las ventanas del entorno de trabajo. Si el valor es false, se abrirá en su lugar la nueva vista de ayuda dinámica. | false |
dialog_infopop |
Permite habilitar las ventanas
emergentes de información a la antigua cuando se pulsa la tecla de ayuda en los
diálogos. Si el valor es false, se abrirá en su lugar la nueva ventana de ayuda dinámica. |
false |
Clave de preferencia | Utilización |
Valor por omisión |
port | Número de puerto en el que el servidor está a la escucha de las peticiones http. Si no se proporciona el puerto, el sistema elige un puerto arbitrario. | |
host |
Dirección o nombre de sistema principal que debe utilizarse para conectarse al servidor. El valor por omisión es nothing (ninguno), y Eclipse elegirá una dirección local disponible. Los productos que utilizan la ayuda en la modalidad local (entorno
de trabajo o autónomo, no el centro informativo), pueden establecer esta
preferencia en
"127.0.0.1" para
asegurarse de que el servidor de ayuda no esté expuesto a otros usuarios de la red.
|
Clave de preferencia | Utilización |
Valor por omisión |
acceptCount | Longitud de cola máxima para las peticiones de conexión entrantes cuando todas las hebras de proceso de petición posibles se están utilizando. Las peticiones recibidas cuando la cola esté llena se rechazarán. | 100 |
maxProcessors |
Número máximo de hebras de proceso de peticiones que este conector debe crear, lo que por tanto determina el número máximo de peticiones simultáneas que pueden manejarse. |
75 |
minProcessors |
Número de hebras de proceso de peticiones que se crearán cuando este conector se inicie por primera vez. Este atributo debe establecerse en un valor inferior al establecido para maxProcessors. |
5 |