September 2010 - oXygen-user - www.oxygenxml.com

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

How to Keep Oxygen from Opening Epubs on OSX?
by Eliot Kimber 16 Sep '10

16 Sep '10

I use Oxygen to run the EPUB generation plugin for the Toolkit. I have it configured to "open in browser", which should launch the EPUB in Adobe Digital Editions, but it looks like Oxygen took over the EPUB association so the EPUB opens in Oxygen rather than ADE. I tried using Open... In Finder to make ADE the default opener again but it didn't seem to take. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

4 5

Easy Way to Delete Entire Elements Using Map-Based Search and Replace?
by Eliot Kimber 16 Sep '10

16 Sep '10

I have the situation where I want to delete elements in a bunch of topics where I can reliably find the elements (e.g., via XPath or regex). But there doesn't appear to be an obvious way to do this. Have I missed something? In my particular case the elements involved will have attributes with unique values or will span multiple lines. Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

3 2

Using Other Toolkits with Oxygen 12
by Eliot Kimber 16 Sep '10

16 Sep '10

Should I be able to swap in different Toolkit distributions with Oxygen 12? I tried swapping in the one I was using 11.2, which is the 1.5.2M4 with a lot of plugins added. That failed when I tried to use it from Oxygen 12 with a method-not-found error related to the Xerces grammar caching. I didn't have time to track down the issue at the moment so I just restored the Toolkit as installed. But I'm wondering if the the Toolkit in 12 is more heavily customized and so can't just be swapped out? Cheers, E. -- Eliot Kimber Senior Solutions Architect "Bringing Strategy, Content, and Technology Together" Main: 512.554.9368 www.reallysi.com www.rsuitecms.com

2 2

Default Setting for " Enable DTD/XML Schema processing in document type detection"
by Eliot Kimber 13 Sep '10

13 Sep '10

I noticed that the Enable DTD/XML Schema processing in document type detection setting in Document Type Associations is not on by default. Is there any reason that the default shouldn't be that this is on with "Only for local DTDs" also turned on? I ask because I set up a new dev environment for a client and it took me a while to figure out why Oxygen wasn't recognizing her specialized topics as DITA even though I had deployed the document types to Oxygen's Toolkit. I finally remembered this setting and turned it on, but it seems like it would be useful to have it on by default so that DITA processing in particular is more likely to just work. 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

Reversing an SVN ignore
by Stephen Matlock 10 Sep '10

10 Sep '10

This isn't really an Oxygen/DITA request, but since Subversion is included in Oxygen, here goes: I use SVN to check out/in my content. Oxygen usually creates a TMP and an OUT folder. Generally these folders contain content I don't need, so I ignore them using the SVN:ignore command in Subversion. But one of my co-writers checked in the content in the OUT folder for one of the projects, and I need that content. How do I reverse the SVN:ignore on a folder? I checked online & wasn't able to find anything useful or that made sense. I looked through some of the files in the .SVN folder, but I don't see anything that makes sense that I could edit to undo this.

3 4