利用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.css中word-break: break-all

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

sudo pelican-themes -U tuxlite_tbs

配置文件

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

#!/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

Categories
Tech