document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2024-12-23 21:20:42 +08:00
Code Issues Packages Projects Releases Wiki Activity

PRF:20190107 Getting started with Pelican- A Python-based static site generator.md

Browse Source 
@MjSeven
This commit is contained in:
Xingyu.Wang 2019-01-23 23:23:27 +08:00
parent 4d24dfe50e
commit 4e7ebb3b07
1 changed files with 29 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
translated/tech/20190107 Getting started with Pelican- A Python-based static site generator.md
View File

@ -1,27 +1,28 @@
[#]: collector: (lujun9972)
[#]: translator: (MjSeven)
[#]: reviewer: ( )
[#]: reviewer: (wxy)
[#]: publisher: ( )
[#]: url: ( )
[#]: subject: (Getting started with Pelican: A Python-based static site generator)
[#]: via: (https://opensource.com/article/19/1/getting-started-pelican)
[#]: author: (Craig Sebenik https://opensource.com/users/craig5)
Pelican 简介：一个 Python 静态网站生成器
Pelican 入门：一个 Python 静态网站生成器
======
Pelican 是那些想要自我托管简单网站或博客的 Python 用户的绝佳选择。
> Pelican 是那些想要自我托管简单网站或博客的 Python 用户的绝佳选择。
![](https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/web-design-monitor-website.png?itok=yUK7_qR0)
如果你想创建一个自定义网站或博客，有很多选择。许多提供商将托管你的网站并为你完成大部分工作。（WordPress 是一个非常受欢迎的选项。）但是使用托管方案，你会失去一些灵活性。作为一名软件开发人员，我更喜欢管理我自己的服务器，并在我的网站如何运行方面保持更多的自由。
如果你想创建一个自定义网站或博客，有很多选择。许多提供商可以托管你的网站并为你完成大部分工作。（WordPress 是一个非常受欢迎的选项。）但是使用托管方式，你会失去一些灵活性。作为一名软件开发人员，我更喜欢管理我自己的服务器，并在我的网站如何运行方面保持更多的自由。
然而，管理 Web 服务器需要大量的工作。安装它并获得一个简单的应用程序来提供内容是非常容易的。但是，维护安全补丁和更新是非常耗时得。如果你只想提供静态网页，那么拥有一个 Web 服务器和一系列应用程序可能会得不偿失。手动创建 HTML 页面也不是一个好选择。
这是静态网站生成器的用武之地。这些应用程序使用模板来创建所需的静态页面，并将它们与关联的元数据交叉链接。（例如，所有显示的页面都带有公共标签或关键词。）静态网站生成器可以帮助你使用导航区域，页眉和页脚等元素创建一个具有公共外观的网站。
这是静态网站生成器的用武之地。这些应用程序使用模板来创建所需的静态页面，并将它们与关联的元数据交叉链接。（例如，所有显示的页面都带有公共标签或关键词。）静态网站生成器可以帮助你使用导航区域、页眉和页脚等元素创建一个具有公共外观的网站。
我使用 [Pyhton][1] 已经很多年了，所以，当我第一次开始寻找生成静态 HTML 页面的东西时，我想要用 Python 编写的东西。主要原因是我经常想要了解应用程序如何工作的内部细节，而使用一种我已经了解的语言使这一点更容易。（如果这对你不重要或者你不使用 Python，那么还有一些其他很棒的[静态网站生成器][2]，它们使用 Ruby, JavaScript 和其它语言。）
我使用 [Pyhton][1] 已经很多年了，所以，当我第一次开始寻找生成静态 HTML 页面的东西时，我想要用 Python 编写的东西。主要原因是我经常想要了解应用程序如何工作的内部细节，而使用一种我已经了解的语言使这一点更容易。（如果这对你不重要或者你不使用 Python，那么还有一些其他很棒的[静态网站生成器][2]，它们使用 Ruby、JavaScript 和其它语言。）
我决定试试 [Pelican][3]。它是一个用 Python 编写的常用静态网站生成器。它支持 [reStructuredText][4]（译注：这是一种用于文本数据的文件格式，主要用于 Python 社区的技术文档），并且支持 [Markdown][5]，这需要通过安装必需的包来完成。所有任务都是通过命令行界面（CLI）工具执行的，这使得熟悉命令行的任何人都可以轻松完成。它简单的 quickstart CLI 工具使得创建一个网站非常容易。
我决定试试 [Pelican][3]。它是一个用 Python 编写的常用静态网站生成器。它支持 [reStructuredText][4]（LCTT 译注：这是一种用于文本数据的文件格式，主要用于 Python 社区的技术文档），并且也支持 [Markdown][5]，这需要通过安装必需的包来完成。所有任务都是通过命令行界面（CLI）工具执行的，这使得熟悉命令行的任何人都可以轻松完成。它简单的 quickstart CLI 工具使得创建一个网站非常容易。
在本文中，我将介绍如何安装 Pelican 4，添加一篇文章以及更改默认主题。（注意：我是在 MacOS 上开发的，使用其它 Unix/Linux 实验结果都将相同，但我没有 Windows 主机可以测试。）
@ -42,9 +43,7 @@ Collecting pelican
Successfully installed MarkupSafe-1.1.0 blinker-1.4 docutils-0.14 feedgenerator-1.9 jinja2-2.10 pelican-4.0.1 pygments-2.3.1 python-dateutil-2.7.5 pytz-2018.7 six-1.12.0 unidecode-1.0.23
```
为了简单起见，我输入了标题和作者的名字，并对 URL 前缀和文章分页选择了 N。（对于其它选项，我使用了默认值。）
Pelican 的 quickstart CLI 工具将创建基本布局和一些文件来帮助你开始，运行 **pelican-quickstart** 命令。为了简单起见，我输入了**标题**和**作者**的名字，并对 URL 前缀和文章分页选择了 N。稍后在配置文件中更改这些设置非常容易。
Pelican 的 quickstart CLI 工具将创建基本布局和一些文件来帮助你开始，运行 `pelican-quickstart` 命令。为了简单起见，我输入了**网站标题**和**作者**的名字，并对 URL 前缀和文章分页选择了 “N”。（对于其它选项，我使用了默认值。）稍后在配置文件中更改这些设置非常容易。
```
$ ./venv/bin/pelicanquickstart
@ -73,18 +72,19 @@ Done. Your new project is available at /Users/craig/tmp/pelican/test-site
你需要启动的所有文件都准备好了。
quickstart 默认为欧洲/巴黎时区，所以在继续之前更改一下。在你喜欢的文本编辑器中打开 **pelicanconf.py** 文件，寻找 **TIMEZONE** 变量。
quickstart 默认为欧洲/巴黎时区，所以在继续之前更改一下。在你喜欢的文本编辑器中打开 `pelicanconf.py` 文件，寻找 `TIMEZONE` 变量。
```
TIMEZONE = 'Europe/Paris'
```
将其改为 **UTC**。
将其改为 `UTC`。
```
TIMEZONE = 'UTC'
```
要更新公共设置，在 **pelicanconf.py** 中查找 **SOCIAL** 变量。
要更新公共设置，在 `pelicanconf.py` 中查找 `SOCIAL` 变量。
```
SOCIAL = (('You can add links in your config file', '#'),
@ -97,9 +97,9 @@ SOCIAL = (('You can add links in your config file', '#'),
SOCIAL = (('Twitter (#craigs55)', 'https://twitter.com/craigs55'),)
```
注意后面的逗号，它很重要。这个逗号将帮助 Python 识别变量实际上是一个集合。确保你没有删除这个逗号。
注意末尾的逗号，它很重要。这个逗号将帮助 Python 识别变量实际上是一个集合。确保你没有删除这个逗号。
现在你已经有了网站的基本知识。quickstart 创建了一个包含许多目标的 Makefile。将 **devserver** 传给 **make** 命令将在你的计算机上启动一个开发服务器，以便你可以预览所有内容。Makefile 中使用的 CLI 命令是 **PATH** 的一部分，因此你需要首先激活 **virtualenv**。
现在你已经有了网站的基本知识。quickstart 创建了一个包含许多目标的 `Makefile`。将 `devserver` 传给 `make` 命令将在你的计算机上启动一个开发服务器，以便你可以预览所有内容。`Makefile` 中使用的 CLI 命令假定放在 `PATH` 搜索路径中，因此你需要首先激活该虚拟环境。
```
$ source ./venv/bin/activate
@ -119,11 +119,11 @@ Done: Processed 0 articles, 0 drafts, 0 pages, 0 hidden pages and 0 draft pages
![](https://opensource.com/sites/default/files/uploads/pelican_test-site1.png)
你可以在右侧看到 Twitter 链接，左侧有 Pelican, Python 和 Jinja 的一些链接。（Jinja 是 Pelican 可以使用的一种很棒的模板语言。你可以在 [Jinja 的文档][7]中了解更多相关信息。）
你可以在右侧看到 Twitter 链接，左侧有 Pelican、Python 和 Jinja 的一些链接。（Jinja 是 Pelican 可以使用的一种很棒的模板语言。你可以在 [Jinja 的文档][7]中了解更多相关信息。）
### 添加内容
现在你又了一个基本的网站，试着添加一些内容。首先，将名为 **welcome.rst** 的文件添加到网站的 **content** 目录中。在你喜欢的文本编辑器中，使用以下文本创建一个文件：
现在你又了一个基本的网站，试着添加一些内容。首先，将名为 `welcome.rst` 的文件添加到网站的 `content` 目录中。在你喜欢的文本编辑器中，使用以下文本创建一个文件：
```
$ pwd
@ -144,9 +144,9 @@ Welcome to my blog.
This is a short page just to show how to put up a static page.
```
Pelican 会自动解析元数据行，包括日期，标签等。
Pelican 会自动解析元数据行，包括日期、标签等。
编写完文件后，**devserver** 应该输出以下内容：
编写完文件后，开发服务器应该输出以下内容：
```
-> Modified: content. regenerating...
@ -157,13 +157,13 @@ Done: Processed 1 article, 0 drafts, 0 pages, 0 hidden pages and 0 draft pages i
![](https://opensource.com/sites/default/files/uploads/pelican_test-site2.png)
元数据（例如日期和标签）会自动添加到页面中。此外，Pelican 会自动检测到 **intro** 类别，并将该部分添加到顶部导航中。
元数据（例如日期和标签）会自动添加到页面中。此外，Pelican 会自动检测到 intro 栏目，并将该部分添加到顶部导航中。
### 更改主题
使用像 Pelican 这样流行的开源软件的好处之一是，非常多的用户将进行更改并将其贡献给项目。许多都是以主题形式贡献的。
使用像 Pelican 这样流行的开源软件的好处之一是，非常多的用户会做出更改并将其贡献给项目。许多都是以主题形式贡献的。
网站的主题会设置颜色，布局选项等。尝试一个新主题非常容易，你可以在 [Pelican 主题][8]中预览其中的许多内容。
网站的主题会设置颜色、布局选项等。尝试一个新主题非常容易，你可以在 [Pelican 主题][8]中预览其中的许多内容。
首先，克隆 GitHub 仓库:
@ -175,16 +175,17 @@ Cloning into 'pelicanthemes'...
我喜欢蓝色，那么试试 [blueidea][9]。
编辑 **pelicanconf.py** ，添加以下行：
编辑 `pelicanconf.py`，添加以下行：
```
THEME = '/Users/craig/tmp/pelican/pelican-themes/blueidea/'
```
**devserver** 将重新生成你的输出。在浏览器中刷新网页来查看新主题。
开发服务器将重新生成你的输出。在浏览器中刷新网页来查看新主题。
![](https://opensource.com/sites/default/files/uploads/pelican_test-site3.png)
主题控制布局的方方面面。例如，在默认主题中，你可以看到文章旁边带有元标记的类别（Intro），但这个类别并未显示在 blueidea 主题中。
主题控制布局的方方面面。例如，在默认主题中，你可以看到文章旁边带有元标记的栏目（Intro），但这个栏目并未显示在 blueidea 主题中。
### 其他考虑因素
@ -192,9 +193,9 @@ THEME = '/Users/craig/tmp/pelican/pelican-themes/blueidea/'
首先，我对迁移到静态站点犹豫不决的一个原因是它无法对文章评论。幸运的是，有一些第三方服务商将为你提供评论功能。我目前正在关注的是 [Disqus][10]。
接下来，上面的所有内容都是在我的本地机器上完成的。如果我希望其他人查看我的网站，我将不得不将预先生成的 HTML 文件上传到某个地方。如果你查看 **pelican-quickstart** 输出，你将看到使用 FTP, SSH, S3 甚至 GitHub 页面的选项，每个选项都有其优点和缺点。但是，如果我必须选择一个，那么我可能会选择发布到 GitHub 页面。
接下来，上面的所有内容都是在我的本地机器上完成的。如果我希望其他人查看我的网站，我将不得不将预先生成的 HTML 文件上传到某个地方。如果你查看 `pelican-quickstart` 输出，你将看到使用 FTP、 SSH、S3 甚至 GitHub 页面的选项，每个选项都有其优点和缺点。但是，如果我必须选择一个，那么我可能会选择发布到 GitHub 页面。
Pelican 还有许多其他功能，以至于我每天都在学习它。如果你想自托管一个网站或博客，内容简单并且是静态内容，同时你想使用 Python，那么 Pelican 是一个很好的选择。它有一个活跃的用户社区，可以修复 bug，添加特性，而且还会创建新的和有趣的主题。试试看吧！
Pelican 还有许多其他功能，我每天都在学习它。如果你想自托管一个网站或博客，内容简单并且是静态内容，同时你想使用 Python，那么 Pelican 是一个很好的选择。它有一个活跃的用户社区，可以修复 bug，添加特性，而且还会创建新的和有趣的主题。试试看吧！
--------------------------------------------------------------------------------
@ -203,7 +204,7 @@ via: https://opensource.com/article/19/1/getting-started-pelican
作者：[Craig Sebenik][a]
选题：[lujun9972][b]
译者：[MjSeven](https://github.com/MjSeven)
校对：[校对者ID](https://github.com/校对者ID)
校对：[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出