Re: question about differences between versions of forrest

2005-07-20 Thread David Crossley
David, the main thing that you need to do is to
upgrade your configuration files (e.g. skinconf, etc.)
following the upgrade instructions. This will mean
that you cannot then build it with 0.5.1

Diwaker Gupta wrote:
 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.

Please do the config upgrade first, it will solve many of your
issues.

  - 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?

However, not as attachments to the mailing list - use the
Jira issue tracker if you need to send something, or put
them on your own website and give us URLs.

  - 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)

I think that this will be a result of the change in the
way that raw unprocessed content is delivered. Again
please see the upgrade notes.

Actually i would like to know how you managed to miss the
instructions about the upgrade notes. Do we need to make
that more obvious?

David


Re: question about differences between versions of forrest

2005-07-20 Thread David Crossley
Tim Williams wrote:
 It sounds like your predecessor may have customized the sitemap
 (broken pipelines) and maybe the skin?  Have you gone through the
 0.5-0.6 upgrade then the 0.6-0.7 updgrade and are still having these
 issues?

Actually one does not need to upgrade first to use 0.6
then 0.7 version. Go straight from 0.5 to 0.7 is fine.
Just follow the 0.7 upgrade instructions. The main
thing is modifying the config files. But as Tim says
if your predecessor used specialized sitemap stuff,
then there is extra work to do.

David


Re: question about differences between versions of forrest

2005-07-19 Thread Tim Williams
It sounds like your predecessor may have customized the sitemap
(broken pipelines) and maybe the skin?  Have you gone through the
0.5-0.6 upgrade then the 0.6-0.7 updgrade and are still having these
issues?  It looks like these two documents show how to bring old ways
of doing things (e.g. direct sitemap changing) to new ways (e.g.
plugin/project-level sitemap).  To your other question, it sounds like
you have installed it correctly just need to figure out what was
done and recreate it in 0.7.

Take a look at these:
http://forrest.apache.org/docs_0_60/upgrading_06.html
http://forrest.apache.org/docs_0_70/upgrading_07.html

Given your issues, you may want to pay particular attention to finding
a skin that is most like yours if it doesn't still exist and
investigate any local changes to the *.xmap (specifically looking for
a **.doc match?)

--tim

On 7/19/05, Paterline, David L. [EMAIL PROTECTED] wrote:
  
 Hi - 
   
 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. 
   
 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. 
   
 Some of the differences I see are: 
 - with Forrest 0.7, html appears in a smaller font, and 
  
 - with Forrest 0.7, the Font size: -a +a Reset feature doesn't appear-
 with Forrest 0.7, the corners on the tabs of my index.html page have black
 squares and are not rounded 
 - with Forrest 0.5.1, colored bars appear below section titles, in 0.7, they
 don't 
 - with Forrest 0.7, the PDF files contents are not centered in the file,
 they butt against the left edge of the 'page' 
 - 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 
   
 These are the main things I notice, but there may be more. 
   
 This leads me to question whether I have installed Forrest 0.7 correctly, or
 whether there may be some plugins or addins that need to be installed along
 with 0.7. Or, am I way off here, and there is something else at play? 
   
 In general, the site build with 0.5.1 looks better, and I would like to be
 able to reproduce the appearance using the latest version of Forrest. 
   
 Appreciate any suggestions or explanations. 
   
 Thanks. 
 
 - 
 David L. Paterline 
 Principal Engineer   
 Westinghouse Electric Company 
 Nuclear Fuel Engineering 
 Engineering Computing 
 [EMAIL PROTECTED]   
 PH: 412-374-2286 
 FX: 412-374-2284


Re: question about differences between versions of forrest

2005-07-19 Thread Diwaker Gupta
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


pgpSIQRULgqAi.pgp
Description: PGP signature