- oXygen-user - www.oxygenxml.com

Re: [oXygen-user] Compiling external HTML resources upon transform to CHM
by Radu Coravu 28 Sep '10

28 Sep '10

Hi Khaled, For DITA publishing Oxygen just runs an external ANT process on the DITA Open Toolkit. You will have to make modifications to the ANT build files in order to copy additional non-DITA resources to the output folder. Then, if the resources are in the output folder they should be incorporated in the CHM. Regards, Radu Radu Coravu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger http://www.oxygenxml.com On 9/28/2010 6:37 PM, Khaled Aly wrote: > Hi Radu > > Actually the html together with the common css and img folders resources > are placed outside both dita source and output files. They are > referenced via related-links > link element. This worked well for the > html since they need not be copied in this case (just referenced), but > when transforming to chm they cannot be compiled and that is normal > since they are not copied. So I was wondering if there is an oXygen > parameter to let the chm transformation scenario copy them and compile > them, or should this be done in the build file? > > Thanks & regards, > Khaled > > Technopsis.com > ICT Research & Documentation > Desk: +20 (0)2 2415 4164 > Mobile: +20 (0)12 294 6280 > Skype:ka.aly > > On 9/28/2010 1:36 PM, Radu Coravu wrote: >> Hi Khaled, >> >> So, if from the DITA Topic you refer to the HTML file like: >> <xref href="documentation.html" format="html"/> >> and the file is copied placed in the output folder relative to the >> DITA Topic which references it, then if you build the CHM it should >> incorporate inside also the html file. >> >> Regards, >> Radu >> >> Radu Coravu >> <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger >> http://www.oxygenxml.com >> >> >> On 9/27/2010 1:13 PM, Khaled Aly wrote: >>> Hello oXygen users >>> >>> I had a problem getting the oXygen generated html documentation of XSL >>> files to be copied to output folder, being referenced from a link >>> element within a glossentry topic. I got over this by placing the shared >>> resources in a folder that's external to both dita source and output. >>> When transforming to chm, the html file referenced was not compiled and >>> hence could not be displayed in html help. >>> >>> Is there any oXygen transformatio nmenu parameter that could be set (or >>> added to be set) to enable chm to compile html resources that are >>> external to the transformation output folder? >>> >>> Thanks& regards, >>> Khaled >>> >> >>

1 0

Compiling external HTML resources upon transform to CHM
by Khaled Aly 28 Sep '10

28 Sep '10

Hello oXygen users I had a problem getting the oXygen generated html documentation of XSL files to be copied to output folder, being referenced from a link element within a glossentry topic. I got over this by placing the shared resources in a folder that's external to both dita source and output. When transforming to chm, the html file referenced was not compiled and hence could not be displayed in html help. Is there any oXygen transformatio nmenu parameter that could be set (or added to be set) to enable chm to compile html resources that are external to the transformation output folder? Thanks & regards, Khaled -- Technopsis.com ICT Research & Documentation Desk: +20 (0)2 2415 4164 Mobile: +20 (0)12 294 6280 Skype:ka.aly

2 1

Making the XInclude switch more accessible
by Wendell Piez 24 Sep '10

24 Sep '10

Hi, As you know I've been using XInclude more intensively for a couple of projects. I'm grateful for oXygen's settings, including the setting to switch XInclude on and off per project. However, sometimes one wants to turn it on or off even more readily, for example before running a transformation or Schematron validation. Since the settings are fairly deep in the XML/XML Parser pane of Options/Preferences, this is a bit hard to do (and to instruct others to do). What would be great would be buttons to control this, and/or menu options, available at the top level. Maybe those are already there and I just haven't found them? Any ideas? Cheers, Wendell ====================================================================== Wendell Piez mailto:wapiez@mulberrytech.com Mulberry Technologies, Inc. http://www.mulberrytech.com 17 West Jefferson Street Direct Phone: 301/315-9635 Suite 207 Phone: 301/315-9631 Rockville, MD 20850 Fax: 301/315-8285 ---------------------------------------------------------------------- Mulberry Technologies: A Consultancy Specializing in SGML and XML ======================================================================

3 3

New Split Behavior: Very Nice
by Eliot Kimber 23 Sep '10

23 Sep '10

The new split behavior, where it behaves like insertion of a new element of the same type, is very nice. Thanks! Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

1 0

Minor Annoyance: Unable to Force Map Document into Map Manager
by Eliot Kimber 21 Sep '10

21 Sep '10

