readthedocs/sphinx_rtd_theme

Use flexible layout for hlist directives

Open

#1,108 创建于 2021年4月1日

在 GitHub 查看
 (1 评论) (0 反应) (0 负责人)CSS (3,473 star) (1,413 fork)batch import
AcceptedBugDesignGood First IssueNeeded: patch

描述

Problem

The current hlist can look bad on mobile or when using many columns.

Reproducible Project

https://docs.blender.org/api/current/bpy.types.AlphaUnderSequence.html

Error Logs/Results

image

As you can see the list items extend beyond viewport when the viewport is narrow.

Expected Results

The columns should break into new rows.

Environment Info

  • Python Version: 3.9.x
  • Sphinx Version: 3.5.1
  • RTD Theme Version: 0.5.1

贡献者指南

技术栈
csshtml
领域
frontend
议题类型
bug
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
under 1 hour
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
fresh
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
CSS flexboxSphinx theme structure
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
85
研究方向
In the sphinx rtd theme, the hlist directive renders columns using a fixed width. To fix the overflow on narrow viewports, modify the CSS for `.hlist` to use `display: flex; flex wrap: wrap;` instead of the current column layout. Examine the theme's CSS files (e.g., `sphinx rtd theme/static/css/theme.css`) for the hlist styles and apply the flexible layout. Test with a narrow viewport to ensure items wrap correctly.