Pelican 入门：一个 Python 静态网站生成器

如果你想创建一个自定义网站或博客，有很多选择。许多提供商可以托管你的网站并为你完成大部分工作。（WordPress 是一个非常受欢迎的选项。）但是使用托管方式，你会失去一些灵活性。作为一名软件开发人员，我更喜欢管理我自己的服务器，并在我的网站如何运行方面保持更多的自由。

然而，管理 Web 服务器需要大量的工作。安装它并获得一个简单的应用程序来提供内容是非常容易的。但是，维护安全补丁和更新是非常耗时得。如果你只想提供静态网页，那么拥有一个 Web 服务器和一系列应用程序可能会得不偿失。手动创建 HTML 页面也不是一个好选择。

这是静态网站生成器的用武之地。这些应用程序使用模板来创建所需的静态页面，并将它们与关联的元数据交叉链接。（例如，所有显示的页面都带有公共标签或关键词。）静态网站生成器可以帮助你使用导航区域、页眉和页脚等元素创建一个具有公共外观的网站。

我使用 Pyhton 已经很多年了，所以，当我第一次开始寻找生成静态 HTML 页面的东西时，我想要用 Python 编写的东西。主要原因是我经常想要了解应用程序如何工作的内部细节，而使用一种我已经了解的语言使这一点更容易。（如果这对你不重要或者你不使用 Python，那么还有一些其他很棒的 静态网站生成器 ，它们使用 Ruby、JavaScript 和其它语言。）

我决定试试 Pelican 。它是一个用 Python 编写的常用静态网站生成器。它支持 reStructuredText （LCTT 译注：这是一种用于文本数据的文件格式，主要用于 Python 社区的技术文档），并且也支持 Markdown ，这需要通过安装必需的包来完成。所有任务都是通过命令行界面（CLI）工具执行的，这使得熟悉命令行的任何人都可以轻松完成。它简单的 quickstart CLI 工具使得创建一个网站非常容易。

在本文中，我将介绍如何安装 Pelican 4，添加一篇文章以及更改默认主题。（注意：我是在 MacOS 上开发的，使用其它 Unix/Linux 实验结果都将相同，但我没有 Windows 主机可以测试。）

安装和配置

第一步是创建一个 虚拟环境 ，在虚拟环境中安装 Pelican。

Pelican 的 quickstart CLI 工具将创建基本布局和一些文件来帮助你开始，运行 pelican-quickstart 命令。为了简单起见，我输入了网站标题和作者的名字，并对 URL 前缀和文章分页选择了 “N”。（对于其它选项，我使用了默认值。）稍后在配置文件中更改这些设置非常容易。

你需要启动的所有文件都准备好了。

quickstart 默认为欧洲/巴黎时区，所以在继续之前更改一下。在你喜欢的文本编辑器中打开 pelicanconf.py 文件，寻找 TIMEZONE 变量。

将其改为 UTC。

要更新公共设置，在 pelicanconf.py 中查找 SOCIAL 变量。

我将添加一个我的 Twitter 账户链接。

注意末尾的逗号，它很重要。这个逗号将帮助 Python 识别变量实际上是一个集合。确保你没有删除这个逗号。

现在你已经有了网站的基本知识。quickstart 创建了一个包含许多目标的 Makefile。将 devserver 传给 make 命令将在你的计算机上启动一个开发服务器，以便你可以预览所有内容。Makefile 中使用的 CLI 命令假定放在 PATH 搜索路径中，因此你需要首先激活该虚拟环境。

在你最喜欢的浏览器中打开 http://localhost:8000 来查看你的简单测试博客。

你可以在右侧看到 Twitter 链接，左侧有 Pelican、Python 和 Jinja 的一些链接。（Jinja 是 Pelican 可以使用的一种很棒的模板语言。你可以在 Jinja 的文档 中了解更多相关信息。）

添加内容

现在你又了一个基本的网站，试着添加一些内容。首先，将名为 welcome.rst 的文件添加到网站的 content 目录中。在你喜欢的文本编辑器中，使用以下文本创建一个文件：

Pelican 会自动解析元数据行，包括日期、标签等。

编写完文件后，开发服务器应该输出以下内容：

在浏览器中刷新你的测试网站来查看更改。

元数据（例如日期和标签）会自动添加到页面中。此外，Pelican 会自动检测到 intro 栏目，并将该部分添加到顶部导航中。

更改主题

使用像 Pelican 这样流行的开源软件的好处之一是，非常多的用户会做出更改并将其贡献给项目。许多都是以主题形式贡献的。

