DITA Feature Request -- Insert href to files

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__attrs> ): 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@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@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

On 8/22/08 3:34 PM, "Seraphim Larsen" <seraphim37@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@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>

Thank you for your suggestions. In the next version of Oxygen each of the Link actions available on the toolbar with custom actions for the DITA topic document type (insert a cross reference - xref, a file reference, a web link or a related link) will allow choosing a file or an ID from a file as the target of the reference with a dialog in which the target file can be selected with the help of a file chooser. We will consider also your two suggestions for inserting such references by drag and drop or by selecting the target element and pasting the id at the insertion point. Thank you for your suggestions, Sorin Seraphim Larsen wrote:
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: o 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 o The clipboard is then populated with the <xref> element with the href already correctly defined. o 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. o 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__attrs>): 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

Great, thanks! On Tue, Aug 26, 2008 at 8:16 AM, Sorin Ristache <sorin@oxygenxml.com> wrote:
Thank you for your suggestions. In the next version of Oxygen each of the Link actions available on the toolbar with custom actions for the DITA topic document type (insert a cross reference - xref, a file reference, a web link or a related link) will allow choosing a file or an ID from a file as the target of the reference with a dialog in which the target file can be selected with the help of a file chooser. We will consider also your two suggestions for inserting such references by drag and drop or by selecting the target element and pasting the id at the insertion point.
Thank you for your suggestions, Sorin
Seraphim Larsen wrote:
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: o 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 o The clipboard is then populated with the <xref> element with the href already correctly defined. o 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. o 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__att...
): 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
_______________________________________________ oXygen-user mailing list oXygen-user@oxygenxml.com http://www.oxygenxml.com/mailman/listinfo/oxygen-user
participants (3)
-
Eliot Kimber
-
Seraphim Larsen
-
Sorin Ristache