在线发布文档

介绍

Sphinx 文档可以在线托管。

升降箱

谷歌驱动器

  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

关闭Jekill

注解

来源

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

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

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

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