重构文本支持
最后修改时间:2023 年 8 月 24 日除了支持 reStructuredText 文档字符串格式(PEP 287)之外,PyCharm 还为重构文本提供了一个方便的编辑器。
与Markdown 编辑器类似,您可以修改 reStructuredText 文件并在预览面板中验证结果。
您可以打开任何包含重组文本的现有文件,也可以从头开始创建一个新文件。
创建 .rst 文件
在项目工具窗口中右键单击并选择新建| 文件。在打开的对话框中,指定任何具有.rst扩展名的文件名,然后单击“确定”。
PyCharm 可以识别文件类型并用相应的图标进行标记。
新创建的文件将在编辑器中打开。当未添加文本时,预览面板将被禁用。
让我们添加一些内容来看看PyCharm如何辅助编辑重构文本。
编辑文字
在“设置”对话框 ( ) 中,查看 reStructuredText 的默认配色方案(编辑器 | 配色方案 | reStructuredText)。如果需要,为标记元素设置替代颜色和效果。CtrlAlt0S
单击“确定”保存更改并关闭窗口。
添加任何部分结构标记并预览结果。请注意,PyCharm 支持标记检查,因此如果检测到任何错误,有问题的行会在编辑器中突出显示。
使用.. code-block::指令添加代码片段。PyCharm 支持指令名称的代码完成。
您可以通过在指令中指定特定语言来启用代码语法突出显示:.. code-block:: python。另外,请确保您的项目解释器已安装Pygments包。
如果需要,您可以快速标记文本中的链接并推迟添加参考目标。PyCharm 会通知您并突出显示缺少引用的链接。
您所需要做的就是向reStructuredText 文件添加正确的目标引用,例如.. _pytest:
https://docs.pytest.org/ 。
感谢您的反馈意见!
此页面是否有帮助?