如何使用 Pelican 搭建一个博客？

本系列第一篇文章可以在这里阅读：「创建数据科学作品集：用数据讲故事」写博客是证明你实力、深入学习和建立读者群体的好方法。许多数据科学和编程博客帮助他们的作者找到工作或认识重要人物。定期写博客是程序员和数据科学家最有抱负的事情之一。不幸的是，写博客的一个主要障碍是先建立一个博客网站。在本文中，我们将学习如何用Python创建博客网站，如何用Jupyternotebook写文章，如何通过Githubpages部署博客。读完这篇文章后，你可以用你熟悉的方式创建自己的数据科学博客。静态网站基本上是一个充满HTML文件的文件夹。我们可以建立一个服务器，允许其他人链接到文件夹并获取文件。这样做的好处是不需要数据库或其他动态部分，可以简单地部署在GitHub等网站上。把你的博客做成静态网站是个好主意，因为维护起来很简单。建立静态网站的一种方法是手写HTML，然后将所有HTML文件上传到服务器上。在这种情况下，你至少应该写一个index.html文件。如果你网站的URL是thebestblog.com，访客浏览httpp://www.thebestblog.com时，他们会看到index.html的内容。HTML的文件夹可能如下:thebestblog.com│ index.html│ first-post.html│ how-to-use-python.html│ how-to-do-machine-learning.html│ styles.css在上面的网站上，访问http://www.thebestblog.com/first-post.你可以看到firsttml-post.html内容。first-post.html可能是下面的样子:Thebestblog!first-post.html可能是下面的样子:Thebestblog!Firstpost!Thisisthefirstpostinwhatwillsoonbecome(ifitalreadyisn't)thebestblog.Futurepostswillteachyouaboutdatascience.Thanksforvisiting!您可能会立即发现手工编辑HTML的一些问题：手工编辑HTML会很无聊。如果你想写多篇文章，你需要复制很多内容，比如风格，Title、Footer等。要整合评论系统或其它插件，必须写Javascript。一般来说，当你写博客时，你想*博客内容，而不是在HTML上浪费时间。谢天谢地，您可以使用一种叫做静态网站生成器的工具来代替手动编辑HTML。静态网站生成器静态网站生成器可以让你以一些简单的格式写文章，通常是Markdown，然后定义一些设置。生成器可以自动将您的文章转换为HTML。使用静态网站生成器，您可以使用first-post.极大地简化了firstttml-post.md：#Firstpost!Thisisthefirstpostinwhatwillsoonbecome(ifitalreadyisn't)thebestblog.Futurepostswillteachyouaboutdatascience.这比处理HTML文件要简单得多！通用元素，如title和foter，可以放在模板中，很容易改变。各种静态网站生成器。最流行的是用Ruby开发的Jekyll。因为要建立一个数据科学博客，网站生成器需要处理JupyterNotebooks。Pelican是一个由Python开发的网站生成器，可以接受Jupyternotebook文件并转换为HTML博客文章。Pelican也可以很容易地将文章部署到GitHubPages，让别人阅读。在安装Pelican之前，这里有一个仓库(repo)，这就是我们最终结果的例子。如果您还没有安装Python，您需要在开始前做一些早期工作。这里有一些安装Python的说明。我们建议使用Python3.5。当您安装Python时：创建文件夹——我们将创建博客网站的内容和风格(Styles)把它放在这个文件夹里。这个教程称这个文件夹为jupyter-blog，你可以随便命名。cd进入jupyter-blog文件夹。创建一个叫.gitignore文件，然后添加文件中的内容。最后，我们将把仓库提交给git，这将排除其他一些东西。创建和激活虚拟环境。在jupyter-blog文件夹中创建requirementss.txt文件，内容如下：Markdown==2.6.6pelican=3.6.3jupyter>=1.0ipython>=4.0nbconvert>=4.0beautifulsoup4ghp-import==0.4.1matplotlib=1.5.在jupyter-blog文件夹中运行pipinstall-rrequirements.安装requirementstxt.所有的包都在txt里。创建数据科学博客完成前面的设置后，你就准备好创建博客了！创建数据科学博客完成前面的设置后，你就准备好创建博客了！在jupyter-blog文件夹中运行pelican-quickstart命令，为您的博客启动交互式安装序列。你会看到一些问题来帮助你设置博客属性。对于大多数问题，您只需点击Enter使用默认设置。您需要输入的是您的网站名称、网站作者、URLprefix(URL前缀)和timezone(时区)。以下是一个例子：(jupyter-blog) jupyter-blog pelican-quickstartWelcometopelican-quickstartv3.6.3.ThisscriptwillhelpyoucreateanewPelican-basedwebsite.PleaseanswerthefollowingquestionssothisscriptcangeneratethefilesneededbyPelican.>Wheredoyouwanttocreateyournewwebsite[.]>WhatwillbethetitleofthiswebsiteVik'sBlog>WhowillbetheauthorofthiswebsiteVikParuchuri>Whatwillbethedefaultlanguageofthiswebsite[en]>DoyouwanttospecifyaURLprefixe.g.,http://example.com (Y/n)n>Doyouwanttoenablearticlepagination(Y/n)>Howmanyarticlesperpagedoyouwant[10]>Whatisyourtimezone[Europe/Paris]America/Los_Angeles>DoyouwanttogenerateaFabfile/Makefiletoautomategenerationandpublishing(Y/n)>Doyouwantanauto-reload&simpleHTTPscripttoassistwiththemeandsitedevelopment(Y/n)>DoyouwanttouploadyourwebsiteusingFTP(y/N)>DoyouwanttouploadyourwebsiteusingSSH(y/N)>DoyouwanttouploadyourwebsiteusingDropbox(y/N)>doyouwantouplodyourwebsingsingS3S3(y/N)>DoyouwanttouploadyourwebsiteusingRackspaceCloudFiles(y/N)>DoyouwanttouploadyourwebsiteusingGitHubPages(y/N)pelican-quickstart运行后，jupyter-blog文件夹中有两个文件夹：content和output，还有一些文件，如pelicanconf.py和publishconf.py。以下是文件夹目录的示例：jupyter-blog│ output│ content│ .gitignore│ develop_server.sh│ fabfile.py│ Makefile│ requirements.txt│ pelicanconf.py│ publishconf.Py安装Jupyter插件Pelican默认不支持使用Jupyter写文章，所以我们需要安装一个插件来完成这个功能。我们使用插件作为git子模块(gitsubmodule)安装方便管理。我们使用插件作为git子模块(gitsubmodule)安装方便管理。如果您还没有安装git，您可以在这里找到安装说明。安装git后：运行gitinit，将当前文件夹初始化为git仓库。创建一个名为plugins的文件夹。操作gitsubmoduledgittittdgittt://github.com/danielfrg/pelican-ipynb.gitplugins添加插件的ipynb。现在应该有一个.gitmodules文件和plugins文件夹：jupyter-blog│ output│ content│ plugins│ .gitignore│ .gitmodules│ develop_server.sh│ fabfile.py│ Makefile│ requirements.txt│ pelicanconf.py│ publishconf.py为了激活插件，pelicanconff需要修改.py文件，在底部添加几行代码：MARKUP=('md','ipynb')PLUGIN_PATH='./plugins'PLUGINS=['ipynb.markup']这几行代码告诉Pelican在生成HTML时激活插件。安装完第一篇文章插件后，就可以写你的第一篇文章了:创建一个Jupyternotebook，简单写一些内容。安装完第一篇文章插件后，就可以写你的第一篇文章了:创建一个Jupyternotebook，简单写一些内容。这里有一个例子。将notebook文件复制到content文件夹。创建与notebook同名的文件，但扩展名称是.ipynb-meta。这里有一个例子。在ipynb-meta文件中添加以下内容，但根据自己的文章修改相应的字段：Title:FirstPostSlug:first-postDate:2016-06-0820:00category:postsTags:pythonfirstsAuthor:VikParuchuriSummary:Myfirstpost,readittofindout.以上字段的解释如下：Title——文章的标题。Slug——您的文章在服务器上的路径。Slug——服务器上的文章路径。假如slug是first-post，而且你的服务器地址是jupyter-blog.com,你可以在http://www.jupyter-blog.com/first-post地址找到你的文章。Date——发表文章的日期。Category——文章的类别——可以是任何东西。Tags——文章的标签。可以随便挂标签。Author——作者的名字。Summary——摘要文章。每次发表一篇文章，都需要复制notebook文件，创建ipynb-meta文件，创建notebook和meta文件，然后生成博客HTML文件。下面是jupyter-