python创建网页_Pelican入门：一个Python静态网站生成器

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。

$mkdirtest-site

$cdtest-site

$ python3-m venv venv

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

...

Successfullyinstalled pip-18.1

$./venv/bin/pip install pelican

Collectingpelican

...

SuccessfullyinstalledMarkupSafe-1.1.0blinker-1.4docutils-0.14feedgenerator-1.9jinja2-2.10pelican-4.0.1pygments-2.3.1python-dateutil-2.7.5pytz-2018.7six-1.12.0unidecode-1.0.23

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

$./venv/bin/pelicanquickstart

Welcometo pelicanquickstart v4.0.1.

Thisscriptwill help you create anewPelican-based website.

Pleaseanswer the following questions sothisscriptcan generate the files needed byPelican.

>Wheredoyou want to create yournewweb site?[.]

>Whatwill be the title ofthisweb site?MyTestBlog

>Whowill be the author ofthisweb site?Craig

>Whatwill be thedefaultlanguage ofthisweb site?[en]

>Doyou want to specify a URL prefix?e.g.,https://example.com (Y/n) n

>Doyou want to enable article pagination?(Y/n)n

>Whatisyourtimezone?[Europe/Paris]

>Doyou want to generate a tasks.py/Makefileto automate generationandpublishing?(Y/n)

>Doyou want to upload your websiteusingFTP?(y/N)

>Doyou want to upload your websiteusingSSH?(y/N)

>Doyou want to upload your websiteusingDropbox?(y/N)

>Doyou want to upload your websiteusingS3?(y/N)

>Doyou want to upload your websiteusingRackspaceCloudFiles?(y/N)

>Doyou want to upload your websiteusingGitHubPages?(y/N)

Done.Yournewprojectisavailable at/Users/craig/tmp/pelican/test-site

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

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

TIMEZONE='Europe/Paris'

将其改为 UTC。

TIMEZONE='UTC'

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

SOCIAL=(('You can add links in your config file','#'),

('Another social link','#'),)

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

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

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

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

$ source./venv/bin/activate

$makedevserver

pelican-lr/Users/craig/tmp/pelican/test-site/content o

/Users/craig/tmp/pelican/test-site/output-s/Users/craig/tmp/pelican/test-site/pelicanconf.py

->Modified:theme,settings.regenerating...

WARNING:Novalid files foundincontentforthe active readers:

|BaseReader(static)

|HTMLReader(htm,html)

|RstReader(rst)

Done:Processed0articles,0drafts,0pages,0hidden pagesand0draft pagesin0.18seconds.

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

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

添加内容

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

$pwd

/Users/craig/tmp/pelican/test-site

$catcontent/welcome.rst

Welcometomyblog!

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

:date:2018121608:30

:tags:welcome

:category:Intro

:slug:welcome

:author:Craig

:summary:Welcomedocument

Welcometomyblog.

Thisisashortpage just to show how to put up astaticpage.

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

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

->Modified:content.regenerating...

Done:Processed1article,0drafts,0pages,0hidden pagesand0draft pagesin0.10seconds.

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

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

更改主题

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

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

首先，克隆 GitHub 仓库:

$cd..

$gitclone--recursive https://github.com/getpelican/pelicanthemes

Cloninginto'pelicanthemes'...

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

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

THEME='/Users/craig/tmp/pelican/pelican-themes/blueidea/'

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

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

其他考虑因素

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

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

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

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

【编辑推荐】

【责任编辑：庞桂玉 TEL：（010）68476606】

python创建网页_Pelican入门：一个Python静态网站生成器相关推荐

用html制作编写静态日志,[译] 编写一个小型静态网站生成器
大概有数百个 Python 编写的静态网站生成器(更多的其他语言编写的). 我决定写一个自己的.为什么呢?当我决定把我的博客从Ghost搬迁到别的博客系统,我想找一个最小的.我决定使用 Github ...
pelican搭建静态博客_Pelican入门：基于Python的静态网站生成器
pelican搭建静态博客如果要创建自定义网站或博客,则有很多选择. 许多提供商将托管您的网站,并为您完成许多工作. (WordPress是一个非常受欢迎的选项.)但是,使用托管解决方案会失去一些灵 ...
Python+django网页设计入门（19）：创建新模型扩展自带用户表的字段
公众号送书活动火热进行中:新学期福利,送18本Python图书 ================== 前导课程: Python+django网页设计入门(18):自定义模板过滤器 Python+dja ...
Pelican 入门：一个 Python 静态网站生成器
如果你想创建一个自定义网站或博客,有很多选择.许多提供商可以托管你的网站并为你完成大部分工作.(WordPress 是一个非常受欢迎的选项.)但是使用托管方式,你会失去一些灵活性.作为一名软件开发人员 ...
Python+django网页设计入门（20）：使用WebSocket创建多人在线聊天室
2019年3月8日-10日公众号送书活动:中小学生Python课应该学什么 ================ 前导课程: Python+django网页设计入门(19):创建新模型扩展自带用户表的字段 ...
Python+django网页设计入门（18）：自定义模板过滤器
前导课程: Python+django网页设计入门(17):模板语法及应用 Python+django网页设计入门(16):优化设计复用分页代码 Python+django网页设计入门(15):公用模 ...
Python+django网页设计入门（14）：使用中间件对抗爬虫
前导课程: Python+django网页设计入门(13):表单.修改密码 Python+django网页设计入门(12):使用Bootstrap和jQuery Python+django网页设计入门 ...
Python+django网页设计入门（8）：网站项目文件夹布局
前导课程: Python+django网页设计入门(7):常用ORM操作 Python+django网页设计入门(6):文件上传与数据导入 Python+django网页设计入门(5):自定义用户注册 ...
Python+django网页设计入门（7）：常用ORM操作
前导课程: Python+django网页设计入门(6):文件上传与数据导入 Python+django网页设计入门(5):自定义用户注册与登录功能 Python+django网页设计入门(4):用户 ...

python创建网页_Pelican入门：一个Python静态网站生成器

python创建网页_Pelican入门：一个Python静态网站生成器相关推荐

最新文章

热门文章