pasdoc · GitHub

I just pushed a huge change of PasDoc HTML output look. Hope you like it -- let me know in the comments! Details:

  • Looks modern, based on Bootstrap, with consistent additional CSS

  • Looks good on mobile too, with sidebar going off-screen, hamburger menu button invoking the sidebar

  • Based on latest Bootstrap as of today, 5.3.8, with easy script to always upgrade to latest version

  • Old style preserved in pasdoc-up-to-0.16.0.css , you can use it like --css source/component/alternative_css/pasdoc-up-to-0.16.0.css to get back old look.

  • Visibility shown by name and (in default CSS) as a nice "pill". This seems nicer to me: no need to remember (or recognize, for us colorblind people :) ) the colors. No need to click on any "legend.html". I experimented also with 2 or 4 letter abbreviations like "Publ", but existing visibility names have poor abbreviations when in comes to uniqueness.

  • New --css-based-on-bootstrap to indicate custom CSS that is using Bootstrap CSS as a base. For backward compatibility, --css disables using Boostrap CSS. Documented on updated https://pasdoc.github.io/CssOption

  • Don't show sections not in SectionsAvailable, looks better (simpler page output).

Try it out:

Disclosure: The CSS has been designed with the help of Claude Code. It is a much better web designer than me :)

I provided instructions to base it on the latest Bootstrap, did a review (following also my own guidelines to "be careful" on https://castle-engine.io/ai ) and various fixes and tweaks (to make the --css work as before (thanks to compat classes in HTML), fixing --title, restoring comments... etc.). The AI made mistakes, as always, but made a useful starting point in this redesign (I think).

Read the original on github.com ↗