Pelican,一个基于 Python 的静态站点生成器

关于鹈鹕

在下一篇文章中,我们将看看 Pelican。 对于想要自托管简单网站或博客的 Python 用户来说,这是一个不错的选择。 如果您有兴趣创建自定义网站或博客,今天您有很多选择。 但如果只是 你想提供静态网页,这个静态站点构建器对你很有用. 这些类型的应用程序使用模板来创建用户想要的所有静态页面,并将它们与关联的元数据链接起来。

如果你使用 蟒蛇 你正在寻找一些东西来生成静态 HTML 页面,这个生成器将让你看看它是如何工作的内部结构。 使用您知道的语言可以更轻松。 如果您不喜欢 Python,还有其他使用其他语言的静态站点生成器。

Pelican 是一个常用的用 Python 编写的静态站点生成器。 东 直接支持 reStructuredText的 并且可以支持 Markdown,当安装了所需的包时。 所有任务都通过命令行界面工具(CLI),这对于熟悉它的任何人来说都很简单。 此外,其简单的快速启动工具使创建网站变得非常容易。

Pelican 安装和基本配置

我正在 Ubuntu 20.04 上测试这个程序。 第一步将是 创建一个 的virtualenv 并安装鹈鹕. 这可以通过打开终端(Ctrl + Alt + T)并使用其中的命令来完成:

虚拟环境的创建

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

./venv/bin/pip install --upgrade pip

更新pip后,我们现在可以 安装鹈鹕:

鹈鹕设施

./venv/bin/pip install pelican

运行 pelican-quickstart 命令

安装完成后, Pelican Quick Start CLI 工具将创建基本布局 和一些文件,以便我们可以开始。

为了简单起见,在运行快速入门时,我使用了标题和作者的值并回答了 N 到文章的 url 前缀和分页。 对于剩下的问题, 我使用了默认值. 稍后在配置文件中更改这些设置非常容易。 快速启动可以运行 使用命令:

快速入门鹈鹕

./venv/bin/pelican-quickstart

完成后,我们可以更改设置的某些方面。 我们只需要 在我们最喜欢的文本编辑器中打开 pelicanconf.py 文件.

配置文件

在里面我们可以寻找一行:

TIMEZONE = 'Europe/Paris'

我们可以 更改为您感兴趣的国家/地区的时区.

更新社交链接设置,你必须寻找变量 社会 en 鹈鹕配置文件. 我们可以在其中添加我们的链接,如下所示:

SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)

您应该注意末尾的逗号很重要。 该逗号帮助 Python 识别变量实际上是一个集合。 确保不要删除它。

启动服务器

现在我们有了网站的基础知识,我们可以看到快速入门创建了一个具有各种目标的 Makefile。 其中之一使 devserver 可以在我们的机器上启动一个开发服务器 这样我们就可以预览我们正在创建的一切。 Makefile 中使用的 CLI 命令应该是我们 PATH 的一部分,所以首先 我们必须激活 virtualenv.

启动服务器

source ./venv/bin/activate

make devserver

当它开始时,我们可以 打开我们的浏览器并转到 URL http://localhost:8000 查看已创建的博客。

使用 Pelican 创建的示例页面

添加内容

现在我们有了一个基本站点,我们可以添加一些内容。 第一的, 我们将创建一个名为 欢迎.rst 在内容目录(内容) 的网站.

使用我们最喜欢的文本编辑器, 我们将使用遵循以下结构的文本创建此文件:

在鹈鹕中添加内容

Bienvenid@ a este blog

######################

:date: 20210827 00:03

:tags: bienvenid@

:category: Intro

:slug: bienvenida

:author: ubunlog

:summary: Documento bienvenida

Bienvenid@ a este blog de prueba con Pelican.

Esta es una pequeña página se va a mostrar como página estática.
Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).

写入文件后, 开发服务器应该更新并生成这样的东西:

欢迎文件已添加

重新加载您的测试站点 在浏览器中查看更改。

静态欢迎页面

元数据已自动添加到页面中。 更重要的是, Pelican 自动检测到 Intro 类别并将该部分添加到顶部导航.

改变话题

除了上述所有内容,我们还可以轻松更改主题。 在仓库中 鹈鹕主题,您可以找到用户创建的不同主题. 测试新主题非常容易,您只需从存储库下载它们, 将它们保存在我们的计算机上,并在文件 pelicanconf.py 中添加以下行以及主题的路径:

THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"

devserver 将重新生成其输出。 在浏览器中重新加载网页以查看新主题。

这是对 Pelican 的简短介绍。 所有这些都是在本地机器上完成的。 如果您希望其他人看到您的网站,则必须将预先生成的 HTML 文件上传到服务器. 如果您详细查看输出 鹈鹕快速入门,您将看到使用 FTP、SSH、S3 甚至 GitHub 页面的选项。

它可以项目网站 或在你的 GitHub资料库.


发表您的评论

您的电子邮件地址将不会被发表。 必填字段标有 *

*

*

  1. 负责数据:MiguelÁngelGatón
  2. 数据用途:控制垃圾邮件,注释管理。
  3. 合法性:您的同意
  4. 数据通讯:除非有法律义务,否则不会将数据传达给第三方。
  5. 数据存储:Occentus Networks(EU)托管的数据库
  6. 权利:您可以随时限制,恢复和删除您的信息。