知识卡片

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

代码文字块依赖边界与缩进

理解等级:中级

reST的::引出文字块,内容通常与段落以空行分隔并保持缩进。紧接段落的::可留下一个可见冒号,前面有空格时可去掉标记;图9-3展示代码与正文分离。原书把任何缺空行都绝对说成不渲染过宽,应按具体上下文验证;展示代码不会自动执行或验证结果。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《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 特别提示 不