You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Charles Palmer <ch...@dspdesign.com> on 2004/08/05 16:25:15 UTC

Problem with SDocBook links?

I'm new to this, so excuse blunders...

In a Simple DocBook file I've attempted to add a link to later in the same file, following the example given here: http://www.docbook.org/tdg/simple/en/html/link.html

The code in my file is:

    <para>Let's experiment with a <link linkend="CF_section">SDocbook
    Link</link> and see if it works.</para>

...snip...

  <section id="CF_section">
    <title>COMPACT FLASH DISK DRIVE</title>

Forrest reports this failure: 

X [0]                       trm/sdocbook2.pdf   BROKEN: org.apache.fop.apps.FOPException: internal-destination or external-destination must be specified in basic-link

The resulting HTML is:

<p>Let's experiment with a <a href="">SDocbook
    Link</a> and see if it works.</p>

...snip...

<a name="N100B0"></a><a name="COMPACT+FLASH+DISK+DRIVE"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>COMPACT FLASH DISK DRIVE</h3>

No pdf file is generated.

I'm using the Krysalis skin, if that makes a difference.

Now, following advice I will probably stop with SDocBook and move back to Forrest files, so I don't need a fix myself, but thought it might be useful to report this...

Regards - Charles

Re: Problem with SDocBook links? (cf. broken: #links in sDocBook)

Posted by Johannes Schaefer <jo...@uidesign.de>.
Dave Brondsema wrote:
> On Thu, 5 Aug 2004, Johannes Schaefer wrote:
> 
> 
>>Charles Palmer wrote:
>>
>>
>>>I'm new to this, so excuse blunders...
>>>
>>>In a Simple DocBook file I've attempted to add a link to later in the same file, following the example given here: http://www.docbook.org/tdg/simple/en/html/link.html
>>>
>>>The code in my file is:
>>>
>>>    <para>Let's experiment with a <link linkend="CF_section">SDocbook
>>>    Link</link> and see if it works.</para>
>>>
>>>...snip...
>>>
>>>  <section id="CF_section">
>>>    <title>COMPACT FLASH DISK DRIVE</title>
>>>
>>>Forrest reports this failure:
>>>
>>>X [0]                       trm/sdocbook2.pdf   BROKEN: org.apache.fop.apps.FOPException: internal-destination or external-destination must be specified in basic-link
>>>
>>>The resulting HTML is:
>>>
>>><p>Let's experiment with a <a href="">SDocbook
>>>    Link</a> and see if it works.</p>
>>>
>>>...snip...
>>>
>>><a name="N100B0"></a><a name="COMPACT+FLASH+DISK+DRIVE"></a>
>>><table width="100%" border="0" cellspacing="0" cellpadding="0">
>>><tbody>
>>><tr>
>>><td height="10" width="9"></td><td>
>>><h3>COMPACT FLASH DISK DRIVE</h3>
>>>
>>>No pdf file is generated.
>>>
>>>I'm using the Krysalis skin, if that makes a difference.
>>>
>>>Now, following advice I will probably stop with SDocBook and move back to Forrest files, so I don't need a fix myself, but thought it might be useful to report this...
>>>
>>>Regards - Charles
>>>
>>
>>I believe this is related to the problem we have
>>(we used a workaround). #links don't work with sDokBook.
>>See:
>>http://issues.apache.org/eyebrowse/ReadMsg?listName=user@forrest.apache.org&msgNo=276
>><anchor> is not a valid sDokBook tag and
>>putting id="anchor_name" into the <section>
>>does not produce the appropriate <a> entry.
>>The tag <ulink url="site:anchor_name"> gets
>>resolved properly. For "linkend" this seems
>>not to be the case ...
>>
>>Who else is using sDocBook?
>>We need to and cannot move to forrest-doc.
>>
> 
> 
> Have you tried using the full docbook stylesheets as described at
> http://forrest.apache.org/faq.html#docbook ?  I think that that is much
> more likely to fit your needs since forrest's sDocBook is so limited.
> 

we now tried to use the full docbook which
provides the <anchor>. It doesn't work:
the files now validate but anchor still
is not transformed properly:

<anchor id="id000"/>  becomes
<a href=""></a> (or noting at all)

<anchor id="id000">Test</anchor>  becomes
<a name="Test"></a><a href=""></a>

Cheers
Johannes




-- 
User Interface Design GmbH * Teinacher Str. 38 * D-71634 Ludwigsburg
Fon +49 (0)7141 377 000 * Fax  +49 (0)7141 377 00-99
Geschäftsstelle: User Interface Design GmbH * Lehrer-Götz-Weg 11 * 
D-81825 München
www.uidesign.de

Re: Problem with SDocBook links? (cf. broken: #links in sDocBook)

Posted by Dave Brondsema <da...@brondsema.net>.
On Thu, 5 Aug 2004, Johannes Schaefer wrote:

> Charles Palmer wrote:
>
> > I'm new to this, so excuse blunders...
> >
> > In a Simple DocBook file I've attempted to add a link to later in the same file, following the example given here: http://www.docbook.org/tdg/simple/en/html/link.html
> >
> > The code in my file is:
> >
> >     <para>Let's experiment with a <link linkend="CF_section">SDocbook
> >     Link</link> and see if it works.</para>
> >
> > ...snip...
> >
> >   <section id="CF_section">
> >     <title>COMPACT FLASH DISK DRIVE</title>
> >
> > Forrest reports this failure:
> >
> > X [0]                       trm/sdocbook2.pdf   BROKEN: org.apache.fop.apps.FOPException: internal-destination or external-destination must be specified in basic-link
> >
> > The resulting HTML is:
> >
> > <p>Let's experiment with a <a href="">SDocbook
> >     Link</a> and see if it works.</p>
> >
> > ...snip...
> >
> > <a name="N100B0"></a><a name="COMPACT+FLASH+DISK+DRIVE"></a>
> > <table width="100%" border="0" cellspacing="0" cellpadding="0">
> > <tbody>
> > <tr>
> > <td height="10" width="9"></td><td>
> > <h3>COMPACT FLASH DISK DRIVE</h3>
> >
> > No pdf file is generated.
> >
> > I'm using the Krysalis skin, if that makes a difference.
> >
> > Now, following advice I will probably stop with SDocBook and move back to Forrest files, so I don't need a fix myself, but thought it might be useful to report this...
> >
> > Regards - Charles
> >
>
> I believe this is related to the problem we have
> (we used a workaround). #links don't work with sDokBook.
> See:
> http://issues.apache.org/eyebrowse/ReadMsg?listName=user@forrest.apache.org&msgNo=276
> <anchor> is not a valid sDokBook tag and
> putting id="anchor_name" into the <section>
> does not produce the appropriate <a> entry.
> The tag <ulink url="site:anchor_name"> gets
> resolved properly. For "linkend" this seems
> not to be the case ...
>
> Who else is using sDocBook?
> We need to and cannot move to forrest-doc.
>

Have you tried using the full docbook stylesheets as described at
http://forrest.apache.org/faq.html#docbook ?  I think that that is much
more likely to fit your needs since forrest's sDocBook is so limited.

-- 
Dave Brondsema : dave@brondsema.net
http://www.brondsema.net : personal
http://www.splike.com : programming
http://csx.calvin.edu : student org

Re: Problem with SDocBook links? (cf. broken: #links in sDocBook)

Posted by Johannes Schaefer <jo...@uidesign.de>.
Charles Palmer wrote:

> I'm new to this, so excuse blunders...
> 
> In a Simple DocBook file I've attempted to add a link to later in the same file, following the example given here: http://www.docbook.org/tdg/simple/en/html/link.html
> 
> The code in my file is:
> 
>     <para>Let's experiment with a <link linkend="CF_section">SDocbook
>     Link</link> and see if it works.</para>
> 
> ...snip...
> 
>   <section id="CF_section">
>     <title>COMPACT FLASH DISK DRIVE</title>
> 
> Forrest reports this failure: 
> 
> X [0]                       trm/sdocbook2.pdf   BROKEN: org.apache.fop.apps.FOPException: internal-destination or external-destination must be specified in basic-link
> 
> The resulting HTML is:
> 
> <p>Let's experiment with a <a href="">SDocbook
>     Link</a> and see if it works.</p>
> 
> ...snip...
> 
> <a name="N100B0"></a><a name="COMPACT+FLASH+DISK+DRIVE"></a>
> <table width="100%" border="0" cellspacing="0" cellpadding="0">
> <tbody>
> <tr>
> <td height="10" width="9"></td><td>
> <h3>COMPACT FLASH DISK DRIVE</h3>
> 
> No pdf file is generated.
> 
> I'm using the Krysalis skin, if that makes a difference.
> 
> Now, following advice I will probably stop with SDocBook and move back to Forrest files, so I don't need a fix myself, but thought it might be useful to report this...
> 
> Regards - Charles
> 

I believe this is related to the problem we have
(we used a workaround). #links don't work with sDokBook.
See:
http://issues.apache.org/eyebrowse/ReadMsg?listName=user@forrest.apache.org&msgNo=276
<anchor> is not a valid sDokBook tag and
putting id="anchor_name" into the <section>
does not produce the appropriate <a> entry.
The tag <ulink url="site:anchor_name"> gets
resolved properly. For "linkend" this seems
not to be the case ...

Who else is using sDocBook?
We need to and cannot move to forrest-doc.

Cheers,
Johannes


-- 
User Interface Design GmbH * Teinacher Str. 38 * D-71634 Ludwigsburg
Fon +49 (0)7141 377 000 * Fax  +49 (0)7141 377 00-99
Geschäftsstelle: User Interface Design GmbH * Lehrer-Götz-Weg 11 * 
D-81825 München
www.uidesign.de