Skip to main content
This topic has been closed for replies.

1 reply

N
namedujour
Inspiring
August 1, 2013

Can someone please help me parse through these instructions? I don't know what they're saying. I have a "Recent Updates" page that I need to publish as XML in order for our web developer to capture the new topic names and links, and display them in an Announcement bar on our website. Reading this, I have no idea what to do:

Select Output Folder And File Name -- I have an existing project. It's already set. Or is there some reason they're telling me to do this again?

Name and location of output files. -- Ditto

Conditional Build Expression: Click Define to specify conditional build expressions. -- Is this a necessary step? Must I create a conditional build expression to publish in XML? Why?

Select Export Handler: Advanced options include the following: -- Where is the Export Handler feature? It isn't anywhere on the Webhelp Settings dialog with the other options they're having me set. Oh wait. I just found it on the menu under Tools. (It would be really helpful to actually have that in the step!)

Export Project To DocBook Exports the entire XML project to DocBook format.

Export Topics To DocBook Exports only the topics to DocBook format. -- Which of these do I want to select? What in the heck is a DocBook export? Is it going to convert my topic to XML? Why doesn't anything happen when I select this option? Have I messed anything up by selecting it?

Export Project To XHTML Exports the XML project to XHTML format. All topics are converted to XHTML files. -- It's not an XML project. I just want one XML topic. HOW DO I GET ONE? Why are the instructions telling me this?

I'm a technical writer, and this topic has some serious flaws. It isn't even a help topic - it's a series of random, unrelated notes. I can't do anything at this point, except ponder my confusion.

Jeff_Coatsworth
Community Expert
Jeff_CoatsworthCommunity Expert
Community Expert
August 1, 2013

The page is presuming you know how to generate help out of your RH project using the Single Source Layouts (SSL). It’s a reference page describing each of the options in the XML SSL recipe. You can’t just get 1 page exported, you need to do all topics.

Output - You get options about where to create the help files and what it’s going to be called. If you’re happy with the defaults, just let it be.

CBT – if you don’t use CBTs to create multiple flavours of help output, then don’t define anything.

Export Handler – you probably don’t need any of this – DocBook is an industry standard in structured writing (like DITA).

N
namedujour
Inspiring
August 1, 2013

Nowhere in this topic does it tell me how to generate as XML. Output Generation Basics doesn't tell me either. I can try generating the entire project as XML and see how that works, but the instructions and the interface suggest that I can select either "a topic" OR "the entire project," which is why I found them misleading. Plus they don't tell me what to do; they just show me where I've been.

There isn't an option on Webhelp Settings for XML output. Any ideas on where I find it? And what I do with it when I get there?

Wait a minute. So I look around again, and notice the XML Output single source layout. I apparently have to create a separate single source layout using this, and ditch the Webhelp single source layout. That's just a guess. I'll try that.

Terms & ConditionsAccessibility statement
Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices