geekdoc-python-zh/docs/pythonlibrary/ann-python-101-website.md

968 B
Raw Blame History

安:Python 101 网站

原文:https://www.blog.pythonlibrary.org/2017/08/03/ann-python-101-website/

在我的第一本书《Python 101》免费发布后我一直在研究让它的内容也能在网上发布的最佳方式。因为我所有的书都是用 RestructuredText 写的,所以我有几个选择。目前我最终选择了 Sphinx但是将来我可能会选择其他的。

Sphinx 是 Python 语言使用的文档工具,也是 Read the Docs 的主干Read the Docs 是第三方 Python 包的文档网站。我尝试了默认的斯芬克斯主题雪花石膏,但它没有我最想要的两个功能:

  • 移动友好
  • 下一页/上一页按钮,方便章节导航

或者至少它看起来不容易修改以使这些特性可用。所以我最终切换到阅读文档主题,因为它同时具备这两个功能。你可以在以下网址查阅这本书:

http://python101.pythonlibrary.org