[ad_1]
鹈 是一个实用程序，可让您仅使用文本文件创建漂亮的网络日志。 文件可以在 重构文本 或者 降价 格式，这两种格式都很容易学习。 像其他博客软件一样，您可以制作定时帖子和静态页面。 Pelican 支持提要、外部分析工具，并且可以从 WordPress 或其他提要导入。
Github，可以说是世界上最受欢迎的开源代码托管服务，为其托管的项目提供简单、优雅的网站解决方案。 Github 页面 允许用户将页面内容存储在 混帐 存储库以及他们的代码。 通过将 Pelican 与 Github Pages 相结合，您可以为您的项目提供一个可靠且有吸引力的博客站点。
Pelican 可能是一个基于文本的博客工具，但它可以生成漂亮的博客：
鹈鹕博客是完全可主题化的，如上所示； 这个特定的主题被称为 块. 网络上已经有数百种可用，包括响应式和基于引导的。
现在您已经看到了 Pelican 的价值，让我们开始构建站点。 您需要熟悉使用 git 命令才能执行本文中的步骤。
设置 github.io 页面
要创建您的 Github 用户页面，请登录到 Github 并 创建两个新的存储库， 用户名.github.io-src 和 username.github.io， 如 Github 页面所述. （在这些存储库中使用您的 Github 用户名。） username.github.io-src 存储库将保存您博客的源代码，而 username.github.io 存储库将包含 Pelican 生成的输出 HTML 文件。 要将输出目录添加为子模块，请使用 README 文件对其进行初始化。
安装鹈鹕
在 Fedora，这是一个非常非常简单的命令：
sudo dnf install python-pelican
克隆您创建的源存储库：
git clone [email protected]:username/username.github.io-src ghpages
然后将目录更改为站点：
cd ghpages
使用 Pelican 设置博客
使用以下命令仔细检查您是否在源 git 存储库中工作：
git remote -v
您应该看到您正在使用 username.github.io-src 存储库。 然后，将输出存储库克隆为 git 子模块（替换您的 Github 用户名）：
git submodule add [email protected]:username/username.github.io.git output
Pelican 提供了出色的快速启动命令。 运行：
pelican-quickstart
快速入门将询问您各种问题，您可以依次回答这些问题。 以下是您应该给出的一些具体答案：
- 您想在哪里创建新网站？ （打 Enter)
- 网址前缀： https://用户名.github.io
- 生成 Fabfile/Makefile： 是（对于大多数用户）
- 自动重新加载和 simpleHTTP 脚本： 是（对于大多数用户）
- 上传机制： 为除 Github Pages 之外的所有内容选择否
- 这是您的个人页面（username.github.io）吗？ 是的
由于输出目录已存在，您可能会收到一条错误消息。 还行吧。
打开 publishconf.py 文件并将 DELETE_OUTPUT_DIRECTORY 变量设置为 False。 否则，每次发布时，Pelican 都会删除您的子模块，这不是您想要的。
调整
有各种 这里提到的调整和提示 这可能是有趣的。 更方便的调整之一是在 Makefile 中添加了 newpost 命令。
第一篇文章
写一个快速的帖子，在内容文件夹中使用 Markdown 或 reStructured Text 格式。
构建，提交，推送，完成！
完成后，构建您的博客并测试结果：
make html && make serve
这将构建博客，然后在端口 8000 上运行本地网络服务器。 将您的浏览器指向那里 看看你的工作成果。 如果一切正常，生成网站：
make publish
然后将您的文件添加到 git 跟踪、提交并推送到存储库。 由于使用了子模块，您应该在推送源文件之前对输出文件执行此操作。
cd output git add . git commit -m "First post." git push -u origin master cd .. echo '*.pyc' >> .gitignore #don't need pyc files git add . git commit -m "First commit." git push -u origin master
现在，您可以访问 https://username.github.io 并查看您刚刚创建的新站点。
警告和定制
一切都可以在 Pelican 中定制。 首先，您可以选择 一组主题. 还有 一组插件 可帮助您向网站添加各种功能。 当然，您可以编写自己的，或自定义现有的插件和主题。
Pelican 文档引用了一个名为 ghp-pages 的工具，但 Pelican 3.6.0 版本在 Fedora 22 不像这些文档中描述的那样工作。 上面的子模块方法将有助于解决这个问题。
[ad_2]