forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Diwaker Gupta <diwa...@apache.org>
Subject Re: question about differences between versions of forrest
Date Wed, 20 Jul 2005 05:09:38 GMT
Hi David,

On Tuesday 19 July 2005 1:43 pm, Paterline, David L. wrote:
> I have been trying to recreate a web site previously created by someone who
> has left the company, and in doing so, noticed differences between the
> appearance of the site when generated by different versions of Forrest. I'd
> like to know if this is to be expected, or whether I have something wrong
> in my installation of Forrest.

There have certainly been *numerous* changes between 0.5 and 0.7, both under 
the hood as well has externally. The Forrest team tries to make it as easy as 
possible for users to migrate to newer versions (keep backward compatibility 
where possible, provide an easy upgrade path otherwise, keep changes user 
visible interfaces minimal etc). However, since Forrest is still far from 1.0 
release, you should be prepared for some changes specially if you're jumping 
2 minor versions :-)

> The site was originally created by Forrest 0.5.1. I'm using the latest
> version, Forrest 0.7, in my latest builds. I couldn't understand why my
> latest build appeared differently, so I've built the site using the two
> versions of Forrest. I used Forrest 0.5.1 in the first build, and Forrest
> 0.7 in the next. I'm running both builds on Windows XP.

It would be extremely valuable if you could make these two sites (or some 
sample output from Forrest) available (online or otherwise) -- it'll be much 
easier to help diagnose your issues that way.

> Some of the differences I see are:
> - with Forrest 0.7, html appears in a smaller font, and

This is purely a CSS issue, and easily fixed to your taste.
Locate the file skinconf.xml under your project (usually under 
src/documentation/) and find the section <extra-css> in it. Try putting 
something like:

body {
 font-size: 12px;
}

> - with Forrest 0.7, the "Font size: -a +a Reset" feature doesn't appear

This is configurable via an option in skinconf.xml I believe. To see what 
options are available in skinconf, create a new directory (say forrest-seed) 
and inside it, run

$ forrest seed

This will create a fresh site demonstrating all that can be done with Forrest 
0.7. Take a look at the skinconf.xml it generates.

> - with Forrest 0.7, the corners on the tabs of my index.html page have
> black squares and are not rounded

I think this can help you:
http://forrest.apache.org/docs_0_70/howto/howto-corner-images.html

> - with Forrest 0.5.1, colored bars appear below section titles, in 0.7,
> they don't

Also configurable via skinconf.xml

> - with Forrest 0.7, the PDF files contents are not centered in the file,
> they butt against the left edge of the 'page'

Could you send sample files please?

> - with Forrest 0.7, I get a lot of error messages like "BROKEN: No pipeline
> matched request: rpa_docs/RPA_User_Note_2.doc" that don't appear in the
> Forrest 0.5.1 log

This is probably because you were a) using a custom sitemap; b) using an input 
plugin that has not been enabled currently (see forrest.properties)

HTH,
Diwaker
-- 
Web/Blog/Gallery: http://floatingsun.net

Mime
View raw message