Re: [docbook] link inside of funcdef

[=?UTF-8?Q?Sepsi_=C3=96rs?= <sepsi.ors@gmail.com>]

---------- Forwarded message ----------
From: Sepsi Örs <sepsi.ors@gmail.com>
Date: 2011/2/23
Subject: Re: [docbook] link inside of funcdef
To: Bob Stayton <bobs@sagehill.net>


Thanks for the answer!

I am using DocBook 5, and there is no error or warning during the
xsltproc, and the document is also valid. My problem is, that the
generated html file looks the same as without links. But I think I
have found some answer to my question in
http://www.sagehill.net/docbookxsl/Db5Tools.html#Db5UnivLinking

It says, that

"The universal linking mechanism enables you to create logical links
between any two DocBook elements. However, such logical links may or
may not be expressible in formatted output. For example, if you put an
xlink:href on an inline element, then the text of the inline element
can become clickable link text in the output. However, if you put an
xlink:href attribute on a block element such as section, then it is
doubtful that making all the text in the section into a clickable link
will be useful. The DocBook stylesheets currently only handle
xlink:href on inline elements for this reason. If you want to express
linking from a block element, you will have to customize the
stylesheet to do so, perhaps by putting a clickable icon in the
margin."

As I understand you can add linking attributes to many elements, but
it is not sure that in the formatted output it will have an effect.

Ors Sepsi

2011/2/22 Bob Stayton <bobs@sagehill.net>:
> Hi,
> DocBook 5 supports a lot more elements inside funcdef, including link, than
> in DocBook 4.  If you want to stay with DocBook 4, you would have to put the
> link inside <function>, which is semantically incorrect.
>
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
>
> ----- Original Message ----- From: "Sepsi Örs" <sepsi.ors@gmail.com>
> To: <docbook@lists.oasis-open.org>
> Sent: Friday, February 11, 2011 6:45 AM
> Subject: [docbook] link inside of funcdef
>
>
>> Dear Docbook users!
>>
>> I would like to insert some hyperlink in the funcdef element. However,
>> in the HTML output the linking is not possible. Could someone help in
>> this problem, how it is possible to include the hyperlink into the
>> funcdef?
>>
>> Thank you in advance,
>>
>> Ors Sepsi
>>
>> Here is some example:
>>
>> <funcsynopsis>
>> <funcprototype>
>> <?dbhtml funcsynopsis-style='ansi'?>
>> <funcdef><link linkend='link1">text1</link>
>> <function>func</function></funcdef>
>>   <paramdef>double <parameter>a</parameter></paramdef>
>>   <paramdef>double <parameter>b</parameter></paramdef>
>> </funcprototype></funcsynopsis>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>>
>>
>>
>
>