我有一个Obsidian vault版本控制与我的项目的一堆文档。这些文档使用双括号引用其他文档,如:
更多信息请参见[[Roadmap.md]]。
我希望我的文档托管和访问任何人在我的团队,包括非技术人员谁可能不想安装Obsidian。我已经尝试使用MyST-Parser和recoonmark的各种配置与Sphinx生成文档,但无法像我希望的那样将交叉引用转换为构建文档中的链接。
有简单的方法来完成这个吗?
我也在广泛使用Sphinx &黑曜石用于各种出版物。我发现它是一个很好的发布文档的生态系统。我最近遇到了同样的问题,所以我试了一下…
你可以这样安装它:pip install——user git+https://github.com/MacqGit/sphinx-obsidian.git@main#egg=sphinx-obsidian
然后,在Sphinx "conf.py ->extensions"只需将'myst_parser'替换为'sphinx_obsidian'并运行一个简单的编译。'[[]]'应该被很好地编译。
请宽容,因为这是我第一次尝试(也是我第一次试图通过在GitHub上发帖来提供帮助;-)。此外,解决方案也不是那么好,因为Myst-Parser/markdown-it实现不允许在Sphinx环境中轻松扩展'mdit_py_plugins'功能…
如果有什么问题,你可以再来找我。