August 2008 - oXygen-user - www.oxygenxml.com

DITA Feature Request -- Insert href to files
by Seraphim Larsen 27 Aug '08

27 Aug '08

It would be nice to have a better method for inserting the hrefs for <xref>, <link>, <conref>, and <image>. As far as I can tell, the current feature set allows you to insert these elements, but then you need to hand-code the href. Would be nice to have a dialog box that allows you to select the target file -- for example, something like the way you can currently insert conrefs. Even nicer, it would be great to be able to drag-and-drop from the Project pane. For example, drag a topic file, and drop into an open DITA file (in Text or Author view), and an xref is inserted. Ctrl-drag, and a Related Link is inserted. Drag a graphic, and an <image> element is inserted, with the href already correctly defined. To get an xref to a particular element, it would be nice to have a feature something like this: - Select the target element - Select menu item "Create xref to target element", which results in the following: - If the selected element has no id attribute, an id attribute is created, or a dialog box opens, telling the user to specify the id attribute - The clipboard is then populated with the <xref> element with the href already correctly defined. - An optional dialog box could appear, telling the user that the xref has been formed and is on the clipboard - You then go to the place where you want to put the xref, and just paste it in. - Oxygen should adjust the syntax of the href, depending on where the user pastes it in. This would not just be a simple copy-paste, but would require some additional intelligence from Oxygen: - If the xref is pointing to content in the same file, the following syntax is used (as per the DITA Language Spec<http://docs.oasis-open.org/dita/v1.1/OS/langspec/langref/xref.html#xref__at…> ): href="#topicID" href="#topicID/elemID - If the xref target is in a different file: href="filename.dita#topicID" href="fname.dita#topicID/elemID" It would be nice to have similar copy/paste functionality for conrefs. Much easier than navigating through a dialog box. Thanks, Seraphim On Mon, Jun 2, 2008 at 11:16 PM, Radu Coravu <radu_coravu(a)sync.ro> wrote: > Hi, > > We will study implementing this request for a future version. > > Regards, > Radu > > -- > Radu Coravu <oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger > http://www.oxygenxml.com > > > Eliot Kimber wrote: > >> On 6/2/08 3:23 PM, "Seraphim Larsen" <seraphim37(a)gmail.com> wrote: >> >> >> >>> It would also be nice if the dialog box for inserting topicrefs would >>> stay >>> open after inserting each ref. That way you can keep inserting refs till >>> you're done, rather than needing to open the dialog box every single time >>> you add a new ref. Serna has this behavior and it's much easier to work >>> with, in my opinion. >>> >>> >> >> I agree--it's quite nice for organizing a set of existing topics into a >> new >> navigation hierarchy. >> >> Cheers, >> >> Eliot >> >> >> > > >

3 3

Re: [oXygen-user] Validation log file
by Wendell Piez 27 Aug '08

27 Aug '08

Jenny, At 03:45 PM 8/26/2008, you wrote: >I use the "validate with" function in Project to validate multiple >files by our schema. >But I don't know how to format the validation log to save it in one >file, with the format like this: >File name, description, location in one line. > >Now I copied what in the Batch Validation error and paste in Excel, >but for one record there are four line of the error message: > >Does anyone know how to set up the format of the log file? While I haven't done this (and don't know how it can be done) I have successfully post-processed oXygen log files using XSLT 2.0. This isn't beginner-level code, but it is capable of making your logs into pretty much whatever you like. I think I remember suggesting that oXygen export its reports in an XML format, which could then be post-processed much more easily, but if so that feature request is still in the pipeline. (And if not, I hereby make the suggestion.) 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 ======================================================================

2 1

Validation log file
by Jing, Jenny 26 Aug '08

26 Aug '08

Hi, All: I use the "validate with" function in Project to validate multiple files by our schema. But I don't know how to format the validation log to save it in one file, with the format like this: File name, description, location in one line. Now I copied what in the Batch Validation error and paste in Excel, but for one record there are four line of the error message: Does anyone know how to set up the format of the log file? Thanks. Jenny

1 0

Re: [oXygen-user] DITA Feature Request -- Insert href to files
by Seraphim Larsen 26 Aug '08

26 Aug '08

How do you trigger the file chooser? I don't see any options for doing that. Thanks! Seraphim On Fri, Aug 22, 2008 at 3:13 PM, Eliot Kimber <ekimber(a)reallysi.com> wrote: > On 8/22/08 3:34 PM, "Seraphim Larsen" <seraphim37(a)gmail.com> wrote: > > > It would be nice to have a better method for inserting the hrefs for > <xref>, > > <link>, <conref>, and <image>. > > From the attribute editor you can use a file chooser to choose the target > for the href and Oxygen will automatically create the appropriate relative > path. > > Not quite as convenient as you're asking for, but better than typing by > hand. > > Cheers, > > Eliot > > ---- > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc. > email: ekimber(a)reallysi.com <mailto:ekimber@reallysi.com> > office: 610.631.6770 | cell: 512.554.9368 > 2570 Boulevard of the Generals | Suite 213 | Audubon, PA 19403 > www.reallysi.com <http://www.reallysi.com> | http://blog.reallysi.com > <http://blog.reallysi.com> | www.rsuitecms.com <http://www.rsuitecms.com> > >

2 1

RFE: Ability to select browser for previewing x/html files
by Hedley Finger 26 Aug '08

26 Aug '08

I have mainly been using <oXygen/> for DITA work but have recently started developing some web pages. It is surprising that you can only specify one browser for previewing x/html files. Most editors allow you to specify several browser which are automatically added to a "View in Browser >>" cascading menu item. Can we expect this improvement soon as it seems to me to be a trivial enhancement? Regards, Hedley -- Hedley Finger 28 Regent Street Camberwell VIC 3124 Australia Tel. +61 3 9809 1229 Fax. (call phone first) Mob. (cell) +61 412 461 558 Email. "Hedley Finger" <hfinger(a)handholding.com.au>

2 1

entering unicode characters
by Philipp Steinkrüger 26 Aug '08

26 Aug '08

Hello, trying to find out whether Oxygen is capable of inserting unicode characters the same way Word does (i.e. giving the character code directly, without using any visual character map or something...) I found a reply from Sorin to the same question asked by someone in September 2006. Sorin then said: You cannot enter the code of the character, for example \uB031 because that is not supported in the current version of <oXygen/> but it is planned for a future version. Two years later, the manual of the current version still shows no sign of this functionality being added, but maybe it has been added silently (because it's really a shame that the only way to enter unicode characters is the character map and code-templates), which I hope. Maybe someone can give me more information on this? Thanks, Philipp -- Philipp Steinkrüger M.A. Philosophisches Seminar der Universität zu Köln - Thomas-Institut - Universitätsstraße 22 50923 Köln Fon +49 221 4702394 Fax +49 221 4705011 philipp.steinkrueger(a)uni-koeln.de http://www.philosophie.uni-koeln.de http://www.thomasinstitut.uni-koeln.de UNIVERSITÄT ZU KÖLN GUTE IDEEN. SEIT 1388.

2 1

feature request: copy file path
by Lars Huttar 22 Aug '08

22 Aug '08

Hello, I have a feature request: When I'm editing a file in Oxygen, often I need to go find that file in another application (such as Windows Explorer, or WinMerge, etc.). If the file has a long path, it takes a while to re-find it. Right now, the file's full path shows up in the Oxygen title bar, and in the tooltip for the editor buffer tab, but there is no apparent way to copy it to the clipboard. It would be very convenient to have a "Copy Path" or "Copy File Path" command on the right-click menu of the editor buffer tab, the red-circled area in the screenshot below. That way, the user does not have to re-navigate to a deeply-buried file. editor buffer tab Thanks, Lars

3 3

Intelligent editor support for DITA specialisations
by Hedley Finger 20 Aug '08

20 Aug '08

One of the advantages of DITA that was loudly proclaimed is that specialised topic files from one creator can be sent to another user and inserted into a document /without the specialised DTD being made available to that user/. The DITA OT will then produce some sort of readable (if badly formatted) output based on the parent element identified in the @class attribute. But it appears that none of the DITA-out-of-the-box editors which I have support specialisation in the absence of the specialisation DTD but barf in various interesting ways. Serna alone appears to make some attempt to support specialised elements. I have made a tiny tweak to <fig> to specialise it with a <credit> element based on , and an <anchor> element based on . This are subclassed in the approved manner, e.g. class=" topic/p topic/credit". It seems to me that a DITA editor on opening an unknown specialisation should be able to look at the inheritance tree in @class and temporarily rename the element to the nearest known ancestor. And, on save, it should write out the XML with the original element name restored from the leaf value in @class. As DITA is not a true object model and subclasses are merely renaming of ancestor elements for better semantic cueing, this does not appear to be a very difficult problem to solve. Anything would be better than the endless bleatings of Xalan error messages! I am basing my remarks on experience with Syntext Serna, <oXygen/>, XMLmind XML Editor (XXE), and FrameMaker v 8 with DITA-FMx 1.0. Perhaps XMetaL, Arbortext Author, and other editors already support this kind of compatibility. Regards, Hedley -- Hedley Finger 28 Regent Street Camberwell VIC 3124 Australia Tel. +61 3 9809 1229 Fax. (call phone first) Mob. (cell) +61 412 461 558 Email. "Hedley Finger" <hfinger(a)handholding.com.au>

1 0

Re: Whitespace Problem
by Philipp Steinkrüger 15 Aug '08

15 Aug '08

Hi, thanks for your answer, Sorin. I understand Oxygen Author-Mode is not able to do what i want, but i think it should be! There should be an option telling the renderer to just ignore line-breaks. I fail to see any reason why the transformation into whitespaces is necessary. Can this be added to the feature request list? Best, Philipp > Message: 2 > Date: Thu, 14 Aug 2008 18:05:51 +0300 > From: Sorin Ristache <sorin(a)oxygenxml.com> > Subject: Re: [oXygen-user] Whitespace Problem > To: oxygen-user(a)oxygenxml.com > Message-ID: <48A449CF.2070307(a)oxygenxml.com> > Content-Type: text/plain; charset=ISO-8859-15; format=flowed > > Hello, > > The whitespaces including line breaks are normalized when the XML > document is rendered in the Author mode. That means the line breaks > between <orig>E</orig> and <reg>e</reg>, between <reg>e</reg> and > </choice>, etc are replaced with a space character. If the Author mode > removes them without replacing them with a space character then the new > XML document is not the normalized version of the old one. > > The only way to display "Der Eerwirdigen" in the Author mode is to > remove the whitespaces yourself from the XML document before switching > to the Author mode: > > > > Der > <choice> > <orig>E</orig><reg>e</reg></choice>rwirdigen in > <choice> > ... > > > Regards, > Sorin > > > > ---------------------------------------------------------------------- > > Message: 1 > Date: Thu, 14 Aug 2008 16:33:23 +0200 > From: Philipp Steinkr?ger <philipp.steinkrueger(a)uni-koeln.de> > Subject: [oXygen-user] Whitespace Problem > To: oxygen-user(a)oxygenxml.com > Message-ID: <48A44233.8060603(a)uni-koeln.de> > Content-Type: text/plain; charset=ISO-8859-15; format=flowed > > Hello! > > i am having a problem with white-spaces in Author mode. Here is what my > XML document looks like at the problematic passage: > > > Der > <choice> > <orig>E</orig> > <reg>e</reg> > </choice> > rwirdigen in > <choice> > <orig>G</orig> > <reg>g</reg> > </choice> > > > Now in Author mode, the linebreaks are transformed into whitespace, so > that the first part looks like "Der E e rwirdigen in" etc. But i would > like to have it look like "Der Eerwirdigen" etc. has the display > property: block, <choice>, <orig> and <reg> have display property inline, > and i think that exactly is the problem, because the manual says that if > the display-property is inline, non-whitespace (which my linebreak is, i > suppose) are transformed into normal white space. > Is there any way to have oxygen ignore the linebreak? > > Thank you very much, > Philipp > > > -- Philipp Steinkrüger M.A. Philosophisches Seminar der Universität zu Köln - Thomas-Institut - Universitätsstraße 22 50923 Köln Fon +49 221 4702394 Fax +49 221 4705011 philipp.steinkrueger(a)uni-koeln.de http://www.philosophie.uni-koeln.de http://www.thomasinstitut.uni-koeln.de UNIVERSITÄT ZU KÖLN GUTE IDEEN. SEIT 1388.

2 1

Whitespace Problem
by Philipp Steinkrüger 14 Aug '08

14 Aug '08

Hello! i am having a problem with white-spaces in Author mode. Here is what my XML document looks like at the problematic passage: Der <choice> <orig>E</orig> <reg>e</reg> </choice> rwirdigen in <choice> <orig>G</orig> <reg>g</reg> </choice> Now in Author mode, the linebreaks are transformed into whitespace, so that the first part looks like "Der E e rwirdigen in" etc. But i would like to have it look like "Der Eerwirdigen" etc. has the display property: block, <choice>, <orig> and <reg> have display property inline, and i think that exactly is the problem, because the manual says that if the display-property is inline, non-whitespace (which my linebreak is, i suppose) are transformed into normal white space. Is there any way to have oxygen ignore the linebreak? Thank you very much, Philipp -- Philipp Steinkrüger M.A. Philosophisches Seminar der Universität zu Köln - Thomas-Institut - Universitätsstraße 22 50923 Köln Fon +49 221 4702394 Fax +49 221 4705011 philipp.steinkrueger(a)uni-koeln.de http://www.philosophie.uni-koeln.de http://www.thomasinstitut.uni-koeln.de UNIVERSITÄT ZU KÖLN GUTE IDEEN. SEIT 1388.

2 1