Re: [ft-devel] Static website themes for API reference

[Werner LEMBERG]

>> It seems that its CSS doesn't handle wide displays gracefully; it
>> is obviously optimized for hand-held devices...
> 
> Agreed, not a very graceful way to handle larger displays, but given
> its very accessible layout at normal zoom level, there has to be
> some compromise.

Has it?  I don't think so.  I rather believe that there is a CSS (or
JavaScript) buglet somewhere: The side panels collapse too early,
probably not handling the browser's window width correctly.

>> > 3) ReadtheDocs theme:
>> > https://nikramakrishnan.github.io/freetype-site/readthedocs/
> 
> Except the "Docs » Core API » FreeType Version", there's not a lot
> of good things in this theme, so I am discarding it as an option.

OK.

> I have added the top navigation in `Material' and `Default' themes,
> and also added the links to the chapter name, which redirects to
> that chapter in the index (toc) page.  This is a single line in
> Markdown, and can be added by docmaker.
> 
> Please have a look at it!

Nice!

> About the tables being boxed and of variable width, I will try
> tweaking the CSS a little bit to see if that can be `unboxed' and
> the width can be fixed.

Thanks.


    Werner