Sphinx Ref Helper

此插件适用于Sublime Text 3。它会搜索给定窗口中任何打开的文件夹中的Sphinx内部文档参考标签。它将在快速面板中显示发现的每个标签（以及找到的文件）。如果您选择其中一个（无论是通过点击还是按回车键），它将在您正在编辑的文档中当前位置插入正确的 :ref:``。请注意，此插件独立运行，不需要安装Sphinx或生成交档。

建议在任一窗口中只打开一个Sphinx文档项目文件夹。

如何使用

1. 使用“打开文件夹”打开Sphinx项目。如果存在 conf.py，插件会尝试检查是否存在“排除模式”以避免。
2. 将光标置于您想插入 :ref:`` 的位置。
3. 输入（主要 + 1 - 在Windows/Linux中为“ctrl键”，在MacOS中为“⌘键”）。
4. 从列表中选择要插入当前光标位置的参考。

手动安装

1. 打开Sublime Text 3。
2. 转到“偏好设置”并点击“浏览包”。
3. 双击“User”目录。
4. 将两个文件拖放到“User”目录中。

限制

此插件是为帮助我处理可能不熟悉的Sphinx文档项目而创建的。因此，它旨在方便使用，并仍在开发中。

• 尽量只打开包含Sphinx项目的文件夹。打开系统根目录将是个糟糕的想法，可能会导致Sublime Text停止响应。请不要尝试。
• 在同一窗口中打开多个文件夹将存在问题，因为插件仅编码为查看第一个文件夹。这对我来说没问题，但可能对您不起作用。在我看来，在项目间共享引用可能会令人困惑。
• 我添加了一些代码来去除http链接引用。然而，如果您的链接分多行，它们将出现在列表中。由于许多这些链接只有在创建它们的文件内才可用，请小心。
• 可能还有一些我遗漏的东西。请随时协助。