Notes and friends generate semantic HTML garbage
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 38/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- php
调研方向
首先检查所引用的 openssl.installation.php 页面生成的 HTML，重点关注 note、caution、warning、tip、title 和 simpara 的处理。将当前结构与 issue 中关于语义化 HTML 的问题进行比较；当 title 具有标题语义，且嵌套的 simpara 得以保留而不是被忽略或折叠时，即表示完成。
由索引模型根据 Issue 内容生成。
描述
I've just noticed that <note> (and likely <caution>, <warning>, and <tip>) especially when having a <title> generate semantic HTML garbage HTML. See e.g. https://www.php.net/manual/en/openssl.installation.php.
<note> yields a <blockquote> which is doubtful per se, but the <title> is just a <strong> element. Instead, we should probably generate a <section> (a div might be a first step in the right direction) ideally with a proper heading for the title. Regarding the latter it might be hard to keep a proper heading structure, but even a gap in the headers appears to be better than misusing a <blockquote>, and a title should be a title.
Also, <simpara>s inside the <note> are apparently ignored/collapsed.
- 主要语言
- PHP
- 星标
- 91
- 派生
- 59
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
php/phd 的其他 Issue
-
难度 4/5 3-5 天 新手友好度 50/100
-
难度 3/5 1-2 天 新手友好度 65/100
-
难度 4/5 3-5 天 新手友好度 35/100
-
难度 4/5 3-5 天 新手友好度 52/100
-
难度 3/5 1-2 天 新手友好度 65/100
相似的 Issue
-
Python 3.15 support可能已有人在做 @amnesiaof 今天认领。 未关闭L: python L: python:uv
难度 2/5 1-3 小时 新手友好度 72/100
dependabot/dependabot-core#16524 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
crazy-goat/rabbit-stream#830 ·
维护者通常 1 天内回复
-
sync-en
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
sync-en
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 4 天内回复
-
Перевод устарел
难度 2/5 1-3 小时 新手友好度 70/100