知识卡片

操作参考卡 · 1958.c.12.a.1.kw · 生成模型:未记录

标题装饰要保持层级一致

理解等级:中级

reST用标点装饰线识别章节,某种样式在同一文档中应保持对应层级;上划线加下划线与单下划线也属于不同样式。原书列出的=、-等顺序是习惯,不是解析器统一规定的级别表。装饰线须符合实际标题长度与语法,图9-1只展示示例的渲染层次。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 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并在浏览器中渲染 =====