posit-dev / great-tables

Make awesome display tables using Python.
https://posit-dev.github.io/great-tables/
MIT License
1.9k stars 71 forks source link

Document or present all styles available in `opt_stylize` #405

Closed knl closed 2 months ago

knl commented 4 months ago

Prework

Proposal

I was looking at how to decorate a polars dataframe, and then discovered this project. Looks and feels amazing, thanks for creating it!

The resulting tables were a bit too spacious for my use case, so I started looking if there is a theme to make them look like default panda frames (ppl in my org are just used to that). Then I discovered opt_stylize, but by reading the documentation I could not understand how different style numbers and colors look like.

Thus, I would like to suggest to update the documentation to have a gallery of all these combinations, so one can quickly spot what they are after.

machow commented 4 months ago

Thanks for raising -- it should be quick to put up a gallery of combinations (either in the API Reference page for opt_stylize or somewhere else). Looking at the 6 templates again, I wonder if it'd be helpful for us to give simple verbal labels to what each theme does?

image

It looks like essentially each theme varies on these dimensions:

@rich-iannone and I meet today, so can look over the examples to try and give them labels. It seems like there may be some slight issues with a couple (like style 2 having a solid grey line), so can lay out any fixes needed!