知识卡片
代码文字块依赖边界与缩进
reST的::引出文字块,内容通常与段落以空行分隔并保持缩进。紧接段落的::可留下一个可见冒号,前面有空格时可去掉标记;图9-3展示代码与正文分离。原书把任何缺空行都绝对说成不渲染过宽,应按具体上下文验证;展示代码不会自动执行或验证结果。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第9章 文档化你的项目 9.2.4 文字块 · 查看原书依据
两个冒号用于标记代码块
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元014;来源项目book-sources,extracted/Python编程精进(第1辑)(套装共3册)(异步图书)/_epub-src/OEBPS/text00017.html。
- 结论依据:原文双冒号与缩进展示文字块边界,支持代码和段落分开;渲染只展示文本,不构成示例已运行的证据。补充核验入口:https://docutils.sourceforge.io/docs/user/rst/quickref.html。未在本机运行示例或改变环境。
- 原始内容:需要呈现一些代码示例时,可以使用文字块。两个冒号用于标记代码块,代码块需要进行缩进,如下所示: This is a code example :: >>> 1 + 1 2 Let's continue our text 特别提示 不