网站的主题会设置颜色、布局选项等。尝试一个新主题非常容易，你可以在 Pelican 主题 中预览其中的许多内容。

首先，克隆 GitHub 仓库:

我喜欢蓝色，那么试试 blueidea 。

编辑 pelicanconf.py，添加以下行：

开发服务器将重新生成你的输出。在浏览器中刷新网页来查看新主题。

主题控制布局的方方面面。例如，在默认主题中，你可以看到文章旁边带有元标记的栏目（Intro），但这个栏目并未显示在 blueidea 主题中。

其他考虑因素

本文是对 Pelican 的快速介绍，所以我并没有涉及一些重要的主题。

首先，我对迁移到静态站点犹豫不决的一个原因是它无法对文章评论。幸运的是，有一些第三方服务商将为你提供评论功能。我目前正在关注的是 Disqus 。

接下来，上面的所有内容都是在我的本地机器上完成的。如果我希望其他人查看我的网站，我将不得不将预先生成的 HTML 文件上传到某个地方。如果你查看 pelican-quickstart 输出，你将看到使用 FTP、 SSH、S3 甚至 GitHub 页面的选项，每个选项都有其优点和缺点。但是，如果我必须选择一个，那么我可能会选择发布到 GitHub 页面。

Pelican 还有许多其他功能，我每天都在学习它。如果你想自托管一个网站或博客，内容简单并且是静态内容，同时你想使用 Python，那么 Pelican 是一个很好的选择。它有一个活跃的用户社区，可以修复 bug，添加特性，而且还会创建新的和有趣的主题。试试看吧！

via: https://opensource.com/article/19/1/getting-started-pelican

作者： Craig Sebenik 选题： lujun9972 译者： MjSeven 校对： wxy

本文由 LCTT 原创编译， Linux中国 荣誉推出

点击“了解更多”可访问文内链接

WordPress Feed订阅中如何添加自定义内容

　　我不知道是否还有很多人还在用订阅 Rss Feed 订阅，目前，有100多个高质量的订阅源，主要是关于WordPress和前端的。

　　WordPress可以在“设置 – 阅读”界面上设置相关的Feed设置：

　　默认情况下，只输出与内容相关的部分(标题、作者、文章正文或摘要等)，并且没有其他自定义内容，如果我们想要向Feed输出添加自定义内容，我们如何实现它？

　　1.使用插件

　　在大多数情况下，使用插件是向WordPressRSS/Feed添加自定义内容的最简单方法。只需安装、激活和添加内容即可。这里推荐使用Simple Custom Content插件。实际上，此插件不仅可以向Feed添加自定义内容，还可以通过简单代码在任何地方添加内容。

　　2.使用自定义代码

　　插件方法很简单，但是对于一些喜欢处理插件的人或开发人员来说，以代码的方式添加插件可能更灵活。

　　常用代码如下：

　　// 添加自定义内容到所有 Feed function wpkj_add_content_to_all_feeds($content) { $before = \'<p>显示在文章内容前的自定义内容</p>\'; $after = \'<p>显示在文章内容后的自定义内容</p>\'; if (is_feed()) { return $before . $content . $after; } else { return $content; } } add_filter(\'the_content_feed\', \'wpkj_add_content_to_all_feeds\');

　　此代码段将指定的自定义内容添加到WordPressfeed中的每一篇文章中。您可以通过将其添加到主题的Functions.php或制作一个简单的插件来使用它。

　　上面的wpkj_add_content_to_all_feed函数代码定义了两个变量，$before和$after，它们对应于本文正文前后的自定义内容，我们可以将其修改为您想要以html格式添加的任何内容。

　　如果只执行wpkj_add_content_to_all_feed函数本身的代码，我们必须通过WordPress的钩子挂载它才能生效。这里我们使用the_content_feed过滤器钩子，它可以修改Feed输出的内容。

　　注意：is_feed()在代码中用作判断，只在Feed输出中添加自定义内容，否则主体将直接显示。这里没有必要，因为我们通过the_content_feed挂载函数，它本身只对Feed输出进行操作。我只想告诉您，您可以做出这样的技术判断。

　　在文本开头的插图中，我们看到可以设置Feed来显示全文或摘要。上面提到的the_content_feed钩子用于全文，如果选择摘要，可以使用the_excerpt_rss钩子。

　　//全文的时候用 add_filter(\'the_content_feed\', \'wpkj_add_content_to_all_feeds\'); //摘要的时候用 add_filter(\'the_excerpt_rss\', \'wpkj_add_content_to_all_feeds\');