DrS*_*SAR 16 documentation bitbucket python-sphinx
我有一个包含sphinx生成的文档的python包(使用自动模块功能),它可以被制作成一组静态html页面,位于项目的git存储库中的_build目录中.我想在bitbucket上以漂亮和私密的方式查看此文档.似乎wiki是一个git repo本身可能是可用的.
是否有一个简单的序列步骤可以将我的html文档转换为标记并将其推送到bitbucket wiki存储库？
lit*_*pea 26
不幸的是,这真的不可能......
你可以将你的_build目录推送到wiki仓库,并在wiki(Home.rst)中创建链接到你的html文件,如下所示:
`Sphinx docs <_build/html/index.html>`_
它会显示它们但是包含_static css/js文件将无法正常工作,所以你的文档看起来很难看:(
您也可以将您的文档发布为BitBucket上的网站,但是没有隐私,即使您的回购是私有的,您的文档也会公开,所以这不是很有用,那么您可以去阅读文档 ...
阅读文档实际上支持隐私,因此您可以在私有模式下添加文档并在BitBucket中添加Webhook.不幸的是,这只适用于公共回购,所以不是一个很好的解决方案......
PS有一个可重复使用的应用程序,允许您从django(受保护)私密地提供您的sphinx文档:django-docs ;)并且您可以从您的bitbucket*.rst文件构建那些...