You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by Ross Gardler <rg...@apache.org> on 2005/10/29 11:58:58 UTC

Docs now use Daisy-wiki defined URLspace

The docs from Daisy are now generated using the Daisy Navigation defined 
URL space.

Some of the newer documents do not have a nodeId defined, these default 
to using the docId (i.e. same behaviour as the Daisy wiki).

The solution is all XSLT based, in a future release of the Daisy plugin 
I'll make this more efficient and create custom transformers, using XSLT 
for this is a fair bt inneficient, but it works and I believe the docs 
can now be published.

Please check them out, make sure I've not missed anything as I've not 
been able to get more than about 15 minutes at a time to focus on this 
so I may well have missed things.

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Stefano Mazzocchi wrote:
> hepabolu wrote:
> 
>> Ross Gardler wrote:
>>
>>>> <applause/>
>>
>>
>> +1
>>
>>> With respect to skins and themes, wait until you see the new 
>>> replacement for the skinning system - it's awesome in its 
>>> configurability and flexibility (and no, I didn't write it ;-)
>>>
>>> Ross
>>>
>>
>> I agree, the TOC could go, either to the menu bar or removed altogether.
>>
>> Ross, I've probably made a mistake in the CSS I sent (wrong class/id I 
>> suppose), but the box around the selected menu item is still there. 
>> Could you please remove it, it doesn't look good. Maybe changing the 
>> font of the selected item to bold white would make it stand out 
>> enough. Could you fix it please?

Yes

>> On my brand new Powerbook, the background color of the Apache Cocoon 
>> logo (left with feather) has a different shade of blue as background, 
>> while I can't remember having seen that on my Windows machine.
>>
>> AFAICT colors are identical. Anyone else seeing this?

The starting point for the skin and all the images were copied from the 
site definition that generates http://cocoon.apache.org/2.1/

Do they look different there?

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Stefano Mazzocchi <st...@apache.org>.
hepabolu wrote:
> Ross Gardler wrote:
>>> <applause/>
> 
> +1
> 
>> With respect to skins and themes, wait until you see the new 
>> replacement for the skinning system - it's awesome in its 
>> configurability and flexibility (and no, I didn't write it ;-)
>>
>> Ross
>>
> 
> I agree, the TOC could go, either to the menu bar or removed altogether.
> 
> Ross, I've probably made a mistake in the CSS I sent (wrong class/id I 
> suppose), but the box around the selected menu item is still there. 
> Could you please remove it, it doesn't look good. Maybe changing the 
> font of the selected item to bold white would make it stand out enough. 
> Could you fix it please?
> 
> On my brand new Powerbook, the background color of the Apache Cocoon 
> logo (left with feather) has a different shade of blue as background, 
> while I can't remember having seen that on my Windows machine.
> 
> AFAICT colors are identical. Anyone else seeing this?

yup. the background should be transparent, not colored.

-- 
Stefano.


Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
hepabolu wrote:
> Ross Gardler wrote:
> 
>>> <applause/>
> 
> 
> +1
> 
>> With respect to skins and themes, wait until you see the new 
>> replacement for the skinning system - it's awesome in its 
>> configurability and flexibility (and no, I didn't write it ;-)
>>
>> Ross
>>
> 
> I agree, the TOC could go, either to the menu bar or removed altogether.

I've moved it into the menu bar. Not sure if I like it there, it makes 
the menu very cluttered. Take a look and let me have your comments when 
the site rebuilds (a few minutes after 20:00 GMT).

I've also fixed a problem that meant some external links were not 
appearing in the menu.

> Ross, I've probably made a mistake in the CSS I sent (wrong class/id I 
> suppose), but the box around the selected menu item is still there. 
> Could you please remove it, it doesn't look good. Maybe changing the 
> font of the selected item to bold white would make it stand out enough. 
> Could you fix it please?

Done.

Unfortunately it can be difficult to identify which part of the CSS to 
modify, I find the web developer extension for Firefox to be invaluable, 
select a menu item, click on the page and it shows you all the CSS that 
is applied to that part of the page. You can get the extension from 
http://chrispederick.com/work/webdeveloper/

Re: Docs now use Daisy-wiki defined URLspace

Posted by Stefano Mazzocchi <st...@apache.org>.
Ross Gardler wrote:
> Pier Fumagalli wrote:
>> On 29 Oct 2005, at 17:18, hepabolu wrote:
>>
>>> On my brand new Powerbook, the background color of the Apache  Cocoon 
>>> logo (left with feather) has a different shade of blue as  
>>> background, while I can't remember having seen that on my Windows  
>>> machine.
>>>
>>> AFAICT colors are identical. Anyone else seeing this?
>>
>>
>> Yes... I'm seeing it, but I think it's because of the color  
>> management done on the Mac...
> 
> I'm no graphics person, can anyone create a version with a transparent 
> background?
> 
> http://svn.apache.org/repos/asf/cocoon/whiteboard/daisy-to-docs/src/documentation/content/xdocs/images/cocoon-logo.gif 

