在线发布文档

介绍

Sphinx 文档可以在线托管。

升降箱

谷歌驱动器

注解

来源

https://kb.wisc.edu/helpdesk/page.php?id=38083

https://support.google.com/drive/answer/2881970?hl=en

https://developers.google.com/drive/web/publish-site

  1. 在Google Drive中创建文件夹并将其共享为 Public on the Web

    ../_images/GoogleDrive_2.png

  2. 将包含html build、javascript和css文件的文件夹上载到此文件夹。

  3. 找到HTML文件夹的可共享链接并复制唯一标识符

    ../_images/GoogleDrive_3.png

    例如，如果链接是 https://drive.google.com/folderview?id=0B8AmLQ1728LmeHpwbEd1N0U4YTQ&usp=sharing 那么唯一的ID是 0B8AmLQ1728LmeHpwbEd1N0U4YTQ .

  4. 因此，到您的文档的链接将是

    www.googledrive.com/host/the-unique-identifier-that-you-just-copied/index.thml

    例如，这些页面的链接是：

    www.googledrive.com/host/0B8AmLQ1728LmeHpwbEd1N0U4YTQ/index.html

阅读文档

Github.io

注解

来源

http://lucasbardella.com/blog/2010/02/hosting-your-sphinx-docs-in-github

http://daler.github.io/sphinxdoc-test/index.html

关闭Jekill

注解

来源

https://help.github.com/articles/using jekyll with pages关闭jekyll

通过创建一个名为 .nojekyll 在页面存储库的根目录中，将该文件推送到GitHub。

只有当您的站点使用以下划线开头的目录时才需要这样做，因为Jekyll将这些目录视为特殊目录，并且不会将它们复制到最终目的地。

自从 Sphinx 将所有静态文件放入 _static 文件夹，这需要完成，否则样式表等将不会上载到HTML站点。