forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Moshe Yudkowsky <msha4...@bl.com>
Subject 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:06:40 GMT
I've resolved the problem with "site:" in my subdir, and I've also figured out 
how to reference binaries (*.gz files) using "site:". And how to use <img 
src="foo">.

Since there's no Wiki page for FAQs, I'm going to post the answer here in the 
hope of helping out some other clueless newbie.

(1) Set up the subdirectories correctly; many "BROKEN: No pipeline matched 
request" errors can be resolved by examining site.xml. To set up a tech 
subdirectory, in site.xml you must the following subdir structure:

<technology label="Technology" href="tech/" tab="tech">
	<about label="Index" href="index.html" />
	<downloads label="Downloads" href="index-downloads.html"/>
	<demos label="Demos" href="index-demos.html" />
	<presentations label="Presentations" href="index-talks.html"/>
</technology>

Now files in the tech subdirectory can use <link href="site:foo"> to reference 
any file defined in site.xml.

(2) Using "site:" to link to non-forrest-generated files

To use site to link to non-forrest-generated files -- e.g., a binary packed as 
a "gz" file -- is a two-step process.

(a) in a file structure that starts at the same level as xdocs, your files. I 
wanted my files in files/binaries, so I created src/documuments/files/binaries; 
  files is in the same directory as xdocs.

(b) define files/binaries in site.xml:

<binaries href="files/binaries/">
	<vxml_bio_0_1 href="vxml_bio_0.1.tar.gz" />
	<Voice2IM.20020604.tar.gz href="Voice2IM.20020604.tar.gz" />
</binaries>

You can now use "site:vxml_bio_0_1" to reference the binary. Note that 
"site:binaries/vxml_bio_0.1.tar.gz" will fail.

(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.

-- 
  Moshe Yudkowsky
  Disaggregate
  2952 W Fargo
  Chicago, IL 60645 USA

  <http://www.Disaggregate.com>

Mime
View raw message