http://svn.apache.org/repos/asf/cocoon/trunk/misc/graphics/cocoon2-naked.gif

enjoy

wow, I'm committing something on cocoon after years :-)

-- 
Stefano.


Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Thor Heinrichs-Wolpert wrote:
> Not sure if this is what you wanted, but I made the blue background  
> transparent.
> 
> ------------------------------------------------------------------------
> 
> Cheers,
> Thor HW
> 
> On 29-Oct-05, at 11:31 AM, Ross Gardler wrote:
> 
>> Pier Fumagalli wrote:
>>
>>> On 29 Oct 2005, at 17:18, hepabolu wrote:
>>>
>>>> On my brand new Powerbook, the background color of the Apache   
>>>> Cocoon logo (left with feather) has a different shade of blue as   
>>>> background, while I can't remember having seen that on my  Windows  
>>>> machine.
>>>>
>>>> AFAICT colors are identical. Anyone else seeing this?
>>>>
>>> Yes... I'm seeing it, but I think it's because of the color   
>>> management done on the Mac...
>>>
>>
>> I'm no graphics person, can anyone create a version with a  
>> transparent background?
>>
>> http://svn.apache.org/repos/asf/cocoon/whiteboard/daisy-to-docs/src/ 
>> documentation/content/xdocs/images/cocoon-logo.gif

Thanks Stefano and Thor,

I'm not able to commit these for a few days due to travel. Can someone 
please put them into the daisy-to-docs module in whiteboard, they go in 
src/documentation/content/xdocs/images

Once in there the ForrestBot will do the rest.

Thanks

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Thor Heinrichs-Wolpert <th...@lunartek.com>.
Not sure if this is what you wanted, but I made the blue background  
transparent.

Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Pier Fumagalli wrote:
> On 29 Oct 2005, at 17:18, hepabolu wrote:
> 
>> On my brand new Powerbook, the background color of the Apache  Cocoon 
>> logo (left with feather) has a different shade of blue as  background, 
>> while I can't remember having seen that on my Windows  machine.
>>
>> AFAICT colors are identical. Anyone else seeing this?
> 
> 
> Yes... I'm seeing it, but I think it's because of the color  management 
> done on the Mac...

I'm no graphics person, can anyone create a version with a transparent 
background?

http://svn.apache.org/repos/asf/cocoon/whiteboard/daisy-to-docs/src/documentation/content/xdocs/images/cocoon-logo.gif

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by David Crossley <cr...@apache.org>.
Pier Fumagalli wrote:
> hepabolu wrote:
> 
> >On my brand new Powerbook, the background color of the Apache  
> >Cocoon logo (left with feather) has a different shade of blue as  
> >background, while I can't remember having seen that on my Windows  
> >machine.
> >
> >AFAICT colors are identical. Anyone else seeing this?
> 
> Yes... I'm seeing it, but I think it's because of the color  
> management done on the Mac...

On my Mac everything is fine when using Firefox
but when using Safari there is a different blue
background for the top banner, making the left-hand
logo appear to contrast. The same with those pesky
round corners at the bottom of the left-hand menu.

I remember seeing an issue long ago in Forrest's
Jira about this. Some CSS fix was applied to correct
a similar problem with IE.

-David

Re: Docs now use Daisy-wiki defined URLspace

Posted by Pier Fumagalli <pi...@betaversion.org>.
On 29 Oct 2005, at 17:18, hepabolu wrote:

> On my brand new Powerbook, the background color of the Apache  
> Cocoon logo (left with feather) has a different shade of blue as  
> background, while I can't remember having seen that on my Windows  
> machine.
>
> AFAICT colors are identical. Anyone else seeing this?

Yes... I'm seeing it, but I think it's because of the color  
management done on the Mac...

     Pier



Re: Docs now use Daisy-wiki defined URLspace

Posted by hepabolu <he...@gmail.com>.
Ross Gardler wrote:
>> <applause/>

+1

> With respect to skins and themes, wait until you see the new replacement 
> for the skinning system - it's awesome in its configurability and 
> flexibility (and no, I didn't write it ;-)
> 
> Ross
> 

I agree, the TOC could go, either to the menu bar or removed altogether.

Ross, I've probably made a mistake in the CSS I sent (wrong class/id I 
suppose), but the box around the selected menu item is still there. 
Could you please remove it, it doesn't look good. Maybe changing the 
font of the selected item to bold white would make it stand out enough. 
Could you fix it please?

