Fork me on GitHub

静态网站生成器

静态网站生成器结合标记语言(如 Markdown 或 reStructuredText)以及模板引擎,如 Jinja, 来生成 HTML 文件。这些 HTML 文件可以通过 Web 服务器 或者 内容分发网络 (CDN) 进行部署发布,而无需依赖 WSGI 服务器 等其它东西。

为什么说静态网站生成器很有用?

静态内容文件 如 HTML、CSS 和 JavaScript 文件可以由内容分发网络 (CDN) 来提供服务,以实现高规模及低成本的目标。静态内容网站一旦遇到高并发流量,能很容易地通过 CDN 来提供服务而不会丢失连接。

例如,在Full Stack Python 网站被推到 Hacker News 首页 的那个周末,由于本网站是通过将 GitHub Pages 作为 CDN 来提供服务的,因此并发连接即便接近 400 个时也没有碰到任何问题,如下图所示,该图是在流量井喷期间截取的 Google Analytics 截图。

Example of how static websites scale with a CDN based on Full Stack Python on Hacker News front page traffic.

静态网站生成器是如何工作的?

静态网站生成器允许用户通过使用某种标识语言编写模板文件来创建 HTML 文件。然后静态网站生成器结合标记语言和模板文件来生成 HTML 文件。输出的 HTML 文件不需要手工维护,因为当标签或者模板每次被修改后,它都能重新被创建出来。

例如,如下图所示, Pelican 静态网站生成器能将 reStructuredText 文件和 Jinja2 模板文件作为输入,然后将它们组合并输出一组静态 HTML 文件。

Example of how static site generators work with a markup language and templates.

使用静态网站生成器的缺点是什么?

最大的缺点是: 代码无法在网站生成后执行。你只能使用这些输出文件,因此如果你习惯用传统的 Web 框架 创建 Web 应用的话,你得改变下你的期望。

那些需要数据库来实现的功能,如评论、会话及用户数据,只能通过第三方的服务来提供。例如,如果你想在一个静态网站上添加评论功能,你需要 嵌入 Disqus 的评论框,从而只能完全依赖他们提供的功能。

很多的 Web 应用都不能简单地通过静态网站生成器来生成。但是,静态网站生成器可以用来生成网站的部分内容,并通过 Web 服务器来部署,而网站的其它页面可以由 WSGI 服务器来处理。如果处理得当,这种类型的 Web 应用比那些全部页面都由 WSGI 服务器呈现的应用更具扩展潜力。其增加的复杂度对于你的特定应用来说,可能是值得的,也可能并不值得。

Python 的实现

存在很多用不同的语言实现的静态网站生成器。以下列出的这些主要都是用 Python 编写的。

  • Pelican (源代码) 是一个常用的 Python 静态网站生成器, Full Stack Python 网站就是用它创建的。它的主要模板引擎是 Jinja,并且在默认配置下就支持 Markdown、 reStructuredText 及 AsciiDoc。

  • MkDocs (源代码) 使用 YAML 配置文件,并能将 Markdown 文件和一个可选的主题作为输入来创建一个文档网站。它的模板引擎是 Jinja,但是用户通常不必创建自己的模板,除非该特定的网站真得需要,但是如果是这样的话,采用其它的静态网站生成器可能会更加合适。

  • Nikola (源代码) 支持 reStructuredText、 Markdown 及 Jupyter (IPython) Notebooks 等文件,它能将这些文件与 Mako 或 Jinja2 模板结合来创建静态网站。它同时兼容 Python 2.7 和 3.3。对 Python 2.7 的支持会一直到 2016 年年初,而 Python 3.3 会继续得到支持。

  • Acrylamid (源代码) 使用增量方式来生成静态网站,因此相比每次当输入文件被修改后都重新生成所有页面的生成方式,它处理的更快。

  • Hyde (源代码) 最初是作为 Ruby 流行的 静态网站生成器 Jekyll 的 Python 版本而开始开发的。今天的这个项目已经不是原来的 "Jekyll 克隆版" 了。Hyde 支持 Jinja 及其它的模板语言,它更加注重通过标记文件中的元数据来指示生成器如何产生输出文件。 通过浏览这些 使用了 Hyde 的网站 页面,可以看看用 Hyde 创建的实际网站示例。

  • Grow SDK (源代码) 使用工程(通过叫 pods ),工程中包含一个特殊文件和目录结构,来生成网站。该项目当前停留在 "试验“ 阶段。

  • Lektor (源代码) 是一个 Python 的静态内容管理系统,它可以部署到任何的 Web 服务器上。它的 模板引擎 采用 Jinja2

  • Complexity (源代码) 是一款为喜欢使用 HTML 的人准备的网站生成器。它使用 HTML 来创建模板,同时又从 Jinja 那继承了一些功能。它同时兼容 Python 2.6+、 3.3+ 和 PyPy。

  • Cactus (源代码) 使用 Django 模板引擎,该引擎在创建时就考虑了前端设计人员的需求。它同时兼容 Python 2.x 和 3.x。

开源 Python 静态网站生成器示例

静态网站生成器资源

你还想学习 Python Web 开发的哪些知识?

我已经创建了一个 Python Web 应用,那我如何部署呢?

我想学习如何用框架创建 Python Web 应用。

什么是 Web 应用编程接口(APIs)?

在这里注册以便每月能收到一份邮件资料,内容包含本站的主要更新、教程和 Python 书籍的打折码等。