You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Tim Williams <wi...@gmail.com> on 2010/07/01 12:50:12 UTC

Re: relative links in site.xml

On Wed, Jun 30, 2010 at 8:36 AM, Wipf Markus <ma...@axa-tech.com> wrote:
> Hi,
>
>
>
> Can anybody help me please to fix this problem.
>
> I'm trying to make the things more flexible by using relative links to
> external sites in site.xml:
>
>                 <external-refs>
>
>                                <eplatformIntra href="../">
>
>                                                <workshop>
>
>                                                                <as
> href="services/training/workshops/as/as_knowhow.pdf"/>
>
>                                                </workshop>
>
>                                </eplatformIntra>
>
> The reference to it looks like:
>
> <a href="ext:as">as_knowhow.pdf</a>
>
>
>
> Running the site ant-task I get the following error:
>
>      [java] * [40/9]    [3/31]    0.728s 37.8Kb  kt/training.html
>
>      [java] * [41/8]    [0/0]     1.64s  52.3Kb  kt/training.pdf
>
>      [java] X [0]
> ../services/training/workshops/as/as_knowhow.pdf BROKEN: No flow in
> page-sequence
>
>
>
> The linkmap.xmap file defines for the 'linkmap' pipeline:  A linkmap is a
> map from abstract ('site:index') to
>
> physical ('../index.html') links for the current page.
>
>
>
> The compilation to html works fine, because the pipeline assumes another
> ../, which points exactly to the right place. But the pdf pipeline doesn't
> behave the same way. I don't understand this behavior.
>
> Is there any solution? Best regards. Markus

Hi Markus,
Is it really an *external* reference?  I haven't looked at this in a
while, but I can't recall seeing an example like yours where it's a
local (e.g. "../") and not building up on some full base url.
Hopefully someone else comes along soon, what version of forrest are
you using?  I'm not familiar with that particular fop error either
unfortunately.

--tim

Re: relative links in site.xml

Posted by Tim Williams <wi...@gmail.com>.
On Tue, Jul 6, 2010 at 2:53 AM, Wipf Markus <ma...@axa-tech.com> wrote:
> Hi,
>
> There are external links because we have several sites on the same webserver. So each
>site is completely independent during generation time but not during runtime. That's why I
> try to use relative links to be able to deploy the pages on another location (for another
> customer for example).

I wonder if you might have an XY problem[1] here?  Why don't you
include the links as normal and use cli-conf[2] to ignore them?

> But as I mentioned below Forrest treats link generation for html
> and pdf not in the same manner. That's my problem.

It would appear that Forrest behaves inconsistently only when this
feature is used in a way that's inconsistent with its intent.

--tim

[1] - http://people.apache.org/~hossman/#xyproblem
[2] - http://forrest.apache.org/docs_0_80/faq.html#cli-xconf

AW: relative links in site.xml

Posted by Wipf Markus <ma...@axa-tech.com>.
Hi,

There are external links because we have several sites on the same webserver. So each site is completely independent during generation time but not during runtime. That's why I try to use relative links to be able to deploy the pages on another location (for another customer for example). But as I mentioned below Forrest treats link generation for html and pdf not in the same manner. That's my problem.

Best regards
Markus

-----Ursprüngliche Nachricht-----
Von: Thorsten Scherler [mailto:scherler@gmail.com] 
Gesendet: Donnerstag, 1. Juli 2010 14:20
An: user@forrest.apache.org
Betreff: Re: relative links in site.xml

