Search found 47 matches

by Graham Hannington
Tue Nov 24, 2020 7:17 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Output HTML file names that are different from the source DITA topic file names?
Replies: 4
Views: 189

Re: Output HTML file names that are different from the source DITA topic file names?

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?".
by Graham Hannington
Mon Nov 16, 2020 5:22 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Including SVG inline in html5 output?
Replies: 2
Views: 79

Re: Including SVG inline in html5 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 ...
by Graham Hannington
Mon Nov 16, 2020 12:06 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Including SVG inline in html5 output?
Replies: 2
Views: 79

Including SVG inline in html5 output?

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...
by Graham Hannington
Sun Oct 18, 2020 4:05 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Output HTML file names that are different from the source DITA topic file names?
Replies: 4
Views: 189

Re: Output HTML file names that are different from the source DITA topic file names?

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...
by Graham Hannington
Fri Oct 16, 2020 9:54 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Output HTML file names that are different from the source DITA topic file names?
Replies: 4
Views: 189

Output HTML file names that are different from the source DITA topic file names?

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...
by Graham Hannington
Tue Oct 06, 2020 9:01 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Relative folder path for webhelp.custom.resources parameter in a publishing template?
Replies: 1
Views: 135

Relative folder path for webhelp.custom.resources parameter in a publishing template?

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...
by Graham Hannington
Wed Sep 30, 2020 8:29 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Syntax diagrams in SVG
Replies: 3
Views: 341

Re: Syntax diagrams in SVG

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 ...
by Graham Hannington
Fri Sep 25, 2020 7:14 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Omitting permalinks and collapsibility of sections from WebHelp Responsive
Replies: 1
Views: 163

Omitting permalinks and collapsibility of sections from WebHelp Responsive

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...
by Graham Hannington
Thu Sep 24, 2020 1:12 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Oxygen WebHelp-based site for an enterprise's entire set of products?
Replies: 7
Views: 838

Re: Oxygen WebHelp-based site for an enterprise's entire set of products?

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 ...
by Graham Hannington
Thu Sep 24, 2020 7:26 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Search scope
Replies: 5
Views: 412

Re: Search scope

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).
by Graham Hannington
Thu Sep 24, 2020 5:52 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: WebHelp Responsive: behavior of Index (terms) button on index terms page
Replies: 1
Views: 166

WebHelp Responsive: behavior of Index (terms) button on index terms page

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...
by Graham Hannington
Wed Sep 23, 2020 6:36 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Easiest way to specify custom <div class="wh_publication_title"> in WebHelp Responsive?
Replies: 1
Views: 195

Easiest way to specify custom <div class="wh_publication_title"> in WebHelp Responsive?

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...
by Graham Hannington
Wed Sep 23, 2020 6:27 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Re: Macro not expanded in webhelp.fragment.footer

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:

Code: Select all

<div xmlns:whc="http://www.oxygenxml.com/webhelp/components">&#xA9; <whc:macro value="${timestamp([Y0001])}"/> XYZ Software, Inc.</div>
by Graham Hannington
Wed Sep 23, 2020 5:02 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Re: Macro not expanded in webhelp.fragment.footer

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...
by Graham Hannington
Wed Sep 23, 2020 4:36 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Re: Macro not expanded in webhelp.fragment.footer

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...
by Graham Hannington
Wed Sep 23, 2020 4:24 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Re: Macro not expanded in webhelp.fragment.footer

...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...
by Graham Hannington
Wed Sep 23, 2020 3:33 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Re: Macro not expanded in webhelp.fragment.footer

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...
by Graham Hannington
Wed Sep 23, 2020 1:02 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Macro not expanded in webhelp.fragment.footer
Replies: 6
Views: 252

Macro not expanded in webhelp.fragment.footer

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...
by Graham Hannington
Tue Sep 22, 2020 4:25 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Search scope
Replies: 5
Views: 412

Re: Search scope

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. ...
by Graham Hannington
Tue Sep 22, 2020 4:18 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Oxygen WebHelp-based site for an enterprise's entire set of products?
Replies: 7
Views: 838

Re: Oxygen WebHelp-based site for an enterprise's entire set of products?

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...
by Graham Hannington
Tue Sep 22, 2020 6:40 am
Forum: Feature Request
Topic: Keyboard shortcuts in WebHelp Responsive: e.g. prev/next topic
Replies: 1
Views: 266

Keyboard shortcuts in WebHelp Responsive: e.g. prev/next topic

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...
by Graham Hannington
Tue Sep 22, 2020 6:03 am
Forum: Feature Request
Topic: Facet-based search in WebHelp based on <topicmeta> and <topicsubject>
Replies: 3
Views: 215

Re: Facet-based search in WebHelp based on <topicmeta> and <topicsubject>

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...
by Graham Hannington
Fri Sep 18, 2020 8:41 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS environment?
Replies: 4
Views: 385

Re: Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS environment?

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...
by Graham Hannington
Wed Sep 16, 2020 6:23 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS environment?
Replies: 4
Views: 385

Re: Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS 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. ...
by Graham Hannington
Tue Sep 15, 2020 12:04 pm
Forum: Feature Request
Topic: Facet-based search in WebHelp based on <topicmeta> and <topicsubject>
Replies: 3
Views: 215

Facet-based search in WebHelp based on <topicmeta> and <topicsubject>

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.
by Graham Hannington
Tue Sep 15, 2020 11:52 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Oxygen WebHelp-based site for an enterprise's entire set of products?
Replies: 7
Views: 838

Re: Oxygen WebHelp-based site for an enterprise's entire set of products?

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.
by Graham Hannington
Mon Sep 14, 2020 5:13 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS environment?
Replies: 4
Views: 385

Find and replace in the current ditamap with Oxygen in an IXIASOFT CCMS environment?

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...
by Graham Hannington
Mon Sep 14, 2020 12:03 pm
Forum: Other Issues
Topic: Oxygen vs Eclipse
Replies: 3
Views: 1030

Re: Oxygen vs Eclipse

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...
by Graham Hannington
Fri Sep 11, 2020 6:47 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Oxygen XML editor feature comparison: Standalone, Web, Eclipse
Replies: 3
Views: 290

Re: Oxygen XML editor feature comparison: Standalone, Web, Eclipse

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 ...
by Graham Hannington
Fri Sep 11, 2020 12:13 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Oxygen XML editor feature comparison: Standalone, Web, Eclipse
Replies: 3
Views: 290

Oxygen XML editor feature comparison: Standalone, Web, Eclipse

I'm familiar with, and like, 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 . The matrix row for "Find and replace in all project files" in...