In RSuite all documents are provided to WebDAV clients with an extension of ".xml". Thus if I open a DITA map Oxygen opens it in the editor window, not the map manager. Having done that I couldn't find a way to put the document in the map manager--I had hoped that I could just drag the tab from the editor pane to the map manager but that doesn't appear to be implemented. Likewise, the Map Manager doesn't have its own Open URL button so I couldn't get there by that route. Would it be possible/sensible to allow map documents to be dragged from the editing view to the Map Manager? Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

2 1

The New File->New Dialog Not Cutting It
by Eliot Kimber 20 Sep '10

20 Sep '10

I'm finding the new File->New dialog to be must less convenient than the old one. One issue I have is that I have many different "templates" directories. I carefully name my template documents so they sort together, e.g, "D4P - Chapter.dita", "D4P - Article.dita", etc. That works really well in the flat list of templates. I tend to organize my templates by type within a containing directory named "templates": templates/topics, templates/maps, templates/word, templates/indesign, etc. In Oxygen 11 I could point to the ancestor templates directory and everything just worked. Very convenient. But in the new system, each containing directory is reflected in the New File tree, so I get a lot of "templates" entries under the Global Templates item, with no way to distinguish which project a given templates directory is for. Short of bringing back the old dialog, I think an easy fix would be to make Global Templates a flat list like the old dialog. Otherwise I can't think of any easy change that would make the new dialog behave usefully with the way I currently have my templates organized. One of the nice aspects of the old template mechanism was it meant that I didn't have to have a templates/ directory that was designed specifically for Oxygen, since the use of Oxygen is as much for my own convenience as it is for my clients. That is, I want my "templates" directory to be the holder for any kind of template for any tool or purpose for which templates is useful, not a specific "Oxygen templates" directory. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

2 6

Missed Regular Expression checkbox in oXygen 12
by Peter Stadler 20 Sep '10

20 Sep '10

I just upgraded to oXygen 12 and missed the "Regular Expression" checkbox at the "Find/Replace in Files" dialog. Well, activating the help showed that it must be there and wasn't removed. At the end, I simply had to resize the dialog window and it showed up (together with the "include hidden files" checkbox) but nevertheless I think the user should be given some sort of hint that there are more options available ... (oXygen 12 (german) build 2010091411, MacOS 10.5) Peter -- Peter Stadler Carl-Maria-von-Weber-Gesamtausgabe Arbeitsstelle Detmold Gartenstr. 20 D-32756 Detmold Tel. +49 5231 975-665 Fax: +49 5231 975-668 stadler at weber-gesamtausgabe.de www.weber-gesamtausgabe.de

2 1

Analyzing Map Validation Logs
by Eliot Kimber 17 Sep '10

17 Sep '10

I tested the new map validation feature by validating the full DITA 1.2 spec map, which is about as large a map as most people will have. The resulting validation large was long and includes a number of messages I know I can ignore, or least don't want look at. So to focus on specific errors here's what I did: 1. In the message result window I right clicked and did "Save results as XML". 2. Opened the XML file in Oxygen and applied the pretty print to it (so it would be easier to read). 3. Looked for distinguishing text in the message descriptions I wanted to ignore and then used this XPath to find all messages that didn't have those bits in their description: //incident[not(contains(description, 'subset')) and not(contains(description, 'key reference'))] This produces a list of <incident> elements in the XQuery result list. I then just selected each search result in turn and it took me right to the log message I cared about. I could then use the "Open file at cursor" feature to open the file in question. Took me about 5 minutes to find and fix about 10 bad links scattered throughout several hundred topics and a number of maps. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

4 6

New topicref insert dialog
by Eliot Kimber 17 Sep '10

17 Sep '10

I'm editing a map with a *lot* of topicref types (the PubMap domain from D4P). Because the new insert topicref dialog lists the topicref types first, this has the effect of forcing the "reference to currently-edited file" choice to the bottom of the list, which is a bit annoying. At least for myself, I almost always write a topic and then add it to the map, so reference to currently-edited file is the choice I almost always want. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

3 5

OSX: Cannot Launch Oxygen from Eclipse After Install
by Eliot Kimber 17 Sep '10

17 Sep '10

Under OSX I renamed my Oxygen 11.2 install from "oxygen" to "oxygen_11.2" then unpackaged the tar.gz for Oxygen 12 and moved the resulting "oxygen" dir to my Applications directory. I was then able to start Oxygen fine and verify that v12 started. However, from Eclipse, when I try to open a file in Oxygen by navigating to the Oxygen.app icon in the "Choose external application" dialog, the icon shows as a text file, not an application, after I choose it, and trying to run it gives a failure with this detail message: Error opening external editor (/Applications/oxygen/Oxygen.app). Cannot run program "/Applications/oxygen/Oxygen.app": error=13, Permission denied Any idea what the cause might be? I don't remember having this problem in the past. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

2 1