Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@forrest.apache.org
Received-SPF: neutral (asf.osuosl.org: local policy)
Message-ID: <43A293ED.5060004@apache.org>
Date: Fri, 16 Dec 2005 10:16:13 +0000
From: Ross Gardler <rgardler@apache.org>
User-Agent: Mozilla Thunderbird 1.0 (Windows/20041206)
MIME-Version: 1.0
To: dev@forrest.apache.org
Subject: Creating documentation (Re: Link to CSS howto-structurer-dsl.html)
References: <eab855560512152153g3462657ag@mail.gmail.com>
 <43A287D5.6050307@apache.org> <43A28DF5.4040202@pcotech.fr>
In-Reply-To: <43A28DF5.4040202@pcotech.fr>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: quoted-printable

Cyriaque Dupoirieux wrote:
> Ross Gardler a =E9crit :
>=20
>> Paul Bolger wrote:
>>
>>> Can anyone explain how to link to an external CSS file from an .fv fi=
le?
>>
>>
>>
>> http://marc.theaimsgroup.com/?l=3Dforrest-dev&m=3D113244185027121&w=3D=
2
>>
> Hi, Paul,
>=20
>    To summarise :
>=20
>    * The tag to include css file has the following syntax :
>=20
> <forrest:css url=3D"layout.screen.css" media=3D"screen|print"=20
> theme=3D"themeName"/>
>=20
>    * url attribute indicates the name of the css file, the dispatcher
>      searches for this file in the following order :
>          o Does the css file exists in the following directory - if
>            yes, use this one :
>=20
> $PROJECT_HOME/src/documentation/resources/themes/yourtheme/css/layout.s=
creen.css=20
>=20
>=20
>          o Else, does the css file exists in the following directory -
>            if yes, use this one :
>=20
>       =20
> $FORREST_HOME/whiteboard/plugins/org.apache.forrest.plugin.output.theme=
r/resources/themes/yourtheme/css/layout.screen.css=20
>=20
>=20
>          o Else, does the css file exists in the following directory -
>            if yes, use this one :
>=20
>       =20
> $FORREST_HOME/whiteboard/plugins/org.apache.forrest.plugin.output.theme=
r/resources/themes/common/css/layout.screen.css=20
>=20
>=20
>    * media attribute indicates to the browser the stylesheets to use
>      depending on the detination media :
>          o screen : the stylesheet is used with the browser displaying
>            the page on the screen,
>          o print - the stylesheet is used while printing the document -=

>            or print preview...
>=20
>        (There is a bug with firefox, the bug is already declared twice
>        in bugzilla, so we are waiting...)
>=20
>    * theme attribute indicates to the browser for which theme this
>      stylesheet should be used, letting you add several css files
>      corresponding to different themes of the same page.

(this is a general comment not at all aimed at the authors of these=20
mails - since I'm in that group)

Why is it that people take the time to write clear documentation like=20
this but nobody puts it into a document?

Someone, please get this into documentation within the structurer=20
plugin. Note that it need not be the person who posts the solution,=20
maybe the person asking the question could help too.

(remember this is *not* aimed at people in this thread, it's a general=20
point that I often wonder about).

Ross