On my brand new Powerbook, the background color of the Apache Cocoon 
logo (left with feather) has a different shade of blue as background, 
while I can't remember having seen that on my Windows machine.

AFAICT colors are identical. Anyone else seeing this?


Bye, Helma



Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Stefano Mazzocchi wrote:
> Ross Gardler wrote:
> 
>> Ross Gardler wrote:
>>
>>> Ross Gardler wrote:
>>>
>>>> Ross Gardler wrote:
>>>>
>>>>> Please check them out, make sure I've not missed anything as I've 
>>>>> not been able to get more than about 15 minutes at a time to focus 
>>>>> on this so I may well have missed things.
>>>>
>>>>
>>>>
>>>>
>>>> The entry URL has obviously changed as well:
>>>>
>>>> http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/
>>
>>
>> The last build seems to have worked OK. No reported broken links and 
>> images seem to be appearing.
>>
>> Please test and report any issues.
> 
> 
> <applause/>
> 
> Can wait until we have it running for our official web site.
> 
> On a side note, and only marginally related to this work, I find the 
> "table of content" box in every page to be pretty much useless and 
> annoying. Am I the only one? Could we move it over to the navigation 
> tree instead? (where it belongs?)
> 
> I've designed this skin many years ago and it's starting to show its 
> age.... or maybe I am :-)
> 
> Anyway, those are details, great job anyway.
> 

Like most things in Forrest it's configurable from within the 
skinconf.xml file (which is in the daisy-to-docs svn module in whiteboard).

For this particular setting see:

   <!-- Configure the TOC, i.e. the Table of Contents.
   @max-depth
    how many "section" levels need to be included in the
    generated Table of Contents (TOC).
   @min-sections
    Minimum required to create a TOC.
   @location ("page","menu","page,menu", "none")
    Where to show the TOC.
   -->
   <toc max-depth="2" min-sections="1" location="page"/>

I've not changed it yet, we'll see if people are in agreement.

With respect to skins and themes, wait until you see the new replacement 
for the skinning system - it's awesome in its configurability and 
flexibility (and no, I didn't write it ;-)

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Stefano Mazzocchi <st...@apache.org>.
Ross Gardler wrote:
> Ross Gardler wrote:
>> Ross Gardler wrote:
>>
>>> Ross Gardler wrote:
>>>
>>>> Please check them out, make sure I've not missed anything as I've 
>>>> not been able to get more than about 15 minutes at a time to focus 
>>>> on this so I may well have missed things.
>>>
>>>
>>>
>>> The entry URL has obviously changed as well:
>>>
>>> http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/
> 
> The last build seems to have worked OK. No reported broken links and 
> images seem to be appearing.
> 
> Please test and report any issues.

<applause/>

Can wait until we have it running for our official web site.

On a side note, and only marginally related to this work, I find the 
"table of content" box in every page to be pretty much useless and 
annoying. Am I the only one? Could we move it over to the navigation 
tree instead? (where it belongs?)

I've designed this skin many years ago and it's starting to show its 
age.... or maybe I am :-)

Anyway, those are details, great job anyway.

-- 
Stefano.


Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Ross Gardler wrote:
> Ross Gardler wrote:
> 
>> Ross Gardler wrote:
>>
>>> Please check them out, make sure I've not missed anything as I've not 
>>> been able to get more than about 15 minutes at a time to focus on 
>>> this so I may well have missed things.
>>
>>
>>
>> The entry URL has obviously changed as well:
>>
>> http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/

The last build seems to have worked OK. No reported broken links and 
images seem to be appearing.

Please test and report any issues.

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Ross Gardler wrote:
> Ross Gardler wrote:
> 
>> Please check them out, make sure I've not missed anything as I've not 
>> been able to get more than about 15 minutes at a time to focus on this 
>> so I may well have missed things.
> 
> 
> The entry URL has obviously changed as well:
> 
> http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/


I just spotted a problem, it's not being reported by the ForrestBot 
because they are not actually broken links. The problem is that we are 
using absolute pathnames but the site is being hosted in a subdirecty.

This means that links in pages and image all appear broken. However, 
this does not occur when hosting in the root.

I'm looking into it now.

Ross

Re: Docs now use Daisy-wiki defined URLspace

Posted by Ross Gardler <rg...@apache.org>.
Ross Gardler wrote:

> Please check them out, make sure I've not missed anything as I've not 
> been able to get more than about 15 minutes at a time to focus on this 
> so I may well have missed things.

The entry URL has obviously changed as well:

http://forrest.zones.apache.org/ft/build/cocoon-docs/2.1/

Ross