使用 Pelican 创建博客，这是一个基于 Python 的平台，与 GitHub 配合的不错。

GitHub 是一个非常流行的用于源代码控制的 Web 服务，它使用 Git 同步本地文件和 GitHub 服务器上保留的副本，这样你就可以轻松地共享和备份你的工作。

除了为代码仓库提供用户界面之外，GitHub 还运允许用户直接从仓库发布网页。GitHub 推荐的网站生成软件包是 Jekll，是使用 Ruby 编写的。因为我是 Python 的忠实粉丝，所以我更喜欢 Pelican，这是一个基于 Python 的博客平台，可与 GitHub 很好地协同工作。

Pelican 和 Jekll 都可以将 Markdown 或 reStructuredText 中编写的内容转换为 HTML 以生成静态网站，并且两个生成器都支持定制的主题。

在本文中，我将介绍如何安装 Pelican、设置 GitHub 仓库、运行快速入门帮助、编写一些 Markdown 文件以及发布第一篇博客。我假设你有一个 GitHub 账户，熟悉基础的 Git 命令，并且想使用 Pelican 发布博客。

安装 Pelican 并创建仓库
首先，你必须在本地计算机上安装 Pelican 和 ghp-import。使用 Python 软件包安装工具 pip(你有，对吧?)，这非常容易：

$ pip install pelican ghp-import Markdown
然后，打开浏览器并在 GitHub 上为你新鲜出炉的博客创建一个新仓库，命名如下(在此处以及整个教程中，用 GitHub 用户名替换 username)：

https://GitHub.com/username/username.github.io
让它保持为空，稍后我们用引人注目的博客内容来填充它。

使用命令行(确保正确)，将这个空 Git 仓库克隆到本地计算机：

$ git clone https://GitHub.com/username/username.github.io blog
$ cd blog
奇怪的把戏…
在 GitHub 上发布 Web 内容有一个不太引入注意的技巧，对于托管在名为 username.github.io 的仓库的用户页面，其内容由 master 分支提供服务。

我强烈建议所有的 Pelican 配置文件和原始的 Markdown 文件都不要保留在 master 中，master 中只保留 Web 内容。因此，我将 Pelican 配置和原始内容保留在一个我喜欢称为 content 的单独分支中。(你可以随意创建一个分支，但以下内容沿用 content。)我喜欢这种结构，因为我可以放弃掉 master 中的所有文件，然后用 content 分支重新填充它。

$ git checkout -b content
Switched to a new branch ‘content’
配置 Pelican
现在该进行内容配置了。Pelican 提供了一个很棒的初始化工具 pelican-quickstart，它会询问你有关博客的一系列问题。

$ pelican-quickstart
Welcome to pelican-quickstart v3.7.1.
This script will help you create a new Pelican-based website.
Please answer the following questions so this script can generate the files
needed by Pelican.

Where do you want to create your new web site? [.]
What will be the title of this web site? Super blog
Who will be the author of this web site? username
What will be the default language of this web site? [en]
Do you want to specify a URL prefix? e.g., http://example.com (Y/n) n
Do you want to enable article pagination? (Y/n)
How many articles per page do you want? [10]
What is your time zone? [Europe/Paris] US/Central
Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n) y
Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n) y
Do you want to upload your website using FTP? (y/N) n
Do you want to upload your website using SSH? (y/N) n
Do you want to upload your website using Dropbox? (y/N) n
Do you want to upload your website using S3? (y/N) n
Do you want to upload your website using Rackspace Cloud Files? (y/N) n
Do you want to upload your website using GitHub Pages? (y/N) y
Is this your personal page (username.github.io)? (y/N) y
Done. Your new project is available at /Users/username/blog
你可以对每个问题都采用默认值，但除了以下这些问题：

网站标题，应该唯一且特殊
网站作者，可以是个人用户名或你的全名
时区，可能你不在巴黎
上传到 GitHub 页面，我们选择 y
回答完所有问题后，Pelican 会在当前目录中留下以下内容：

$ ls
Makefile content/ develop_server.sh*
fabfile.py output/ pelicanconf.py
publishconf.py
你可以查看 Pelican 文档来了解如何使用这些文件，但现在我们要做的是完成手头的工作。说实话，我也没有阅读文档。

继续
将所有 Pelican 生成的文件添加到本地 Git 仓库的 content 分支，提交更改，然后将本地更改推送到 Github 上托管的远程仓库：

$ git add .
$ git commit -m ‘initial pelican commit to content’
$ git push origin content
这件事情并不是特别令人兴奋，但是如果我们需要撤销这些文件之一的修改时，这将非常方便。

终于
终于，现在你得到一个博客了!你所有的博客文章、照片、图像、PDF 等都将位于 content 目录中，它最初是空的。要开始创建第一篇博客和关于页面，输入：

$ cd content
$ mkdir pages images
$ cp /Users/username/SecretStash/HotPhotoOfMe.jpg images
$ touch first-post.md
$ touch pages/about.md
接下来，在你喜欢的文本编辑器中打开 first-post.md，并添加以下内容：

title: First Post on My Sweet New Blog
date: <today’s date>
author: Your Name Here

I am On My Way To Internet Fame and Fortune!

This is my first post on my new blog. While not super informative it
should convey my sense of excitement and eagerness to engage with you,
the reader!
前三行是 Pelican 用于组织内容的元数据。有很多不同的元数据可供你选择。再说一次，文档是你了解更多选项的最佳选择。

现在，打开空白文件 pages/about.md 并添加以下文本：

title: About
date: <today’s date>
![So Schmexy][my_sweet_photo]
Hi, I am and I wrote this epic collection of Interweb
wisdom. In days of yore, much of this would have been deemed sorcery
and I would probably have been burned at the stake.
现在，content 目录中将包含三个新的 Web 内容，在 content 分支中还有很多内容。

发布
不要急，马上要见到成果了!

剩下要做的就是：

运行 Pelican 以在 output 中生成静态 HTML 文件：

$ pelican content -o output -s publishconf.py
使用 ghp-import 将 output 目录的内容添加到 master 分支中：

$ ghp-import -m “Generate Pelican site” --no-jekyll -b master output
将本地 master 分支推送到远程仓库：

$ git push origin master
提交新内容并将其推送到 content 分支

$ git add content
$ git commit -m ‘added a first post, a photo and an about page’
$ git push origin content
OMG，我成功了
现在最激动的时候到了，当你想要看到你发布给大家的博客内容时，打开浏览器输入：

https://username.github.io
恭喜你可以在 GitHub 上发布自己的博客了!当你想添加更多页面或文章时，都可以按照上面的步骤来。希望你可以愉快地发布博客。

使用 Python 在 GitHub 上运行你的博客相关推荐

手把手教从零开始在GitHub上使用Hexo搭建博客教程(二)-Hexo参数设置
前言前文手把手教从零开始在GitHub上使用Hexo搭建博客教程(一)-附GitHub注册及配置介绍了github注册.git相关设置以及hexo基本操作. 本文主要介绍一下hexo的常用参数设置. ...
在github上写自己的博客
我的github网址:grimxiaojun 欢迎来到王小俊的个人博客这是我在github上的第一篇博客,这一篇博客我将讲述我怎么想来到github上写自己的博客的和如何在github上搭建个人博客 ...
在Github上搭建自己的博客(Windows平台)
折腾了好久,终于在Github上搭建了自己的博客.这里面总结一下过程希望对大家能有所帮助. Github建博优缺点和 csdn,新浪,网易相比,在Github上可以自己实现功能和阿里云,VPS相比 ...
在Github上搭建你的博客
title: blog on github date: 2014-03-24 20:29:47 tags: [blog,github,hexo] ---**用Github写博文** 参考http:// ...
Pelican + Github 搭建自己的静态博客
//想了解更多请访问我的新网站:Techwhims Techwhims.com 之前在Github上使用基本的jekyll模板搭建过一个博客,但是那时候前端技术的水平有限,搭出来的博客很不好看,一些基 ...
在git上建立自己的博客
怎样在github上建立自己的博客呢,git上有教程,教程地址:https://hexo.io/zh-cn/docs/
Hexo + GitHub Pages + NexT在win10上搭建个性化个人博客
刚刚搭好自己的个人博客,现在总结一下注册Github账号及创建仓库访问网址:https://github.com/ 注册好账号之后,点击下图中的Start Project 在Repository ...
GitHub Pages + Hexo搭建个人博客网站，史上最全教程
文章目录一.准备工作 1. GitHub账号 2. 安装Git 3. 安装NodeJS 二.创建仓库三.安装Hexo 四.更换主题 1. NexT 主题 2. Fluid主题五.创建文章六.个 ...
Github Pages + Hugo 搭建个人博客
文章目录 Github Pages + Hugo 搭建个人博客零.效果一.创建 Github 库二.安装 Hugo 和 Git 三.新建 Hugo 网站四.选择 Hugo 主题五.新建文章 ...

使用 Python 在 GitHub 上运行你的博客

I am On My Way To Internet Fame and Fortune!

使用 Python 在 GitHub 上运行你的博客相关推荐

最新文章

热门文章