[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]