readthedocs/sphinx_rtd_theme

Inconsistent vertical spacing in nested lists

Open

#996 opened on Sep 6, 2020

View on GitHub
 (1 comment) (5 reactions) (0 assignees)CSS (3,473 stars) (1,413 forks)batch import
Good First IssueImprovement

Description

Problem

The vertical spacing is inconsistent in nested lists. A blank line is left at the beginning of the second level, but no blank line when we return to the first level.

Reproducible Project

From the RTD theme documentation itself:


- I kept saying that, "deeper down the rabbit hole". `yahoo <http://www.yahoo.com>`_

  - I cackle at night `yahoo <http://www.yahoo.com>`_.
- I'm so lonely here in GZ ``guangzhou``

Note: Adding additional blank lines doesn't help

Error Logs/Results

image

Expected Results

Either

  • No space before "I cackle at night yahoo"
  • Also space after "I cackle at night yahoo"

Sepculation

The relevant CSS code is

.rst-content .section ul p {
    margin-bottom: 12px;
}


.rst-content .section ul li p:last-child {
    margin-bottom: 0;
}

Contributor guide

Tech stack
css
Domain
frontend
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85
Research direction
The issue is about inconsistent vertical spacing in nested lists. The relevant CSS is in the theme's stylesheet, specifically `.rst content .section ul p` and `.rst content .section ul li p:last child`. The fix likely involves adjusting the margin for nested list items. Look at the theme's CSS files, such as `sphinx rtd theme/static/css/theme.css`, and ensure that nested list items have consistent spacing. No linked PRs or further comments.