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

2009/3/12 Jorge G. Mare <koki@xxxxxxxxxxxxx>:
> 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. :)

Sure! I think with this the best approach is just trying several
things and seeing what works best. What do you need in terms of
access/files to play with it?

(more in another message).

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

Other related posts: