知识卡片
引用名称要与目标声明对应
reST命名外链把正文引用和.. _name: URL目标对应,含空格的短语引用用反引号而非普通单引号;教材链接示例的引号排版不能直接当准确语法。显式内部目标和章节隐式目标可供回跳,需避免名称冲突。把目标集中在末尾便于维护,但仍应验证实际链接可解析。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第9章 文档化你的项目 9.2.5 链接 · 查看原书依据
它必须用`(反引号)字符包围
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元015;来源项目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 .. _example: :: >>> 1 + 1 2 Let's