Differences

This shows you the differences between two versions of the page.

--- java:infocenter [2011/11/01 17:24] – rlunaro
+++ java:infocenter [2022/12/02 22:02] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== InfoCenter -- Second Try and Failed ======
+====== InfoCenter -- Four and final attempt ======
-===== Resume of achievements =====
+Eventually I've found the steps for getting the [[http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Fguide%2Fua_help_setup_preferences.htm|eclipse infocenter]] as an standalone application.
-Doesn't work. I've tried to deploy in a Jboss and it fails: probably it lacks content, but something should appear on screen instead of an error, isn't??? I am starting to think that this is due to an error: possible I am missing something in the deployment or the instructions aren't so complete as they seem. Anyway, I will focus on these readings I've found in internet and if they doesn't work, I will declare this project as ended and failed.
+===== Step 1: download the file of this guy =====
-  * http://www.eclipsezone.com/eclipse/forums/t99336.html
+This guy:
-  * http://blog.maxant.co.uk/pebble/2008/06/09/1213043100000.html
-===== Introduction =====
+http://www.ipov.net/apps/blog/2011/01/eclipse-infocenter-help-as-web-app/
-I run into several problems in the first attempt to create an infocenter for myself. As you may know, the "infocenter" is the eclipse help system, and I want to run my own infocenter, in other words, with my own content.
+have done all the staff of isolating the infocenter as an standalone application for us. So the only thing we have to do is download the jar file who has provided and install it in a tomcat directory.
-The problem in the first approximation (to empty the eclipse and installing a plugin with my help contents) is that it is not easy to delete the contents of eclipse. [[InfocenterFirstTry|You can learn here from my own errors]].
+Then we have to start tomcat and point our browser to http://localhost:8080/infocenter/index.jsp: in my case I've installed the contents of the war file in the directory ''infocenter''.
-But alas! There is a posibility to run the infocenter as a web application. At the end, the infocenter is a web application... it would be fantastic to extract that application from eclipse and run it as an standalone application in a webserver isn't?? At the end, the security guys will be pleased for not deploy an entire eclipse into production --even if is the internal server--.
-**Such solution exists**, and better than that, is backed up by eclipse. See this:
+===== Step 2: Adding your onw data to the existing data =====
-[[http://help.eclipse.org/helios/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/ua_help_war.htm]]
+The help documentation is stored with the plugin information, under ''WEB-INF/plugins''. The infocenter software scans all the plugins for a file called ''plugin.xml'' and use the information stored in it to display one of the contents.
-I will detail here the steps I've done to achieve such a high end:
+**Adding our own content is easy:**
-I've used the eclipse helios version in a Windows XP platform. I don't if the platform affect to the result, but just to be sure....
+**3.1** Move to the plugins directory (in my case ''TOMCAT_HOME/webapps/infocenter/WEB-INF/plugins'') and create a directory for your contents:
+<code bash>
+$ mkdir com.supermanhamuerto.doc-1.0.0
+</code>
-===== To the point =====
+I've called this directory upon this website, but you can pick up whatever name you want.
-I've assumed that eclipse is installed in the directory ECLIPSE_HOME.
+**3.2** Create a ''plugin.xml'' file with the following content:
-You have to identify the version of eclipse you are running. To do so, the usual eclipse -> about eclipse. Take those "Build id:" numbers that appear. In may case are of the form "20100917-0705".
+<code xml>
+<?xml version="1.0" encoding="UTF-8"?>
+<plugin
+   name="La tortilla de patatas, ese desconocido"
+   id="com.supermanhamuerto.doc"
+   version="1.0.0"
+   provider-name="Superman Ha Muerto" >
+   <extension point="org.eclipse.help.toc">
+      <toc file="toc.xml" type="toc" primary="true" />
+   </extension>
+</plugin>
-==== Locate the resources needed ====
+</code>
-You will need to point your browser to the equinox download site: [[http://download.eclipse.org/equinox/]]. Therefore, you will have to download two files: ''org.eclipse.equinox.http.servletbridge_VERSION.jar'' and ''org.eclipse.equinox.servletbridge_VERSION.jar''. To locate those files you will have to do the following:
+Of course, the values "name", "id", "version", etc. can be configured with your own values.
-  - Locate the version of equinox sdk that more closely matches with your version of eclipse. In my case, 3.5.2, because is the only one of 2010.
+**3.3** create this ''toc.xml'' file referred in the previous section. I've put the following content:
-  - Download all the package "equinox-sdk-VERSION.zip"
-  - Unzip the contents and locate the jar files you need
-  - Reserve them for later use
-As the document says, locate the jar file "org.eclipse.help.webapp_NUMBER_VERSION.jar" in the plugins directory ECLIPSE_HOME/plugins.
+<code xml>
+<?xml version="1.0" encoding="UTF-8"?>
+<toc label="La tortilla de patatas" href='toplevel.html'>
+  <topic label="Section 1" href="section1.html"/>
+</toc>
+</code>
-Copy it to another directory and uncompress it((To uncompress, just rename it from .jar -> .jar.zip) and extract all the files)).
+Obviously, it can be more complex: http://www.gulfsoft.com/blog_new/index.php?name=News&file=article&sid=429
-You will find a directory web-archive. Under web-archive, a directory ''org.eclipse.help.infocenter-feature''.
+**3.4** And finally provide this ''toplevel.html'' and ''section1.html'' elements. They are usual html pages.
-Import it as a project in eclipse. Here are the steps, no so well commented in the eclipse documentation:
+My directory has the following files:
-  * File -> Import
+<code bash>
-  * Select "import existing project into workspace"
+~/tmp/eclipse-juno/plugins/com.supermanhamuerto.doc_1.0.0$ ls
-  * In the window that appears, select "Select root directory"
+plugin.xml  section1.html  toc.xml  toplevel.html
+</code>
-A new project will appear in you eclipse, clled org.eclipse.help.infocenter-feature.
+After this, just wait until tomcat rescans the application or simply restart tomcat again: when it's done, the infocenter will index the new content and it will appear again.
-Following the instructions, I've right-clicked on the created project and check export -> select "plug-in develpment -> deployable features". When it request a directory, select YOUR_DECOMPRESSED_JAR/web-archive/help/WEB-INF. Click on finish.
+You should see your new content by refreshing the browser:
-Now, you have to move the file ''org.eclipse.equinox.servletbridge_VERSION.jar'' to the directory ''web-archive\help\WEB-INF\lib''. If the directory "lib" doesn't exist, you have to create.
+{{ :java:20140415_infocenter2.png?direct&300 |}}
-And then, you have to move the file ''org.eclipse.equinox.http.servletbridge_1.0.100.v20090520-1800.jar'' to the ''web-archive\help\WEB-INF\plugins'' directory.
-==== Creating a WAR file ====
-All the contents under ''help'' constitute a WAR file. You can use it to deploy to whatever appserver you want. I've used jboss, and just did the following:
-  * Copy the ''help'' file under JBOSS_HOME/server/xxx/deploy and rename the directory to ''help.war''
-  * Point my browser to http://localhost:8080/help
-~~DISCUSSION~~
+~~DISQUS~~