PyPI Python 包索引
一级标题是动词开头的祈使句
整页只有一个 h1,文本是:找到、安装并发布 Python 包,用 Python 包索引。
开头是三个动词。主语被省略了,读者默认是自己。这不是名词短语式的站名标题,是一句指令。
字号四十像素,居中排两行,横坐标三百一十五,宽八百一十,纵坐标一百三十八。
站名不在标题里。浏览器标题栏写的是 PyPI 加一个间隔号加 Python 包索引,页脚第一行也是这两个词。
标题下方是一行输入框,再下面一行小字:或者浏览项目。再下面一行:以团队身份发布,请使用组织账号。
三行文字的服务对象不同:第一行给找包的人,第二行给随便看看的人,第三行给要发布包的团队。
统计条里四个数字,精确到个位
蓝色区块下方有一条浅灰横条,四个数字:931,603 个包、10,068,265 个发行版、22,552,550 个文件、1,136,583 个用户。
四个数字都带千分位逗号,不带「约」字,也不写「以上」。这是精确计数,不是估算。
数字后面直接跟英文复数名词,中间没有量词。中文读者会想加一个「个」,原文没有。
四个数字代表了四个层级:包是项目,发行版是版本,文件是下载单元,用户是账号。粒度从粗到细。
四个二级标题,全部在页脚
整页四个二级标题,纵坐标全是九百四十三。页脚容器从纵坐标九百零三开始,高二百九十八。
也就是说,四个 h2 没有一个是正文标题。它们的位置在页面最底部,是页脚四个链接组的组名。
四个组名是:帮助、关于 PyPI、为 PyPI 做贡献、使用 PyPI。字号十七点六像素,比一级标题小了二十二点四像素。
它们各自的祖先链完全一致:页脚内的菜单容器、右栏、内层、页脚。四个都在这条链上,没有例外。
页脚的四个导航块,正好对应四个标题
整页七个导航元素。前两个是同一组站点菜单,第三个是语言下拉,后四个是页脚四个链接组。
四个页脚导航各带一个二级标题,一一对应。所以这四个 h2 不是给正文分节的,是给导航块命名的。
正文里连导航都没有。蓝色区块与浅灰区块之间没有任何 nav 元素,只有 div 与段落。
结果是:一个用标题跳转功能的人,从页面顶部往下按,第一次跳转直接落到页脚。中间一千四百多字没有任何落点。
正文靠色块分区,不靠标题
正文分三段,靠背景色区分。第一段是蓝色通栏,放标题与搜索框。第二段是浅灰细条,放四个统计数字。
第三段是白底,放一段介绍与两个链接。三段之间没有标题、没有分隔线、没有序号,只有底色变化。
这种分法在视觉上清楚,在结构上没有标记。提取正文的工具拿到的是一串连续段落,不知道哪里换段。
统计数字用的是段落标签
四个数字各自包在一个段落里,类名是统计条加数字项。它们不是列表项,也不是定义列表。
四个段落平级,没有外层列表。语义上它们是四句独立的话,不是一组数据。
介绍段里有两处行内链接:一处讲怎么安装包,一处讲怎么打包自己的代码。两处都指向文档站。
整段介绍只有两句:PyPI 是 Python 语言的软件仓库;它帮人找到并安装社区开发与共享的软件。
第一句定义,第二句说用途。两句话里没有出现「官方」两个字,也没有说它由谁批准。
整页只有一个输入框,快捷键写在占位文字里
全页输入框数量是一。类型是文本,不是搜索类型。名字是字母 q,纵坐标二百八十二。
占位文字是:输入斜杠以搜索项目。这里把键盘快捷键写进了输入框提示,而不是写在旁边的小字里。
斜杠在多数站点是路径分隔符,在这页是「把光标送进搜索框」的快捷键。提示语只有一行,用法要靠试。
搜索按钮的可读文字被藏起来了
输入框右侧有一个放大镜按钮,按钮里的文字是「搜索 PyPI」,套了只给读屏软件看的样式。
视觉上只有一个图标,读屏软件念到的是「搜索 PyPI」。旁边还有一个同名的隐藏标签,指向输入框。
这是无障碍的常规做法:图标按钮必须带可读文字,否则读屏用户听到的是「按钮」两个字。
整页没有第二个输入框。注册、登录这些入口在顶部导航里,是链接,不是表单。
十四种语言,世界语排在第四
顶部导航有一个地球图标,点开是语言列表:德语、英语、西班牙语、世界语、法语、葡萄牙语巴西版。
接着是希腊语、俄语、乌克兰语、希伯来语、中文简体、中文繁体、日语、韩语。共十四种。
世界语排在第四位,在法语之前。这个位置按字母序也说得通:德语、英语、西班牙语、世界语,四个词的拉丁字母开头依次是 D、E、E、E。
中文列了两种,简体在前。十四种语言里,只有中文与葡萄牙语带了地区或字体限定。
语言切换在导航里,不在页脚。多数站点把语言放在页脚最底部,这里放在顶部第一层。
页脚四组各五项,整齐得像一张表
四个链接组,每组五个项,共二十项。没有一组是四项或六项,全部五个,齐平。
第一组文档类:PyPI 文档、获取帮助、安装包、上传包、打包用户指南。
第二组运营类:PyPI 博客、基础设施看板、统计、标识与商标、我们的赞助商。
第三组参与类:缺陷与反馈、在 GitHub 上贡献、翻译 PyPI、赞助 PyPI、开发致谢。
第四组规则类:服务条款、报告安全问题、行为准则、隐私声明、可接受使用政策。
页脚开头两行自述,写的是谁在维护
第一行:PyPI 由 Python 软件基金会与 Python 社区开发维护,为 Python 社区服务。
第二行是状态灯:所有系统运行正常。这一行是一个链接,指向状态页,不是静态文字。
再往下是一句捐赠呼吁,一个词加一个感叹号。这是页脚里唯一带情绪的句子。
页脚最后一行是「切换到桌面版」。也就是说,这个页面默认可能是移动版布局,桌面用户被给了退回入口。
整页没有地址,没有电话,没有备案号,没有版权年份。只有机构名与一句维护说明。
这个站点是 Python 第三方包的官方索引,包的元数据与发行文件都由它分发。
一句话记住
标题是一句动词开头的指令,四个二级标题全在页脚。正文一千四百多字,没有一个标题落点。





