Instalar el sistema de ayuda como centro informativo
Si desea permitir a sus usuarios acceder al sistema de ayuda por Internet o
por una intranet, puede instalar el sistema de ayuda autónomo y los conectores
de documentación en un servidor Web. La aplicación accede a la documentación
llamando a un URL, y el sistema de ayuda se muestra en el navegador Web de los
usuarios. El sistema de ayuda del centro informativo se puede usar para las
aplicaciones de cliente y para las aplicaciones Web, a cuya ayuda se puede
acceder remotamente. Están soportadas todas las características, salvo las ayudas
emergentes y la ayuda activa.
Instalación/empaquetado
Estos pasos están destinados al integrador del sistema de ayuda y a la
administración Web, pero no representan una respuesta para todos los escenarios
posibles. Se da por sentado que ha recibido toda la documentación en forma
conectores de Eclipse, y que, en general, está familiarizado con el sistema de
ayuda de Eclipse. En el caso de los usuarios finales, se presupone que tienen
instalado IE5.x o 6.x o Mozilla en sus máquinas.
- Asegúrese de que hay un servidor de aplicaciones instalado en la máquina.
Hemos realizado pruebas con Tomcat 3 y Tomcat 4.
- Baje el controlador Platform Runtime Binary del nivel de release Eclipse 2.0 de
www.eclipse.org.
- Instale (extraiga del zip) el controlador en un directorio d:\eclipse.
- En el servidor Web, registre la aplicación de ayuda de Eclipse que reside
en d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0. No copie este directorio
en ninguna otra parte; debe permanecer en el árbol de instalación de Eclipse.
En
Tomcat, este registro se puede lograr añadiendo las siguientes líneas al archivo
tomcat\conf\server.xml:
<Context path="/help" docBase="d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0">
</Context>
En Tomcat 3, añada las líneas junto al final del archivo, como último
elemento de la sección ContextManager. En Tomcat 4, añada esta sección como
último elemento de la sección Host.
- En función del servidor que esté utilizando, instale los siguientes arreglos:
- Tomcat 3: en Tomcat 3 no hay una biblioteca de analizador
XML disponible para una aplicación Web. Para solucionar este problema, copie en
el directorio d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF\lib\ los
archivos xercesImpl.jar y xmlParserAPIs.jar del directorio
d:\eclipse\plugins\org.apache.xerces_4.0.3\.
- Tomcat 4:
- Eclipse y Tomcat contienen código para establecer un
URLStreamHandler, pero solo se puede establecer una vez. Para permitir que
Tomcat y Eclipse funcionen correctamente, hay que añadir una biblioteca de
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar a la
vía de acceso de clases en el momento del inicio de Tomcat. En Tomcat 4.0.3
edite el archivo tomcat/bin/setclasspath.bat y, después de la línea:
set CLASSPATH=%JAVA_HOME%\lib\tools.jar
inserte la línea:
set CLASSPATH=%CLASSPATH%;d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar.
-
Debido a los cambios realizados en la biblioteca xml, elimine
tomcat\common\lib\xerces.jar, y luego edite setclasspath.bat sustituyendo la línea
set JAVA_OPTS=
por
set JAVA_OPTS=-Xbootclasspath/a:d:\eclipse\plugins\org.apache.xerces_4.0.3\xercesImpl.jar;d:\eclipse\plugins\org.apaches.xerces_4.0.3\xmlParserAPIs.jar.
- Inhabilite los JSP precompilados: a menos que esté
utilizando Tomcat 4.0.x o se proponga enviar los archivos JAR
jasper, también debe copiar
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\web.xml en
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF.
Utilización del centro informativo
Inicie el servidor Web. Haga que un navegador Web señale hacia la vía de
acceso de la aplicación Web. En la máquina en la que está instalado Tomcat,
sería http://localhost:8080/help/.
Instalar documentación personalizada
La plataforma Eclipse viene con documentación propia, situada en el conector
org.eclipse.platform.doc.user. Por omisión, estará disponible en el centro
informativo. Si desea que se muestre su propia documentación, empaquétela en forma
de conectores de documentación de Eclipse. Instálelos en d:\eclipse\plugins\.