[git]用pelican搞一个自己的blog(已完成)
来源:互联网 发布:app源码下载 编辑:程序博客网 时间:2024/06/03 20:45
http://www.cnblogs.com/xueweihan/p/5249715.html
pelican
Pelican Static Site Generator, Powered by Python:Pelican是python语言写的静态网站生成器。因为我一直打算用github pages做一个博客,现在已经学会用Hexo在github pages上做博客了。但是我一想:我一个pythoner,干嘛不用python写的静态网站生成器。我想应该是网上教程太少,那我今天就来搞一搞。顺便记录下来,整理出一个教程,希望一切顺利!
最终效果:xueweihan.com
开始
1.首先用virtualenv创建一个env
mkdir blogcd blogvirtualenv envsource env/bin/activate #激活环境
2.使用pip安装pelican和markdown
pip install pelicanpip install markdown
3.创建pelican目录结构
pelican-quickstart# 根据提示进行设置> Where do you want to create your new web site? [.]> What will be the title of this web site? 削微寒> Who will be the author of this web site? xueweihan> What will be the default language of this web site? [en] zh> Do you want to specify a URL prefix? e.g., http://example.com (Y/n)> What is your URL prefix? (see above example; no trailing slash) xueweihan.com> 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] Asia/Shanghai> Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n)> Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n)> 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)Done. Your new project is available at /Users/xueweihan/Documents/blog
文件结构如下:
blog/├── content # 写的文章放这里├── output # 生成的输出文件(发布的内容)├── develop_server.sh ├── Makefile # 方便管理博客的Makefile├── pelicanconf.py # 主配置文件└── publishconf.py
我们下面只用到我解释的这几个目录和文件,大致有个印象即可
4.编写文章测试下效果
Date: 2016-02-28Title: 测试Tags: 测试Slug: test# pelicanPelican Static Site Generator, Powered by Python:Pelican是python语言写的静态网站生成器。因为我一直打算用git pages做一个博客,现在已经学会用Hexo在git pages上做博客了。但是我还是一想:我一个pythoner,干嘛不用python写的静态网站生成器。应该是网上教程太少,那我今天就来搞一搞。顺便记录下来,整理出一个教程,希望一切顺利!
在content目录下创建一个名为:test.md的markdown文件,把上面的那些内容放进去,用来测试效果。
5.本地查看效果
# 在blog目录下执行pelican content # 根据content中的内容,生成静态网站到output目下# 在output目录下执行python -m pelican.server
以上两个命令执行完,没有报错的话就用浏览器打开:127.0.0.1:8000,效果如下:
输入:ctrl + c
停止服务
5.上传到github pages 现在就差最后一步,上传到github pages上面。 一步步的来:
首先在github上创建一个项目,Repository name
填写:你的github用户名.github.io 如下图:
然后在output
目录依次输入:
git initgit add .git commit -m "pelican static blog test"git remote add origin git@github.com:你的github用户名/你的github用户名.github.io.git# 例如我的就是:git@github.com:521xueweihan/521xueweihan.github.io.gitgit push -u origin master
最后访问:http://你的github用户名.github.io/ 例如我的就是:http://521xueweihan.github.io/
页面如下图:
简化发布流程
还记得Makefile文件吗?我们通过修改这个文件,实现1条指令发布博客到github pages上。
把blog
目录下的Makefile文件中的内容替换成下面的内容(原Makefile文件的内容都不要)
PY?=pythonPELICAN?=pelicanPELICANOPTS=BASEDIR=$(CURDIR)INPUTDIR=$(BASEDIR)/contentOUTPUTDIR=$(BASEDIR)/outputCONFFILE=$(BASEDIR)/pelicanconf.pyPUBLISHCONF=$(BASEDIR)/publishconf.pyDEBUG ?= 0ifeq ($(DEBUG), 1) PELICANOPTS += -DendifRELATIVE ?= 0ifeq ($(RELATIVE), 1) PELICANOPTS += --relative-urlsendifhtml: $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)clean: [ ! -d $(OUTPUTDIR) ] || rm -rf $(OUTPUTDIR)regenerate: $(PELICAN) -r $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)serve:ifdef PORT cd $(OUTPUTDIR) && $(PY) -m pelican.server $(PORT)else cd $(OUTPUTDIR) && $(PY) -m pelican.serverendifpublish: $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)github: publish cd $(OUTPUTDIR) ; git add . ; git commit -m '更新博客' ; git push origin master
更新博客流程
- 把写好的markdown格式的文章放到content中,然后在
blog
目录下 - 本地查看效果的话:
make html
然后make serve
最后访问:127.0.0.1:8000 - 发布到github:
make github
完成
定制属于自己的blog
下面的内容算是高级篇了,需要把上面的步骤都完成。想要进一步完美自己的博客的小伙伴
1.独立域名
首先要购买域名,我的实在阿里云上买的,买完之后就需要修改你的域名指向:访问xueweihan.com域名,跳转到你的.github.io。根据你购买域名时候的提示,就可以设置完成了。之后在output目录下,创建CNAME文件。内容就是你购买的域名。因为github pages只允许CNAME中的域名映射。
2.定制样式结构
一步步的来,首先要找到你喜欢的主题pelican主题,下载的时候我推荐Download ZIP
会快很多。下载好你的主题,我们就需要在blog目录下,找到pelicanconf.py
文件,它是在生成静态网站时候的配置文件,定制几乎所有的东西都需要通过这个。增添内容如下:
THEME = '你的主题所在目录'# 例如:THEME = '/Users/root/Documents/blog/tuxlite_tbs'GITHUB_URL = 'https://github.com/你的github用户名'# 效果是右上角有个fork me on Github,点击进入你的Github主页DEFAULT_DATE_FORMAT = '%Y-%m-%d'# 时间格式SOCIAL = (('github', 'https://github.com/521xueweihan'), ('博客园', 'http://www.cnblogs.com/xueweihan/'))# 几乎所有的博客主题都有一个地方展示你的社交账号,这些账号就写在这里,上面是我的DISQUS_SITENAME = 'shortname'# 评论功能,需要在Disqus上申请一个站点,替换shortname
如果有python基础的,可以直接修改主题目录下的template
中的模版。已达到你想要的目录结构和内容的呈现。
3.简单的SEO
在output文件中创建rebots.txt,这个文件是一个协议文件,没有不会影响什么。但是有的话,有利于搜索引擎的收录。内容如下,允许所有爬虫,同时不允许爬取theme目录下的内容,和所有的图片。:
User-agent: *Disallow: /theme/Disallow: /.gif$Disallow: /.png$Disallow: /.jpg$
大多数主题多是外国人写的,所以他们都支持‘谷歌分析’
GOOGLE_ANALYTICS = '跟踪ID'
而百度的分析就需要手动的在主题目录下的template目录下的base.html中增添百度的分析代码。
4.sitemap是对于爬虫友好的一个文件,它告诉爬虫,网站的更新频率和优先级等。详情
增添插件:
git clone git://github.com/getpelican/pelican-plugins.git
修改pelicanconf.py文件:
PLUGIN_PATH = u"pelican-plugins"PLUGINS = ["sitemap"]SITEMAP = { "format": "xml", "priorities": { "articles": 0.7, "indexes": 0.5, "pages": 0.3, }, "changefreqs": { "articles": "monthly", "indexes": "daily", "pages": "monthly", }}
5.favicon.ico
放在output的根目录下。
6.订阅
因为pelican的库包含了feedgenerator。feedgenerator是用来生成Atom feeds(是包含你博客数据的xml的文件)用于订阅。所以你只需要在pelicanconf.py
加入:
FEED_ALL_RSS = 'feeds/all.rss.xml'
博客就会自动生成订阅功能了。
7.关于我
这个就像相当于一个自我介绍的页面,所以就需要在content
目录下创建一个pages
目录,然后把你要展示的内容放到pages
目录下就可以了。
最终效果
我的博客:xueweihan.com
问题
当删除了一篇博文,但是以我上面所说的方式发布的话。那片文章其实还是存在于github pages上的。只不过没有在模版中生成链接罢了。这种类似的情况会导致:换主题css丢失等问题。当然如果你清空
output
目录,然后重新生成网站的话,就没问题。但是清空的话,会导致一切不因该被删的文件也都被删除了,例如:.git和CNAME等文件。所以我就写了一个del.sh
,用于删除pelican生成的文件,其他哪些通用文件都不删除。这样暂时可以解决问题。本来想要在两台电脑上都可以发布文章,修改完makefile我发现不是刚性需求,同时实现效果不好。最后的解决方案是,把文章写在另外的一个github的项目中,分布式编辑这个项目。最后写文章之前,
git pull
获取最新的文章,这样就可以同步最新的内容进行修改发布了。我遇到的另外一个问题,就是pelican-theme上面大多都是国外的主题,有的主题中的jquery.js是用的google的cdn。在国内访问的时候会造成找不到jquery.js对体验和响应时间造成很大的影响。所以,部署完站点后,最好打开浏览器的开发者模式,查看一下各个文件的请求耗时。如果有我上述情况,那么你可以尝试把那个请求耗时过长的静态文件,下载好,放到该主题目录下
static
中对应的目录内。这个其实不是问题,算是一个建议。文章的格式中,加入
Slug: test
。这个字段的是:用于文章生成url的。不添加这个字段话,默认是拼音的url。但是有时侯拼音是错误的,而且对于搜索引擎很不友好。
参考
- lizherui的博客
- pelican官方文档
- pelican中文文档(不全)
- Pelican搭建静态博客
- [git]用pelican搞一个自己的blog(已完成)
- Pelican + Github 搭建自己的静态博客
- Pelican + Github Pages 搭建自己的博客
- 利用Git搭建自己的blog
- 也搞一个blog玩玩!
- 自己完成的一个电子表代码。
- 自己完成一个冒泡排序(bubble_sort),可以完成不同类型数据的排序
- Pelican 的Windows 入门教程
- 终于开始了一个自己的blog~~
- 建了一个自己的BLOG
- 这个blog怎么搞的?
- 这次是真真正正的完善了自己的 Blog,也可以松口气,安心搞技术了。
- 自己另外一个BLOG
- 用 Pelican 和 github 打造你的个人主页
- 已删除的BLOG
- 已删除的BLOG
- Python/Pelican搭建自己个人博客
- 如何创建一个自己的git服务器
- Android项目版本管理浅析
- 表的内连接、外连接(左连接与右连接)
- linux下使用read函数实现的按行读取readline
- 生成含年月日的mysql数据库备份文件
- SVN 入门: 将已有文件目录加入svn版本控制
- [git]用pelican搞一个自己的blog(已完成)
- MySQL中的小技巧(不断更新中)
- 解决 Error:No suitable device found: no device found for connection "System eth0"
- C++命名空间
- JS DOM insertAfter方法
- redhat的安装
- debian 8.x 有用的源(163)
- AppDomain
- Javascript第一个程序