How control on PDF only ulink apears once

[dleal]

Dear members,

In general I use tu use <ulink> node every time I refer to something, for examples, every time I mention Eclipse I use:

Code: Select all

<ulink url="http://www.eclipse.org"><productname>Eclipse</productname></ulink>

.

Under HTML file this approach is ok, because I obtain just a hiperlink with blue font (I whould prefer gray, but I don't know how to do that), but under PDF transformation, I get:
Eclipse[http://www.eclipse.org], so if I use in a paragraph four times Eclipse word it is not frendly for reading. A better solution would be in some way to configure, just to appear the link information once per book/section/chapter, is there any way to control that? In contrare is there any way to disable this behaviour?

Thanks,

David

[sorin_ristache]

Hello,

Set the ulink.show parameter of the DocBook XSL-FO stylesheet to 0 instead of 1 when you generate the PDF output. This will avoid adding the string of the URL between brackets in the link.


Regards,
Sorin

[dleal]

Dear Sorin,

Thank you again for yuor amability responding to me...

I deduce from your response that one have only two posibilities:
1. To allow it, or
2. To disable it.

but there is no more intelligent solution, like I have commented, for example:
3. Just to put the link per ulink element only one time per section, chapter, only one time per page.
4. Just to avoid that on the same paragraph a ulink will be referenced two or more time on generated PDF file.

That would be a nice suggestion,

Thanks in advance,

David

[sorin_ristache]

Hello,

To allow it or to disable it does not mean that there is no link on the text between the ulink element, it just means that the text of the link is not displayed between brackets. That is with a value of 0 for ulink.show you get in the PDF only Eclipse with a link to http://www.eclipse.org and with a value of 1 you get Eclipse[http://www.eclipse.org] with the same link attached to the text. So I do not see how options 3 and 4 would be useful. If you want to display also the text of the link between brackets only the first time per section, chapter, etc. you have to write a customization layer.


Regards,
Sorin

[dleal]

Dear Sorin,

When I mean put the link I refer to the information on the [], so my idea is a kind of intelligent ulink that shows the ulink information only the first time in a paragraph, section, chapter, etc, in opossite to what happen now, if you have:

Code: Select all

 <xsl:param name="ulink.show">1</xsl:param>

then we will get: Eclipse[http://www.eclipse.org] every time we have on the source code we have:

Code: Select all

 <ulink url="http://www.eclipse.org"><productname>Eclipse</productname></ulink>

so, the solution for my problem is to write a customization layer. I don't know what it is and how to do that, I guess it would be advance issue for my poor docbook level.

Thanks any way,

David

[sorin_ristache]

the solution for my problem is to write a customization layer. I don't know what it is and how to do that

There is a video tutorial on our website about how to write and use such a customization layer.


Regards,
Sorin

[dleal]

Dear Sorin,

The tutorial is for demostrating how to get a landscape document. I have mydocbook.xsl file, the problem comes because I don't know what properties to modify and the syntax to use in order to modify this ulink behaviour. Do you have any hint about that?

Oxygen simplify you to write the some nodes, but not the value of the attribute name, for example you should know that: the property space-before.maximum property should exist for verbatim.properties in order to modify its values and also the possible values. Where is this information specified?

Code: Select all

<xsl:attribute name="space-before.maximum">

the docbook reference manual, only show examples about how to modify for example programlisting, but where is the whole verbatim.properties attributes and its possible value definition?

Thhanks in advance,

David

[sorin_ristache]

Dear David,

The video tutorial shows how you can use oXygen to create a DocBook customization layer and apply it to your DocBook document quickly in oXygen. The parameters or the attribute sets that should be modified for the links generated in the PDF result is a very specific question and I think you should ask about this on the docbook-apps list where you can find general help for DocBook transformations.


Regards,
Sorin