利用github搭建个人博客

2014-02-16 by Brant Xiong

前言

首先,感谢lizherui大牛博客中的教程。 引用下原文对Geek的理解:

Geek更多的是一种精神,一种态度,一种对技术的理解与信念。他们无法忍受丑陋的代码,拙劣的技术。他们思路开阔,技术娴熟,他们不甘平庸,追求完美。他们不会囿于常识,他们敢于突破。在常人眼中,他们不走寻常路,享受各种非主流的技术。但在他们自己眼中,这些又是那么得自然与优美。他们用自己的行为诠释着自己对于技术的理解,用那份固执传达着自己的信念。

他们掌握并热爱着技术,叛逆、执着,崇尚自由。

本人非常崇尚这种Geek风格,并努力成为Geek中的一员~

下面记录下本博客搭建的整个过程~

博客搭建过程


开始动手。

Github入门指南

请参考http://blog.csdn.net/duxinfeng2010/article/details/8654690

使用Github Pages创建个人博客

Github为每一个用户分配了一个二级域名username.github.io,用户为自己的二级域名创建主页很简单,只需要在Github下创建一个名为username.github.io的版本库,并向其master分支提交网站静态页面即可。

  • 登陆Github,创建一个名为username.github.io的版本库(将username替换成自己的Github账户名)。
  • 点击Setting,选择一个自己喜欢的模板,最后点击发布public按钮
  • 耐心等待一段时间(不超过10分钟),登陆http://username.github.io,会发现自己的个人博客已经生成。

安装Pelican和Markdown

pip install pelican
pip install markdown

搭建骨架

mkdir blog
cd blog
pelican-quickstart

根据提示一步步输入相应的配置项,不知道如何设置的接受默认即可,后续可以通过编辑pelicanconf.py文件更改配置)

以下是生成的目录结构:

blog/
├── content              # 存放输入的源文件
│   └── (pages)          # 存放手工创建的静态页面
├── output               # 生成的输出文件
├── develop_server.sh    # 方便开启测试服务器
├── Makefile             # 方便管理博客的Makefile
├── pelicanconf.py       # 主配置文件
└── publishconf.py       # 主发布文件,可删除

开始写博文

在content目录下用Markdown语法来写一篇文章,在Windows下,我选择的是MarkdownPad工具来编写md文件。

文章开头部分需填入Title等信息,例如:

Date: 2014-02-16
Title: 利用github搭建个人博客
Category: Tech
Tags: pelican, blog, python
Slug: build_blog

写完后,执行以下命令

make html
make serve

即可在本机http://127.0.0.1:8000看到效果。接下来就是上传至github生效了,我创建了github文件夹用来保存需上传至github的文件,具体命令如下:

cd github
rm -rf *
cp -r ../output/* .
git init
git remote add origin https://github.com/brantxiong/brantxiong.github.io.git
git add .
git commit -m 'Refresh Blog'
git push origin master --force

个性化


挑选主题

安装主题,比如tuxlite_tbs:

git clone https://github.com/getpelican/pelican-themes.git
cd pelican-themes
pelican-themes -i tuxlite_tbs

选择主题,在pelicanconf.py中添加

THEME = 'tuxlite_tbs'

修改细节

Social展示块我们可能需要新增链接,需要修改pelican-themes/tuxlite_tbs/static/local.css文件,在末尾追加链接即可

Copyright时间修改则在文件pelican-themes/tuxlite_tbs/templates/base.html中,如将2012改为2014~

关于About页面,在content\pages目录下增加About.md即可~

改掉err红色提示:将pelican-themes/tuxlite_tbs/static/pygments.css中的.highlight .err { border: 1px solid #FF0000 } /* Error */改为:.highlight .err { color: #666666 } /* Error */

删除work-break(会导致代码行号错乱。。。):pelican-themes/tuxlite_tbs/static/css/bootstrap.min.cssword-break: break-all

改完后执行以下命令更新主题:

sudo pelican-themes -U tuxlite_tbs

配置文件

最后附上我的pelicanconf.py配置文件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
#!/usr/bin/env python
# -*- coding: utf-8 -*- #
from __future__ import unicode_literals

AUTHOR = u'Brant Xiong'
SITENAME = u'Brant Xiong\'s Blog'
SITEURL = 'http://brantxiong.github.io'

GITHUB_URL = 'https://github.com/brantxiong'
ARCHIVES_URL = 'archives.html'
ARTICLE_URL = 'pages/{date:%Y}/{date:%m}/{date:%d}/{slug}.html'
ARTICLE_SAVE_AS = 'pages/{date:%Y}/{date:%m}/{date:%d}/{slug}.html'

RELATIVE_URLS = True
DEFAULT_PAGINATION = 5

GOOGLE_ANALYTICS = '' # Google Track Id
DISQUS_SITENAME = '' # Disqus User Name


TIMEZONE = 'Asia/Shanghai'

THEME = 'tuxlite_tbs'

DEFAULT_LANG = u'zh'

DEFAULT_DATE_FORMAT = '%Y-%m-%d'

# Feed generation is usually not desired when developing
FEED_RSS = 'feeds/all.rss.xml'
CATEGORY_FEED_RSS = 'feeds/%s.rss.xml'
# Blogroll
LINKS =  (('Google', 'https://www.google.com/ncr'),
  ('Python', 'http://python.org/'),
 )

# Social widget
SOCIAL = (('Github', 'https://github.com/brantxiong'),
            balabla~
 )

写到这里,已经0:52pm 2014-2-14了~明天还得上班~时间不早了,赶紧休息去了~~嘿嘿~


Comments

Follow me on GitHub