Quansight-Labs / accessible-pygments

♿ Accessible pygments themes
https://quansight-labs.github.io/accessible-pygments/
BSD 3-Clause "New" or "Revised" License
12 stars 5 forks source link

Creating and updating a theme has many steps #34

Open gabalafou opened 9 months ago

gabalafou commented 9 months ago

Working on #33, this is the full set of steps I had to do in order to feel like I fully updated the repo when I updated a theme:

  1. Update the colors in the style.py file
  2. hatch run dev:create_css
  3. hatch run dev:render_html
  4. Pick and choose which updated files to git add, then git restore the irrelevant ones
  5. Update the theme's README file, which requires manually calculating new contrast values for the table in the README
  6. Open one of the example files under test/results/<theme-name>/ in my browser, take a screenshot, save it under a11y_pygments/<theme-name>/images/<theme-name>.png, and then update the link in the theme's README.

Seems to me that more of this could be automated, or at least better documented.

I also get the feeling that some of the file changes could be simplified. It looks like duplicate generated files are getting checked into the repo, for example:

trallard commented 9 months ago

yes! I have been wanting to automate a lot of these steps because there is indeed a looooot to do.