Re: [ft-devel] Markdown generated with docmaker, and website

I have been working on generating markdown by modifying docmaker,

The generated site with Material theme is available at
https://nikramakrishnan.github.io/freetype-site/ft2-toc/

(Please note that only General Remarks and Core API sections are
available for now).

All the generated markdown files can be found at
https://github.com/nikramakrishnan/freetype-docwriter/tree/master/docs/reference

Some comments:

* I have modified the original material theme to increase the width of
the page, so the navigation should only disappear at a higher zoom
level.

Increasing the width leads to some errors like on the index page. When zoom

is 100% (screen shot attached) lead to partial visibility of text in third column.

Which look Ok on 90% zoom nut looks somewhat empty. But, even at that level side navigation bar seems

heavily penalized, which could be allocated a larger area.

These are some of the quick observation

In Laptop :

At 110% zoom partial visbily of text is resolved due to disappearance of navigation

bar. But again third column go out of boundary when zoom is increased beyond that.

At 110% side bar is containing 'FT' which could be replaced by FreeType logo(attached)

to make it look better. Icon should be used in the tab as used in current website of Freetype.

At 133% zoom there is some bug where I am scrolling the side navigation bar, but

background is being scrolled.

Message will look better if aligned

in center :)

In Mobile:

In mobile device everything is cluster due to displaying three columns. Thus number of

columns to be displayed can be adjusted according to the size of display.

Even the normal zoom level to be font size should be decreases, so that a word don't

take more than one line unlike as it is currently taking.

While scrolling in mobile there is a white(difference is opacity) patch is created due to some bug(attached).

For rest I will look thoroughly btw it looks good :)

Ankit

From:	Ankit Dhankhar
Subject:	Re: [ft-devel] Markdown generated with docmaker, and website
Date:	Thu, 7 Jun 2018 20:45:16 +0530