DITA and XMetaL Discussion
XMetaL Community Forum › DITA and XMetaL Discussion › Help Portal using WebHelp
mzwecker February 16, 2010 at 10:08 am
Help Portal using WebHelpFebruary 16, 2010 at 10:08 amParticipants 4Replies 5Last Activity 13 years, 1 month ago
Goal: To build a WebHelp portal that collects a number of different product docs in one interface (each product/guide becomes a book in the navigation tree).
Apparent Solution: Make a master portal ditamap that includes each product/guide ditamap as a map reference.
Problem: We must apply a ditaval (conditions) when running the output. This means that we end up with conflicting conditions. That is, for reasons that seem self-evident, we can't choose to include all conditions when running the new “portal” ditamap.
I'm wondering if anyone else has a requirement like this and has thought of an elegant workaround.
Or perhaps there is an even more simple solution I'm overlooking.
Michaeldcramer February 16, 2010 at 1:46 pm
Reply to: Help Portal using WebHelpFebruary 16, 2010 at 1:46 pm
Have you looked at Eclipse infocenters? That would be a more flexible and full-featured way to aggregate content.mzwecker February 16, 2010 at 2:09 pm
Reply to: Help Portal using WebHelpFebruary 16, 2010 at 2:09 pm
Yes*, but let's just assume here that we want to make WebHelp do the same sort of thing.
If nothing else, JustSystems could consider this a long-term feature request (ability to build portals from DITA content).
I'm also looking at Flare (WebHelp Plus) and RoboHelp (RoboHelp Server) for building a portal, but my point is that it would be nice to have a “one-stop-shop” for making WebHelp without requiring another tool and lots of importing/exporting. I imagine I am asking too much, since I should remember that XMetaL is “graphical editor for creating and editing structured documents” and not a Magic Machine for single-source shops. Can't have everything. I chose XMetaL so we could make “pure” DITA XML. It's excellent for that. Also, I LOVE the pdf3 basic format. But I'm still suffering with my HTML/WebHelp delivery.
*The problem with Eclipse Help for us is that Eclipse Infocenter requires an Apache server and is Java-based, whereas we are very much a .NET-shop.dcramer February 16, 2010 at 5:43 pm
Reply to: Help Portal using WebHelpFebruary 16, 2010 at 5:43 pm
Infocenters require Java but not Apache. You can run it as a service (using Java Service Wrapper) or as a webapp inside of your own tomcat instance. If you can bring yourself to install Java, then running it as a service would work for you.
Good luck.Su-Laine Yeo February 20, 2010 at 1:15 am
Reply to: Help Portal using WebHelpFebruary 20, 2010 at 1:15 am
This is probably worth a try if you have a separate map file for each guide:
1) Generate WebHelp output for each guide separately, using Show/Hide Conditional Text settings that are appropriate for that guide.
2) Generate WebHelp output for the master map, including all the submaps.
3) Take the HTML files that you generated in step 1, and move them into the WebHelp output folder that you created in step 2, overwriting any existing files.
If you do this, I guess navigation should work in the output, however the Search and Index features will probably behave as if all content is unconditional.
- You must be logged in to reply to this topic.