Instalando o Sistema de Ajuda como um Infocenter
Você pode permitir que seus usuários acessem o sistema de ajuda na Internet ou em uma
intranet, instalando o sistema de ajuda independente e os plug-ins de
documentação em um servidor web. O aplicativo acessa a documentação chamando
uma URL e o sistema de ajuda é mostrado em seu navegador da Web. O sistema de ajuda
infocenter pode ser utilizado para aplicativos do cliente e para aplicativos da web, um dos
quais pode ter sua ajuda acessada remotamente. Todos os recursos exceto o infopops e a
ajuda ativa são suportados.
Instalação/Compactação
Essas etapas são destinadas ao integrador do sistema de ajuda
e ao administrador da web e não se destinam a endereçar todos os cenários possíveis. Supõe-se que
toda sua documentação seja entregue como plug-ins do Eclipse e, geralmente, que você esteja familiarizado
com o sistema de ajuda do eclipse. Para os usuários finais, supõe-se que eles tenham
IE5.x ou 6.x ou Mozilla instalado em suas máquinas.
- Certifique-se de que um servidor de aplicativos esteja instalado na máquina. Temos verificado
com Tomcat 3 e Tomcat 4.
- Faça download do driver Platform Runtime Binary do Eclipse Release 2.0 de
www.eclipse.org.
- Instale (descompacte) o driver em um diretório d:\eclipse.
- Registre o aplicativo de Ajuda do Eclipse que reside em
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0 com o servidor Web. Não copie
esse diretório em outro lugar; ele deve permanecer na árvore de instalação do Eclipse.
No
Tomcat esse registro pode ser executado incluindo as seguintes linhas no
arquivo tomcat\conf\server.xml:
<Caminho do contexto="/help" docBase="d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0">
</Context>
No Tomcat 3, inclua as linhas próximas ao final do arquivo, como o último elemento na
seção ContextManager. No Tomcat 4, inclua essa seção como o último elemento
na seção Host.
- Instale as correções a seguir, dependendo de qual servidor você está utilizando:
- Tomcat 3: O Tomcat 3 não possui biblioteca do analisador XML disponível para
um aplicativo da web. Para corrigir isso, copie xercesImpl.jar e xmlParserAPIs.jar de
d:\eclipse\plugins\org.apache.xerces_4.0.3\ para
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF\lib\
- Tomcat 4:
- Eclipse e Tomcat contêm o código para definir um
URLStreamHandler, mas eles podem apenas serem definidos uma vez. Para permitir que Tomcat e
Eclipse funcionem corretamente, uma biblioteca
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar precisa
ser incluída no caminho de classe na inicialização do Tomcat. No Tomcat 4.0.3, edite
o arquivo tomcat/bin/setclasspath.bat e após a linha:
set CLASSPATH=%JAVA_HOME%\lib\tools.jar
insira a linha:
set CLASSPATH=%CLASSPATH%;d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\eclipseurl.jar.
-
Devido as alterações na biblioteca xml, remova tomcat\common\lib\xerces.jar, then edit setclasspath.bat substituindo a linha
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.
- Desative JSP pré-compilado:. A menos que você esteja utilizando o Tomcat 4.0.x ou
planeje enviar os arquivos jar de jaspe, também é necessário copiar
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\infocenter\web.xml para
d:\eclipse\plugins\org.eclipse.help.webapp_2.0.0\WEB-INF.
Utilizando o Infocenter
Inicie o servidor Web. Aponte um navegador da Web para o caminho do aplicativo da
Web. Na máquina que o Tomcat está instalado, este deve ser
http://localhost:8080/help/.
Instalando a Documentação Personalizada
A plataforma Eclipse é fornecida com sua própria documentação, contida no plug-in
org.eclipse.platform.doc.user. Esta estará disponível no
infocenter por padrão. Para exibir sua própria documentação, compacte a
documentação como plug-ins de documentação do Eclipse. Instale-os em
d:\eclipse\plugins\.