sphinx-doc/sphinx

LaTeX: Don't mix booktabs with zebra stripes!

Open

#10,997 opened on Nov 27, 2022

View on GitHub
 (9 comments) (0 reactions) (0 assignees)Python (1,985 forks)batch import
builder:latexhelp wantedtype:proposal

Repository metrics

Stars
 (5,625 stars)
PR merge metrics
 (Avg merge 10d 11h) (11 merged PRs in 30d)

Description

Describe the bug

I like the new booktabs feature!

I'm not a fan of the zebra stripes, but I guess they are still better than the boring old tables.

But mixing the two is a no-go! That's absolutely ugly!

The idea of the booktabs style is to remove distracting lines, so it is very much counter productive to add big fat background colors to that.

How to Reproduce

Build docs containing a table with the LaTeX builder.

Environment Information

master

Sphinx extensions

No response

Additional context

No response

Contributor guide

Research direction
Examine the Sphinx LaTeX writer code to understand how booktabs and zebra stripes are applied. Look for the addition of 'rowcolors' or 'cmidrule' in the generated LaTeX and ensure they are not used together.
Tech stack
python
Domain
documentation
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
PythonLaTeX
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50