Insert Content Reference improvements

[jelovirt]

Oxygen 10.0, OS X 10.5.5 and, Java 1.6.

1. Insert Content Reference is only available on Author mode. Would it be possible to add it also into Editor mode?

2. Insert Content Reference dialog doesn't remember the last file that was used. In most cases I use the same source file. Could Insert Content Reference dialog remember the last opened conref source file?

3. The default preview for conrefs is:

Edit referenced content
[conref content]

This works well for e.g. paragraphs, but if you conref inline elements, the output is not particularly good. For example, conreffed uicontrol element (with inline elements visible):

To access your home page, select
Edit referenced content
<uicontrol>Home</uicontrol>
.

Could the preview for conref be a single inline icon with a tooltip, this would allow the preview for the above be something like:

To access your home page, select <uicontrol>Home</uicontrol>.

Where the anchor icon should be icon for conref.

4. Ignore conref element content. Right now if you have content in you conref element, it gets displayed above the conref anchor. The conref content should be ignored, as the actual content is retrieved from the conref source document. (Some CMS' fill in the conref contents whenever a topic is checked out, as not all XML editors have DITA support.)

[Radu]

Hi Jarno,

Thank you for the feedback.

See some answers below:

1. Insert Content Reference is only available on Author mode. Would it be possible to add it also into Editor mode?

Indeed we have a lack of consistency, you have a lot of actions available in the Author mode but those actions cannot be used in the Text/Editor mode. We already know about this and will try to come up with an improvement in a future version.

2. Insert Content Reference dialog doesn't remember the last file that was used. In most cases I use the same source file. Could Insert Content Reference dialog remember the last opened conref source file?

Hi, I see your usecase, we'll try to do this by 10.1. You can also open the last URL by selecting it from the combo box.

3. The default preview for conrefs is:.........Could the preview for conref be a single inline icon with a tooltip?

The link that you see is done using styles from an Oxygen default CSS file called "authorDefaults.css" and located in the oxygen.jar library.
You can open the OXYGEN_INSTALL_DIR/frameworks/dita/css_classed/dita.css CSS file and make the following modifications:

1) Add a namespace declaration after all the imports:

Code: Select all

@namespace oxy url('http://www.oxygenxml.com/extensions/author');

2) At the end of the CSS file add the following rules:

Code: Select all

oxy|reference:before {

  display: inline !important;

  content: "<CONREF>" !important;  

}

oxy|reference {

    display:morph !important;

}

4) Ignore conref element content.

You can hide the real content by adding the following rules at the end of the same CSS file as above:

Code: Select all

*[conref] > * {

    display:none;

}



*[conref] > *[id] {

    display:morph;

}

Regards,
Radu

[dkb123]

Always prefer recycling to starting a new thread

Can the same type of edits you describe above be used to change the default behaviour of the Insert Topic Reference dialog box?
We would like 'Attributes/Collection Type' to be prepopulated with 'Sequence' to ensure someone doesn't forget to set it and it breaks our next/previous links flow in the webhelp.

Thanks

[Radu]

Hi,

We will discuss your request and you will be notified if we decide to implement it.

Regards,
Radu

[dkb123]

Ok, thanks for letting me know.

[alex911]

hi,

Code: Select all

4) Ignore conref element content.

You can hide the real content by adding the following rules at the end of the same CSS file as above:

CODE: SELECT ALL

*[conref] > * {

    display:none;

}



*[conref] > *[id] {

    display:morph;

}

As for ignore conref element content. Are there any new solutions in version 14.1?
The fact is that when we using the proposed solution, we can hide context only of child elements, if these elements do not have ID. Can we completely hide the contents of the node?

[Radu]

Hi,

A slightly better approach which would also hide the text:

1) Declare a namespace after all imports are made in the main CSS:

Code: Select all

@namespace oxy "http://www.oxygenxml.com/extensions/author";

2) Add 4 selectors to the end of the CSS:

Code: Select all

*[conref]{

    visibility:-oxy-collapse-text;

}



*[conref] oxy|reference{

    visibility:visible;

}



*[conref] > * {

    display:none;

}



*[conref] > *[id] {

    display:-oxy-morph;

}

Out of curiosity, why do you have text content in the element which makes the conref?

Regards,
Radu