On Thu, 2010-07-01 at 06:50 -0400, Tim Williams wrote:
> On Wed, Jun 30, 2010 at 8:36 AM, Wipf Markus <ma...@axa-tech.com> wrote:
> > Hi,
> >
> >
> >
> > Can anybody help me please to fix this problem.
> >
> > I'm trying to make the things more flexible by using relative links to
> > external sites in site.xml:
> >
> >                 <external-refs>
> >
> >                                <eplatformIntra href="../">
> >
> >                                                <workshop>
> >
> >                                                                <as
> > href="services/training/workshops/as/as_knowhow.pdf"/>
> >
> >                                                </workshop>
> >
> >                                </eplatformIntra>
> >
> > The reference to it looks like:
> >
> > <a href="ext:as">as_knowhow.pdf</a>
> >
> >
> >
> > Running the site ant-task I get the following error:
> >
> >      [java] * [40/9]    [3/31]    0.728s 37.8Kb  kt/training.html
> >
> >      [java] * [41/8]    [0/0]     1.64s  52.3Kb  kt/training.pdf
> >
> >      [java] X [0]
> > ../services/training/workshops/as/as_knowhow.pdf BROKEN: No flow in
> > page-sequence
> >
> >
> >
> > The linkmap.xmap file defines for the 'linkmap' pipeline:  A linkmap is a
> > map from abstract ('site:index') to
> >
> > physical ('../index.html') links for the current page.
> >
> >
> >
> > The compilation to html works fine, because the pipeline assumes another
> > ../, which points exactly to the right place. But the pdf pipeline doesn't
> > behave the same way. I don't understand this behavior.
> >
> > Is there any solution? Best regards. Markus
> 
> Hi Markus,
> Is it really an *external* reference?  I haven't looked at this in a
> while, but I can't recall seeing an example like yours where it's a
> local (e.g. "../") and not building up on some full base url.
> Hopefully someone else comes along soon, what version of forrest are
> you using?  I'm not familiar with that particular fop error either
> unfortunately.
> 

Yeah it looks from above example that you have missing the parent ref. 

If you look into the site-author site.xml you can find:
<external-refs>
...
<forrest href="http://forrest.apache.org/">
 <download href="mirrors.cgi"/>
 <docs href="docs/">
  <versions> 
   <overview href="../docs.html"/>
   <v0.9 href="../0.9/"/>
   <v0.8 href="../0.8/"/>
   <v0.7 href="../0.7/"/>
  </versions>
 </docs>
</forrest>
...

salu2
> --tim

-- 
Thorsten Scherler <thorsten.at.apache.org>
Open Source Java <consulting, training and solutions>


Re: relative links in site.xml

Posted by Thorsten Scherler <sc...@gmail.com>.
On Thu, 2010-07-01 at 06:50 -0400, Tim Williams wrote:
> On Wed, Jun 30, 2010 at 8:36 AM, Wipf Markus <ma...@axa-tech.com> wrote:
> > Hi,
> >
> >
> >
> > Can anybody help me please to fix this problem.
> >
> > I'm trying to make the things more flexible by using relative links to
> > external sites in site.xml:
> >
> >                 <external-refs>
> >
> >                                <eplatformIntra href="../">
> >
> >                                                <workshop>
> >
> >                                                                <as
> > href="services/training/workshops/as/as_knowhow.pdf"/>
> >
> >                                                </workshop>
> >
> >                                </eplatformIntra>
> >
> > The reference to it looks like:
> >
> > <a href="ext:as">as_knowhow.pdf</a>
> >
> >
> >
> > Running the site ant-task I get the following error:
> >
> >      [java] * [40/9]    [3/31]    0.728s 37.8Kb  kt/training.html
> >
> >      [java] * [41/8]    [0/0]     1.64s  52.3Kb  kt/training.pdf
> >
> >      [java] X [0]
> > ../services/training/workshops/as/as_knowhow.pdf BROKEN: No flow in
> > page-sequence
> >
> >
> >
> > The linkmap.xmap file defines for the 'linkmap' pipeline:  A linkmap is a
> > map from abstract ('site:index') to
> >
> > physical ('../index.html') links for the current page.
> >
> >
> >
> > The compilation to html works fine, because the pipeline assumes another
> > ../, which points exactly to the right place. But the pdf pipeline doesn't
> > behave the same way. I don't understand this behavior.
> >
> > Is there any solution? Best regards. Markus
> 
> Hi Markus,
> Is it really an *external* reference?  I haven't looked at this in a
> while, but I can't recall seeing an example like yours where it's a
> local (e.g. "../") and not building up on some full base url.
> Hopefully someone else comes along soon, what version of forrest are
> you using?  I'm not familiar with that particular fop error either
> unfortunately.
> 

Yeah it looks from above example that you have missing the parent ref. 

If you look into the site-author site.xml you can find:
<external-refs>
...
<forrest href="http://forrest.apache.org/">
 <download href="mirrors.cgi"/>
 <docs href="docs/">
  <versions> 
   <overview href="../docs.html"/>
   <v0.9 href="../0.9/"/>
   <v0.8 href="../0.8/"/>
   <v0.7 href="../0.7/"/>
  </versions>
 </docs>
</forrest>
...

salu2
> --tim

-- 
Thorsten Scherler <thorsten.at.apache.org>
Open Source Java <consulting, training and solutions>