Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@forrest.apache.org
To: dev@forrest.apache.org
From: "Scherler, Thorsten" <thorsten@apache.org>
Subject: Re: Forrest skins (repository, build errors, testing, etc.)
Date: Fri, 02 Jul 2004 20:28:27 +0200
Lines: 285
Message-ID: <cc49b7$opv$1@sea.gmane.org>
References: <68A2A386-CAA4-11D8-AF18-00039385397E@medata.com>
 <1088675231.22806.9146.camel@ighp> <40E3EA63.7020806@juntadeandalucia.es>
 <00EA8222-CB67-11D8-85CD-00039385397E@medata.com>
 <cc1te6$m40$1@sea.gmane.org>
 <D277AA4F-CC3E-11D8-88FF-00039385397E@medata.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.4) Gecko/20030612
In-Reply-To: <D277AA4F-CC3E-11D8-88FF-00039385397E@medata.com>
Sender: news <news@sea.gmane.org>

Clay Leeds wrote:

> On Jul 1, 2004, at 1:52 PM, Scherler, Thorsten wrote:
> 
>> Clay Leeds wrote:
>>
>>> Sounds excellent! I'll look forward to it. BTW, on the subject of  
>>> Skins, do I need to actually decompress/extract/untar the [skin].zip  
>>> file into src/documentation/skins or can I just place the ZIP 
>>> archive  into src/documentation/skins/[skin].zip?
>>
>> You have to extract it to that dir because it is 0.5. If it would be  
>> 0.6 (the same version I am on) you could just place it in there.
>>
>> After you /forrest/ you will get BUILD FAILED because of the FOR-146  ;-)
> 
> 
> FOR-146 indicates the issue is closed (I assume that is for 0.5.1, and  
> not for HEAD).

Have a look at the attached forrest.copyless.patch. It is for the 
standard skins which come with forrest (tigris, krysalis,...). It is a 
skin specific patch!

To make a custom 0.5 skin working one could look at the patch to know 
what to fix but you would have do it yourself for each skin!

