江苏龙网

  1. 主页 > 生活百科 > >

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

PythonGithub


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

文章插图
 
使用 Pelican 创建博客，这是一个基于 Python 的平台，与 GitHub 配合的不错 。-- Erik O'shaughnessy（作者）
【使用 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 contentSwitched to a new branch 'content'配置 Pelican现在该进行内容配置了 。Pelican 提供了一个很棒的初始化工具 pelican-quickstart，它会询问你有关博客的一系列问题 。
$ pelican-quickstartWelcome 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 filesneeded 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) yDone. Your new project is available at /Users/username/blog你可以对每个问题都采用默认值，但除了以下这些问题：
  • 网站标题，应该唯一且特殊
  • 网站作者，可以是个人用户名或你的全名
  • 时区，可能你不在巴黎
  • 上传到 GitHub 页面，我们选择 y
回答完所有问题后，Pelican 会在当前目录中留下以下内容：
$ lsMakefile      content/     develop_server.sh*fabfile.py    output/      pelicanconf.pypublishconf.py你可以查看 Pelican 文档 来了解如何使用这些文件，但现在我们要做的是完成手头的工作 。说实话，我也没有阅读文档 。


推荐阅读


上一篇：杭菊花的正确冲泡方法,女性喝菊花茶的好处

下一篇：茉莉菊花可以起泡吗,孕妇可以喝菊花茶吗