知识卡片
标题装饰要保持层级一致
reST用标点装饰线识别章节,某种样式在同一文档中应保持对应层级;上划线加下划线与单下划线也属于不同样式。原书列出的=、-等顺序是习惯,不是解析器统一规定的级别表。装饰线须符合实际标题长度与语法,图9-1只展示示例的渲染层次。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第9章 文档化你的项目 9.2.1 章节结构 · 查看原书依据
它与其级别相关联
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元011;来源项目book-sources,extracted/Python编程精进(第1辑)(套装共3册)(异步图书)/_epub-src/OEBPS/text00017.html。
- 结论依据:原文将装饰样式与级别关联,支持同文档样式一致;列举符号顺序是习惯而非解析器统一固定表。补充核验入口:https://docutils.sourceforge.io/docs/user/rst/quickref.html。未在本机运行示例或改变环境。
- 原始内容: + 、 ^ 。 当一个字符用于章节时,它与其级别相关联,并且必须在整个文档中始终使用。 考虑下面的代码(运行结果参见图9-1),例如: 图9-1 将reStructuredText转换为HTML并在浏览器中渲染 =====