静态网站生成器

静态网站生成器

静态网站生成器结合标记语言（如 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 静态网站生成器示例

本网站有自己的 GitHub 库并且是完全开源的，基于 MIT 许可发布。快来 Fork 吧！
Django REST 框架使用 MkDocs 来创建它的文档网站。一定要看下 mkdocs.yml 文件，通过它可以了解该项目的这份如此丰富、文风优美的文档是如何组织的。
实践 Web 开发使用 Acrylamid 创建它的网站。它的代码发布在 GitHub 上并且是开源的。
Linux 开放管理日 (Loadsys) 这个网站是开源的，并且可以方便获取。
Pythonic Perambulations 这个博客的主题风格虽然很普通，但是它也是开源的，并且也发布在 GitHub 上。

静态网站生成器资源

使用 Pelican 创建一个静态博客的漫漫之路这篇精彩的文章真正对相关知识进行了深入细致的讲解。
Staticgen 网站上列出了所有编程语言的静态网站生成器，并依据不同的属性进行了排序，如 GitHub 上的 stars 数， fork 数和 issue 数等。
标题起得是有点大，但是这篇文章就为什么说静态网站生成器以后会大有可为这个论点还是论述的非常详实。我想说的是：静态网站生成器已经流行很长一段时间了。
静态网站生成器可以用于创建从小项目和大型站点的各种网站。这篇由 WeWork 发布的文章：为什么他们使用静态网站生成器从一个大公司的角度对其进行了讲解。
放弃 Wordpress 并成为一个时髦的人详述了一个开发者从 Wordpress 转移到使用 Pelican 和 reStructuredText 来创建他的个人博客的经历。
Pelican 和 GitHub pages 入门简介是我写的一篇教程，讲解如何使用 Full Stack Python 的源代码来创建和部署你的首个静态网站。

静态网站部署相关资源

在 AWS 上使用 S3 和 CloudFront 部署一个静态网站上提供了一份非常不错的教程，并附有截图，讲解了任何类型的静态网站如何在 AWS 上使用 S3 和 Cloudfront 进行设置。
使用 S3 和 Cloudflare 部署静态网站讲解了如何设置 S3 存储段，并在前端配置 Cloudflare 作为 CDN，以通过 HTTPS 来提供内容服务。你应该可以使用 Amazon Cloudfront 来实现大致相同的设置，但是作为一个 Cloudflare 用户，我还是喜欢它们的这种静态网站配置服务。
Google Cloud 提供了一篇教程讲解了如何使用它们来部署你的静态网站。值得注意的是你现在还无法在 Google 存储服务器上使用 HTTPS，这是一个很大的遗憾。

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

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

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

什么是 Web 应用编程接口（APIs）？

想找到一个完整的，一步一步的部署方案吗？请看《The Full Stack Python Guide to Deployments》.

邮件获取更新

1. 简介学习编程为什么用 Python？Python 2 还是 3？企业 Python Python Community Best Python Podcasts 最佳 Python 资源最佳 Python 视频 2. 开发环境 Vim Emacs 3. 核心语言生成器推导式 4. Web 开发 Web 框架 Django Flask Bottle Pyramid Morepath 其它 Web 框架 Web 设计级联样式表 (CSS)JavaScript WebSockets 模板引擎 Web 应用安全静态网站生成器 Jinja2 5. 数据关系型数据库 NoSQL 数据存储对象关系映射器 PostgreSQL MySQL SQLite 6. Web APIs API 集成 API 的创建 Twilio 7. 部署服务器平台即服务（PaaS）操作系统 Web 服务器 WSGI 服务器源码控制应用程序依赖静态内容任务队列配置管理持续集成日志监控 Web 分析 Docker 缓存微服务 DevOps Nginx Apache HTTP 服务器 Caddy Green Unicorn (Gunicorn)Ubuntu Pelican Lektor MkDocs 8. 测试单元测试集成测试代码度量调试 9. Meta Bots Change Log Future Directions About the Author SQLAlchemy Peewee …或者显示全部目录内容.

静态网站生成器

重要的更新内容会通过 Twitter 账号@fullstackpython发布。

需要更加详细的教程吗？请看《The Full Stack Python Guide to Deployments》。

Chapters

1. 简介 2. 开发环境 3. 核心语言 4. Web 开发 » 静态网站生成器 5. 数据 6. Web APIs 7. 部署 8. 测试 9. Meta …or view the full table of contents.

This site is based on Matt Makai's project Full Stack Python, thanks for his excellent work!

此网站由 @haiiiiiyun 和开源爱好者们共同维护。若发现错误或想贡献，请访问： Github fullstackpython.cn 项目