用 Pelican 生成你的個(gè)人主頁(yè)
無(wú)需申請(qǐng)站點(diǎn), 也不要搭建服務(wù)器, 編寫網(wǎng)頁(yè), 如果只是一個(gè)人站點(diǎn), 發(fā)布點(diǎn)個(gè)人信息, 博客文章, 以及讀書筆記, 用 pelican 和 github 就可以做一個(gè)免費(fèi)的個(gè)人主頁(yè).
So easy.
1. 安裝 brew
這里僅以 mac book 為例，在windows上差不多，先把python, pip裝上，剩下的就好辦了
安裝 homebrew 先
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2. 安裝 python, pip and pelican
brew install python
sudo easy_install pip
sudo pip install pelican markdown
output: ::
Successfully installed blinker-1.3 docutils-0.12 feedgenerator-1.7 jinja2-2.7.3 markdown-2.6 markupsafe-0.23 pelican-3.5.0 pygments-2.0.2 unidecode-0.4.17
3. 執(zhí)行 pelican-quickstart in yoursite folder
pelican-quickstart
常見(jiàn)問(wèn)題
問(wèn)題1: some errors showed up: ValueError: unknown locale: UTF-8
-
解決方案:
在 ~/.bash_profile增加如下兩行export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
問(wèn)題2: No module named html_parser
- 解決方案: pip install six
- if still encounter the error , upgrade python form 2.7.6 to 2.7.9
- if still encounter the error::
<pre>
sudo vi /Library/Python/2.7/site-packages/pelican/readers.pyfrom six.moves.html_parser import HTMLParser
from HTMLParser import HTMLParser
</pre>
4. 添加一個(gè)文件 test.md 在 content 目錄中
Title: Journal
Date: 2015-02-27 10:20
Modified: 2015-02-27 19:30
Category: Journal
Tags: journal, blog
Authors: Walter Fan
Summary: Daily minute
# Task
5. 快速測(cè)試一下
步驟如下:
pelican content
pelican listen
6. 訪問(wèn) http://localhost:8000
可見(jiàn)一個(gè)象模象樣的博客網(wǎng)站已經(jīng)生成了
配置文件示例 pelicanconf.py:
AUTHOR = 'Foo Bar'
SITEURL = 'http://yoursite.com'
SITENAME = 'Foo Bar\'s Blog'
SITETITLE = 'Foo Bar'
SITESUBTITLE = 'Web Developer'
SITEDESCRIPTION = 'Foo Bar\'s Thoughts and Writings'
SITELOGO = SITEURL + '/images/profile.png'
FAVICON = SITEURL + '/images/favicon.ico'
BROWSER_COLOR = '#333'
ROBOTS = 'index, follow'
CC_LICENSE = {
'name': 'Creative Commons Attribution-ShareAlike',
'version': '4.0',
'slug': 'by-sa'
}
COPYRIGHT_YEAR = 2016
EXTRA_PATH_METADATA = {
'extra/custom.css': {'path': 'static/custom.css'},
}
CUSTOM_CSS = 'static/custom.css'
MAIN_MENU = True
LINKS_IN_NEW_TAB = 'external'
ADD_THIS_ID = 'ra-77hh6723hhjd'
DISQUS_SITENAME = 'yoursite'
GOOGLE_ANALYTICS = 'UA-1234-5678'
GOOGLE_TAG_MANAGER = 'GTM-ABCDEF'
STATUSCAKE = { 'trackid': 'your-id', 'days': 7, 'design': 6, 'rumid': 1234 }
# Enable i18n plugin.
PLUGINS = ['i18n_subsites']
# Enable Jinja2 i18n extension used to parse translations.
JINJA_EXTENSIONS = ['jinja2.ext.i18n']
# Translate to German.
DEFAULT_LANG = 'de'
OG_LOCALE = 'de_DE'
LOCALE = 'de_DE'
# Default theme language.
I18N_TEMPLATES_LANG = 'en'
Tips
- edit pelicanconf.py to set RELATIVE_URLS = True
用 github 來(lái)發(fā)布你的個(gè)人主頁(yè)
1. publish blog to github site
步驟如下:
cd output
git init
git add *
git remote add origin https://github.com/walterfan/walterfan.github.io.git
git pull origin master
git commit -am 'add blog'
git push -u origin master
2. 定制你的博客站點(diǎn)樣式
步驟如下:
mkdir theme
cd theme
git submodule add https://github.com/DandyDev/pelican-bootstrap3.git
git submodule init
git submodule update
然后編輯 pelicanconf.py, 增加下面這行
THEME = '../theme/pelican-bootstrap3'
推薦我最喜歡的 Flex 樣式
cd theme
git submodule add https://github.com/alexandrevicenzi/Flex.git
git submodule init
git submodule update
