知识卡片
纯文本标记分离内容与呈现
reStructuredText用可读源文本描述层级、强调、代码和链接,再由Docutils等工具生成HTML或其他输出。维护源文件有助于版本控制与多格式发布,但输出是否正确仍取决于语法、转换器和构建配置。教材rst2html.py和安装命令展示当时工具入口,本次没有安装或运行转换。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元010;来源项目book-sources,extracted/Python编程精进(第1辑)(套装共3册)(异步图书)/_epub-src/OEBPS/text00017.html。
- 结论依据:原文reST源可读并通过工具生成输出,支持源维护与呈现分开;转换结果仍依语法及构建配置,工具命令未执行。补充核验入口:https://docutils.sourceforge.io/docs/user/rst/quickref.html。未在本机运行示例或改变环境。
- 原始内容:包的纯文本标记语言。reST的优势在于,文本仍然可读,因为标记语法不会像LaTeX那样混淆文本。 这里有一个文档示例,如下所示: ===== Title ===== Section 1 ========= This *wo