Ill table formatting

[nihiluis]

Hi, thank you for the cool library!

I've encountered some table formatting issues.

1. table which is smaller than one page: first page is just left blank
   

2. table which is bigger than one page: first page is filled properly, but table headers are displayed twice
   

[timvink]

Thanks @nihiluis ! Also the issue really helps.

The first is related to a page-break on tables, I can remove that. The second I'll need to look into.

Will fix in next release!

[timvink]

So the first issue is actually a feature, where it tries to avoid having a page break in a table whenever possible. I actually suspect mkdocs-material theme set something like table {page-break-before: avoid;}. I think that behaviour is more appriopriate in most cases.

The duplication of the table heading is specific for mkdocs-material theme:

I tried adding thead { display: table-row; } but that breaks the printing functionality in chrome for me (print preview page disappears).

I'm not a CSS expert, but this might have to do with how data tables are printed. I'm not sure if it can/should be solved in this plugin.

I might need some help here..

[timvink]

@squidfunk This plugin offers some nice printing for mkdocs themes. Do you think printing data tables can be addressed Material for MkDocs (see screenshots above)? Would really appreciate some advice here!

[squidfunk]

Printing from Chrome and Firefox works nicely for me, e.g. here's a Chrome print preview:

I haven't tested with overly long tables, though. I'm currently low on time for these kinds of edge cases. Care to investigate and PR?

[timvink]

I've tried to no avail.., CSS is not my expertise.

What I can do is create a small reproducible example and open an issue in mkdocs-material, to park it for later? Perhaps there is also someone willing&able to work on a PR there?

[squidfunk]

Sure, we can start with an issue with a reproducible case with all plugins removed. If it happens with stock Material, we can and should fix it, if possible. If it's related to this plugin, we could introduce some additional CSS to make it compatible if reasonable, but somebody would have to take the lead and PR then.

[timvink]

I opened squidfunk/mkdocs-material#1939 and included a minimal reproducable example.

Closing this one.

[timvink]

@nihiluis This issue is now solved in mkdocs-material. That package releases very often, so solution should be on pypi soon.

Let me know if you encounter any other issues