[haiku-web] Re: [new feature] New way of maintaining developer documentation

Hi Niels,

Niels Reedijk said on Wed, 11 Mar 2009 18:08:21 +0100
> 2009/3/12 Jorge G. Mare <koki@xxxxxxxxxxxxx>:
> >> Notes:
> >> 1. Design. On the left there are two blocks. One is a custom block 
> > > I
> >> wrote which describes the page. The other one is an automatic 
> > > block
> >> that generates a table of contents of the book. When I first put 
> > > the
> >> block in the right column (with the yellow blocks), it sort of
> >> disappeared, so I decided to put this info in the left column.
> >> However, in order to keep the content readable, I had to hide the
> >> right column. Personally I think I did the right thing with this
> >> design. It could use some CSS love.
> >
> > For consistency purposes I think it would be much better to stay 
> > with
> > the standard layout where the blocks are to the right of the body. 
> > Not
> > sure what you mean by "it sort of dissapeared", but putting the 
> > book
> > block to the right should definitely work. What exactly happens?
> 
> What I mean is that when I put the block to the right, you lose the
> sense that the particular block is a navigation of the current page.
> Traditionally navigation blocks of any docs are in the left margin,
> added to that, it was difficult to separate the block from the others
> .
> Of course we can fix that with CSS styling, but I implemented this
> left-side block.

I don't think there is a general rule that menu blocks have to be on 
one side or the other of the body text; it is more a matter of how the 
website has been designed (ie., the Gnome user guide has the navigation 
menu to the right).

Shijin was designed to have navigation blocks on the right side; putting 
blocks on the opposite side only on some pages is not only weird, but 
it may also break the page layout rendering, as the left column is not 
taken into account in the theme (even when the left region exists, 
that's just a remnant from the spreadfirefox theme that shijin was 
based on).

One good thing about D5 is that each block can be themed separately; so 
if what you want is to separate and/or otherwise theme the book(s) 
block(s) to distinguish them from regular blocks, this is perfectly 
possible. I would be glad to help with this, if you shared more 
specifically how you would like those menu blocks to look like. :)

All IMHO and FWIW disclaimers apply. :)

Cheers,

Jorge

-----------------------------------------------------------------------
haiku-web@xxxxxxxxxxxxx - Haiku Web & Developer Support Discussion List

Other related posts: