I have read the Oxygen documentation topic "Preferences" , including the text following the heading " Preferences Directory Location ". I use Oxygen XML Author to develop documentation in DITA for two product brands. One brand requires me to install add-ons that introduce new, custom document types;...

After considering the options, including the DITA Users List (thanks for the suggestion!), I decided to ask a different, but closely related, question on Stack Overflow: "(How) does IXIASOFT CCMS support semantic URLs in HTML output?".

Hi Radu, Thanks very much for the reply and the link to your plugin. While that plugin doesn't do what I want—include SVG inline in the HTML—and in the proprietary context of my use case, I can't use a "plugin" as such—I need to define an "XSLT override"—the plugin contains a lot of XSLT that I can ...

In DITA topics, I want to refer to diagrams that are stored in external SVG files. When I use DITA-OT to transform those DITA topics into HTML5, I want the contents of those SVG files to be inline in the HTML, as opposed to being referred to by HTML img elements. For example, rather than using the D...

Hi Costin, Thanks very much for your reply. You wrote: We consider that using the ID from the root element of the topic as file name is not possible. "Not possible" is strong language! It is possible if the author takes on the responsibility of ensuring that the id attribute value of each topic is u...

Suppose: I have a set of DITA topic files that I have named descriptively. For example, abc_installing.dita (without the "ing", if you prefer; let's not digress :) ). In each case, the topic root element id attribute value matches the file name, without the file extension. For example, <task id="abc...

I am using Oxygen XML Author 22.1 to generate WebHelp Responsive output. From the Oxygen documentation topic " How to Copy Additional Resources to Output Directory ": You can copy additional resources (such as JavaScript, CSS, or other resources) to the output directory either by using an Oxygen Pub...

I was going to reply by attaching an example SVG file (with file extension .svg) generated by a DITA-OT instance to which I'd added that plugin, and then, hopefully, refer to the URL of that attachment (if I could figure it out) in an img tag in the reply, but I hit a snag: attempting to attach the ...

I'm using Oxygen XML Author 22.1 to generate WebHelp Responsive output. In general, while I've added a heap of custom CSS rules to "brand" the output, I like the default look'n'feel. However, sometimes, the output is too "tricksy", too complicated, for my liking. Take, for example, Oxygen's own " We...

Thanks! In the meantime, for any other users interested in this, and with apologies if this is stating the obvious, "one WebHelp instance per product version"—that is, all of the "publications" ("books") for a product, at a particular version, in a single WebHelp instance—might be the way to go, so ...

Thanks, Costin.

I wrote:

a check box appears next to each TOC entry

If you feel like adding another comment to that feature, an alternative approach I've seen is to simply limit the search scope to the current topic and its descendants (without all those check boxes in the TOC).

I'm using Oxygen XML Author 22.1 to generate WebHelp Responsive. The default behavior of the "Index" (index terms) button is to show the index terms page. That's fine. However, on the index terms page, the button does the same thing. That seems pointless to me; a lost opportunity. Suggestion: on tha...

I'm unsure of the easiest/best way to replace the default contents of <div class=" wh_publication_title"> with custom contents. An XSLT override for the <xsl:template match="whc:webhelp_publication_title"> in commonComponentsExpander.xsl strikes me as one way, but perhaps there's an easier way? I wa...

Hi Alin,

Thank you so much for the quick response!

As per your advice, declaring the whc namespace in the root element of the fragment fixed the problem for me:

I've hit a dead stop here. I want to specify HTML fragments, including WebHelp macros, for the "placeholder" areas. But I can't seem to do that: not via <parameter> or <fragment>, regardless of whether I use an absolute or relative path. Clutching at straws, I wondered whether specifying type="fileP...

This: <html-fragments> <fragment placeholder="webhelp.fragment.footer" file="html-fragments/webhelp_fragment_footer.html"/> </html-fragments> causes the following error while editing in Oxygen XML Author (22.1): The resource associated with the HTML fragment does not exist: file:/C:/ ... /html-fragm...

...so I thought I'd try an external fragment file: <parameter name="webhelp.fragment.footer" value="html-fragments/webhelp_fragment_footer.html"/> where html-fragments is a directory that is in the same directory as the publishing template (.opt) file. And, yes, that webhelp_fragment_footer.html fil...

After doing more reading, I realize I was probably wrong to expect that macro to work without a <whc:macro> wrapper. Even so, this: <parameter name="webhelp.fragment.footer" value="© <whc:macro value='${timestamp([Y0001])}'/> XYZ Software, Inc."/> results in the error: The prefix "whc" for elem...

In WebHelp generated by Oxygen XML Author 22.1, the following element in the publishing template: <parameter name="webhelp.fragment.footer" value="© ${timestamp([Y0001])} XYZ Software, Inc."/> results in a footer with that text, but with the macro call as-is, unexpanded. Am I doing something wr...

For what it's worth, please add my vote to this feature request. I have used publishing platforms where, if you click a "set search scope" widget, a check box appears next to each TOC entry. Selecting or deselecting a check box automatically selects or deselects the check boxes of descendant items. ...

Understood, thanks. In the meantime, how about an Oxygen blog post demonstrating how to create a search page that searches the indexes of multiple instances of Oxygen WebHelp Responsive? Such a multi-WebHelp search would be one of the key components of a multi-product documentation portal. That, com...

I would like keyboard shortcuts for the previous and next topic links in WebHelp Responsive. Perhaps WebHelp already supports such keyboard shortcuts? If so, I haven't found any corresponding documentation. I understand that, while this might be a simple request to state, the implementation is not n...

Related suggestions: Introduce facet-based filters to the WebHelp "index terms" ("A-Z" index) page. For example, to show/hide index terms by facet. Introduce facet-based filters to the WebHelp TOC. For example, to show/hide (or, to avoid structural discontinuities, highlight/dim ) TOC entries by fac...

Thanks again Belinda! My situation (I'd rather not get too specific, with too much detail): I currently use the standalone Oxygen XML Author Windows desktop application with source files in Git, with the remote Git repositories hosted by Atlassian Bitbucket Server. I'm productive in that environment...

Hi Belinda, Thank you so much for your reply here on this Oxygen forum. It's good to know, as you wrote, that IXIASOFT CCMS Desktop supports search and replace across the topics in a map. I was wrong, and I'm relieved to hear it. Where I went wrong For what it's worth, I can see where I went wrong. ...

If you want to improve the standing of Oxygen WebHelp in a feature comparison matrix with other web publishing platforms, you might consider enhancing it with facet-based search, based on <topicmeta> and <topicsubject> DITA elements.

We have plans to approach such portal-like functionality in a future WebHelp release

Any update on this? No worries if not, but I'm curious.

I'm familiar with, and value the rich features of, the "standalone" Oxygen XML Author Windows desktop application. I'm aware of, but I have not used, the Oxygen XML Author Eclipse Plugin and Oxygen XML Web Author. I have studied the Oxygen XML Feature Matrix . I have read about, but have not used, I...

That circa-2004 link to the IXIASOFT website is dead (page not found). In 2020, then: if I am licensed to use the Oxygen Eclipse plugin (for example, with IXIASOFT CCMS), then am I automatically also licensed to use the Oxygen XML Author Windows desktop application? For example, suppose I need to us...

Thanks very much for the reply. I value the rich feature set of the standalone Oxygen XML Author Windows application. Your reference to content management systems resonates with me. I've been reading about IXIASOFT CCMS. I gather that Oxygen XML Web Author is integrated with IXIASOFT CCMS Web , and ...