forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Nicola Ken Barozzi <nicola...@apache.org>
Subject Re: How to use "site:" in subdirs and with binaries, and using img (was "site:" fails in subdir with "No pipeline")
Date Fri, 20 Feb 2004 16:56:11 GMT
Moshe Yudkowsky wrote:
...
> (3) Images. There's a directory called src/resources/images, and your 
> images can go there; but you need to know the trick to reference them. 
> Put foo.png there, for example. You can then use <img 
> src="images/foo.png"> from any directory or subdirectory to reference 
> foo.png. If you don't use the "images/" construct, but just "foo.png", 
> forrest will attempt to find the image whatever directory you're 
> currently in.

That construct is deprecated (I know, it's not well documented) and will 
go away in a future forrest version, as we are moving to a double 
directory space: one for all the usual docs and images (content), 
another for artifacts that must be served without any other intervention 
of forrest (raw).

In the above case, the images should be placed as
   src/documentation/content/xdocs/anywhere/myimage.png

and referenced as
    <img src="anywhere/myimage.png"/>

Keep in mind that in

   src/documentation/content/xdocs/anywhere/subanywhere/

to reference the above image one would do

    <img src="../anywhere/myimage.png"/>

as for other xdocs (in this case it's better to put it in site.xml, as 
IMHO relative links like this usually denote a more generic resource)

Because of this, we will have instead of

    src/documentation/content/xdocs/
    src/documentation/content/

something like

    src/site/
    src/site/raw

that is much easier to use.

-- 
Nicola Ken Barozzi                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


Mime
View raw message