postcss / postcss.org

Official website for PostCSS
https://postcss.org
MIT License
81 stars 50 forks source link

Documentation pages #280

Closed muddv closed 1 year ago

muddv commented 1 year ago

Added a build script to generate documentation pages. For pages to generate properly, please also see pull request to main PostCSS repository.

ai commented 1 year ago

You need to fix CSS linter warnings.

ai commented 1 year ago

Can you also show a screenshot of any new page?

muddv commented 1 year ago

Some screenshots from random pages: image image image Last one is index of docs/ directory, maybe layout needs a bit of work. Working on CSS linter warnings now.

ai commented 1 year ago

Last one is index if docs/ directory, maybe layout needs a bit of work.

We should not render /README.md here in docs/.

Some screenshots from random pages

Text looks ugly. Seems like we have no normal styles with bullets for <ul>. Font for inline <code> are not much what we used in code blocks.

If you need a design inspiration, you can use main page styles and Logux website and its styles.

muddv commented 1 year ago

Okay, will get a different font for the code and make sure bullets will generate with

ai commented 1 year ago

The font for code block is the same as in api pages

The problem is in inline <code>, not code blocks. Look at Root link in first screenshot.

muddv commented 1 year ago

Oh sorry, I see it now, need to change some selectors, because currently inline <code> does not inherit correct fonts

ai commented 1 year ago

Post new screenshots when you will be sure in doc pages design

muddv commented 1 year ago

More screenshots, I tweaked a few thing, should look better now. image image image image image