Search found 50 matches

by Graham Hannington
Wed Aug 24, 2022 12:07 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Syntax diagrams in SVG
Replies: 6
Views: 2167

Re: Syntax diagrams in SVG

I've published the map to HTML5 and the SVG was generated Works for me, too! About the output, though... I run the following command from a Windows command prompt, in the directory containing the input syntax.dita file, using DITA-OT (3.7.2) with the svg-syntaxdiagrams (2.0) plugins to build html5:...
by Graham Hannington
Wed Apr 27, 2022 6:00 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Including SVG inline in html5 output?
Replies: 3
Views: 1463

Re: Including SVG inline in html5 output?

Hi Radu, I'm revisiting this issue after a couple of years. And, as you've no doubt noticed by my multiple edits to this post, I've been on a learning curve over the last few days. I realize now that what I thought might be an issue with your plugin is actually my problem . :) Still, I'm hoping you ...
by Graham Hannington
Thu Jan 14, 2021 10:12 am
Forum: DITA (Editing and Publishing DITA Content)
Topic: Can users specify the location of the preferences file used by Oxygen XML Author?
Replies: 1
Views: 808

Can users specify the location of the preferences file used by Oxygen XML Author?

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, cu...
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: 5
Views: 1877

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: 3
Views: 1463

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...
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: 3
Views: 1463

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: 5
Views: 1877

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 ...
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: 5
Views: 1877

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, <ta...
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: 925

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

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: 893

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 exampl...
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: 2909

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

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: 829

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. Suggesti...
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: 922

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...
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: 1783

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: <div xmlns:whc="http://www.oxygenxml.com/webhelp/components">&#xA9; <whc:macro value="${timestamp([Y0001])}"/> XYZ ...
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: 1783

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 t...
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: 1783

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:...
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: 1783

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_frag...
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: 1783

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="&#xA9; &lt;whc:macro value='${timestamp([Y0001])}'/> XYZ Software, Inc."/> results in the e...
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: 1783

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="&#xA9; ${timestamp([Y0001])} XYZ Software, Inc."/> results in a footer with that text, but with the macro call as-is, unexpanded....
by Graham Hannington
Tue Sep 22, 2020 4:25 pm
Forum: DITA (Editing and Publishing DITA Content)
Topic: Search scope
Replies: 6
Views: 2251

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 descenda...
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: 2909

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: 1348

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: 7
Views: 2576

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 ...
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: 1687

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: 1687

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: 7
Views: 2576

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: 2909

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: 1687

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 n...