> 
>> ...or you do not have to downloadd yourself rather let forrest do the  
>> /dirty work/ ;-)
> 
> 
> The possibility of having /forrest/ downloading the skins looks really  
> cool! I tried it, and that part appears to work well. I also like that  
> we won't have to extract the skins. Great!
> 
>> One new feature (part of your idea - like I said above) that I tried  
>> is the forrest.skins.descriptors.
>>
>> I did it like this
>> *created a skins.xml and uploaded it to my space [6]
>> *declared in my local forrest.properties the following 
>> skin.descriptor  (not forget to un-rem that;-)):
>> forrest.skins.descriptors=http://www.apache.org/~thorsten/whiteboard/ 
>> forrestskins/skins.xml
>>
>> ...and just change project.skin=xhtml-css and forrest your project.  
>> That is not working by the way if you like me on 0.6-dev. The same  
>> reason why you can not just drop it to the skin-dir.
> 
> 
> I notice that you don't include any of the version information:
> 
>   SKIN ZIP ARCHIVE NAME => SKIN NAME
>   ==================================
>   forrest-lenya-0.6-dev.zip => forrest-lenya
>   lenya-site-0.6-dev.zip => lenya-site
>   lenya-site-dev-0.6-dev.zip => lenya-site-dev
> 
> Very nice. I recall the discussion some time ago about how to handle  
> this, and it's nice to 'see' how it works.
> 
>> You can try the other skins but that are just some proof of concept  
>> ones similar to the one from  
>> http://xml.apache.org/forrest/skins/skins.xml
> 
> 
> That seems like it will work! I say 'seems' because I'm still getting  
> BUILD FAILED errors. I say 'seems' because it gets past that the SKINS  
> portion, but fails later. I'll paste my stack trace (is that what it's  
> called?) below...
> 
>>>> If it is working I would introduce the custom-color to it and use  
>>>> that as basis for the zengarden-based-skin. I just have to change  
>>>> some <p><RENAME_FILE_TO_USE_div class=""> elements afterwards. 
>>>> Maybe  I can make this changes (class="") customizable via 
>>>> skinconf.xml. So  the user can change the div names on the fly and 
>>>> imitate different  standard-xhtml-output formats.
>>>
>>> Sounds good, although it might be nice to have a non zengarden  
>>> version immediately for testing.
>>
>>
>> If I fix issue 146 on it I will make it aviable as a 0.6-dev version  
>> for download. So see the above mentioned instructions to test the new  
>> feature ;-) Please report back if you have any problems.
> 
> 
> Issue FOR-146 is CLOSED (or is the problem that the skins need to be  
> modified? again, I'm using forrest svn HEAD for this test)
> 
> [...]
> 
>>>>>> [1]
>>>>>> http://forrest.apache.org/docs/your-project.html#skins
>>>>>>
>>>>>> [2]
>>>>>> http://forrest.apache.org/docs/skin-package.html
>>>>>>
>>>>>> [3] whs.zip
>>>>>> http://marc.theaimsgroup.com/?l=forrest-dev&m=107311180623134&w=2
>>>>>>
>>>>>> [4] xhtml-css-0.5.zip
>>>>>> http://marc.theaimsgroup.com/?l=forrest-dev&m=107431137307863&w=2
>>>>>>
>>>>>> [5] Mac browser testing
>>>>>> http://marc.theaimsgroup.com/?l=forrest-dev&m=107357275423333&w=2
>>>>>>
>> [6] thorsten skin descriptor
>> http://www.apache.org/~thorsten/whiteboard/forrestskins/skins.xml
>>
>> [7] forrestskins url
>> http://www.apache.org/~thorsten/whiteboard/forrestskins/
> 
> 
> Here's the contents of my forrest.properties file. The command line  
> interface output with errors is below.
> 
> ##############
> # Properties used by forrest.build.xml for building the website
> ##############
> 
> # Prints out a summary of Forrest settings for this project
> #forrest.echo=true
> 
> # Project name (used to name .war file)
> project.name=fop-project
> 
> # Specifies name of Forrest skin to use
> #project.skin=forrest-site
> project.skin=lenya-site
> 
> # Properties that must be set to override the default locations
> #project.status=status.xml
> project.content-dir=src/documentation
> #project.conf-dir=${project.content-dir}/conf
> project.sitemap=${project.content-dir}/sitemap.xmap
> #project.xdocs-dir=${project.content-dir}/content/xdocs
> #project.stylesheets-dir=${project.content-dir}/resources/stylesheets
> #project.images-dir=${project.content-dir}/resources/images
> #project.schema-dir=${project.content-dir}/resources/schema
> #project.skins-dir=${project.content-dir}/skins
> # added from Thorsten
> forrest.skins.descriptors=http://www.apache.org/~thorsten/whiteboard/ 
> forrestskins/skins.xml
> project.skinconf=${project.content-dir}/skinconf.xml
> #project.lib-dir=${project.content-dir}/lib
> #project.classes-dir=${project.content-dir}/classes
> 
> forrest.validate=true
> forrest.validate.xdocs=${forrest.validate}
> forrest.validate.xdocs.excludes=**/RCS/**/* **/.* **/*~ site.xml
> forrest.validate.skinconf=${forrest.validate}
> 
> forrest.validate.failonerror=true
> 
> Here's the output from my terminal:
> 
> [clay@Clays-TiBook xml-fop]$ forrest
> Apache Forrest.  Run 'forrest -projecthelp' to list options
> 
> Buildfile:  /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/bin/../ 
> forrest.build.xml
> 
> init-props:
> Loading project specific properties from  
> /Users/Shared/_WebDLs/cvs_stuff/xml-fop/forrest.properties
> Loading user specific properties from /Users/clay/forrest.properties
> Loading default properties from  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/bin/../context/ 
> default-forrest.properties
> Reading filters from  /Users/Shared/_WebDLs/cvs_stuff/xml-fop/build/tmp/ 
> projfilters.properties
> forrest.basic.jvmargs:-Dproject.home="/Users/Shared/_WebDLs/cvs_stuff/ 
> xml-fop"  
> -Dforrest.home="/Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/bin/ .."
> 
> echo-settings:
> 
> check-skin:
> 
> fetch-skins-descriptors:
> Deleting 1 files from  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/context/skins
> fetching descriptor:  
> http://www.apache.org/~thorsten/whiteboard/forrestskins/skins.xml
> Getting:  http://www.apache.org/~thorsten/whiteboard/forrestskins/skins.xml
> .
> last modified = Thu Jul 01 13:15:05 PDT 2004
> 
> fetch-skin:
> Processing  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/context/skins/skins 
> -1.xml to  /Users/Shared/_WebDLs/cvs_stuff/xml-fop/build/tmp/ 
> skinlist2fetchbuild.xml
> Loading stylesheet  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/var/skinlist2fetch.xsl
> 
> fetch-versioned-skin:
> Trying to get "lenya-site" skin version
>                   0.6-dev...
> Getting:  
> http://www.apache.org/~thorsten/whiteboard/forrestskins/lenya-site-0.6- 
> dev.zip
> ....
> last modified = Thu Jun 24 22:28:17 PDT 2004
> 
> fetch-unversioned-skin:
> 
> final-check:
> Skin "lenya-site" correctly installed.
> 
> fetchskin:
> 
> unpack-skins:
> Expanding:  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/context/skins/lenya- 
> site.zip into  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/context/skins
> Deleting 1 files from  
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/context/skins
> 
> init-skins:
> 
> init:
> 
> bare-context:
> ____________________________________
> Using skin lenya-site
> ____________________________________
> Copying 34 files to /Users/Shared/_WebDLs/cvs_stuff/xml-fop/build/webapp
> Removed 1 dangling directory from  
> /Users/Shared/_WebDLs/cvs_stuff/xml-fop/build/webapp
> Created dir:  
> /Users/Shared/_WebDLs/cvs_stuff/xml-fop/build/webapp/WEB-INF/lib
> 
> examine-proj:
> 
> check-contentdir:
> 
> ensure-content:
> 
> validation-props:
> 
> validate-xdocs:
> 79 file(s) have been successfully validated.
> ...validated xdocs
> 
> validate-skinconf:
> 1 file(s) have been successfully validated.
> ...validated skinconf
> 
> validate-sitemap:
> /Users/Shared/_WebDLs/cvs_stuff/xml-fop/src/documentation/sitemap.xmap: 
> 126:37: error: element "pipelines" from namespace  
> "http://apache.org/cocoon/sitemap/1.0" not allowed in this context
> 
> BUILD FAILED
> /Users/Shared/_WebDLs/cvs_stuff/forrest/src/core/targets/validate.xml: 
> 180: Validation failed, messages should have been provided.
> 
> Total time: 29 seconds
> 
> 


-- 
<thorsten>
  <name>Thorsten Scherler</name>
  <country>Spain</country>
  <@mail>thorsten.at.apache.org</@mail>
  <@cocoon-WIKI>
http://wiki.cocoondev.org/Wiki.jsp?page=Scherler
</@cocoon-WIKI>
  <acronymfinder>
http://www.acronymfinder.com/af-query.asp?String=exact&Find=Find&Acronym=
  </acronymfinder>
  <motto>
    "My task which I am trying to achieve is,
     by the power of the written word,
     [...] to make you see."
     *Joseph Conrad (1857-1924)*
  </motto>
</thorsten>