Search found 48 matches
- 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: 190
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, custom document types;...
- 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: 404
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?".
- Mon Nov 16, 2020 5:22 pm
- Forum: DITA (Editing and Publishing DITA Content)
- Topic: Including SVG inline in html5 output?
- Replies: 2
- Views: 229
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 ...
- Mon Nov 16, 2020 12:06 pm
- Forum: DITA (Editing and Publishing DITA Content)
- Topic: Including SVG inline in html5 output?
- Replies: 2
- Views: 229
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...
- 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: 404
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...
- 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: 404
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...
- 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: 245
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...
- Wed Sep 30, 2020 8:29 am
- Forum: DITA (Editing and Publishing DITA Content)
- Topic: Syntax diagrams in SVG
- Replies: 3
- Views: 502
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 ...
- 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: 272
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...
- 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: 1168
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 ...
- Thu Sep 24, 2020 7:26 am
- Forum: DITA (Editing and Publishing DITA Content)
- Topic: Search scope
- Replies: 5
- Views: 628
Re: Search scope
Thanks, Costin.
I wrote:
I wrote:
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).a check box appears next to each TOC entry
- 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: 267
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...
- 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: 295
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...
- 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: 475
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:
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">© <whc:macro value="${timestamp([Y0001])}"/> XYZ Software, Inc.</div>
- 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: 475
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...
- 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: 475
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...
- 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: 475
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...
- 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: 475
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...
- 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: 475
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...
- Tue Sep 22, 2020 4:25 pm
- Forum: DITA (Editing and Publishing DITA Content)
- Topic: Search scope
- Replies: 5
- Views: 628
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. ...
- 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: 1168
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...
- Tue Sep 22, 2020 6:40 am
- Forum: Feature Request
- Topic: Keyboard shortcuts in WebHelp Responsive: e.g. prev/next topic
- Replies: 1
- Views: 457
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...
- Tue Sep 22, 2020 6:03 am
- Forum: Feature Request
- Topic: Facet-based search in WebHelp based on <topicmeta> and <topicsubject>
- Replies: 3
- Views: 475
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...
- 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: 532
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...
- 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: 532
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. ...
- Tue Sep 15, 2020 12:04 pm
- Forum: Feature Request
- Topic: Facet-based search in WebHelp based on <topicmeta> and <topicsubject>
- Replies: 3
- Views: 475
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.
- 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: 1168
Re: Oxygen WebHelp-based site for an enterprise's entire set of products?
Any update on this? No worries if not, but I'm curious.We have plans to approach such portal-like functionality in a future WebHelp release
- 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: 532
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...
- Mon Sep 14, 2020 12:03 pm
- Forum: Other Issues
- Topic: Oxygen vs Eclipse
- Replies: 3
- Views: 1234
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...
- 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: 413
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 ...