Pointless 使用說明
Pointless是由PHP撰寫的靜態部落格生成器,可將由Markdown撰寫的檔案轉為靜態網頁,不需要使用資料庫儲存網頁資訊,並且使用命令列模式操作。
系統要求:
- PHP 5.3+
- Command Line Interface
支援:
- Github CNAME
- Google Analystics
- DISQUS
外部程式:
如何安裝:
使用 git 從 github 上下載
git clone git://github.com/scarwu/Pointless.git
將以下指令加入.bashrc
或是.zshrc
檔案中
export PATH=$PATH:/path/to/Pointless/Bin/
poi 指令:
help - 顯示幫助.
init - 初始化Pointless
gen (all) - 產生靜態部落格
gen css - 單獨產生及壓縮CSS
gen js - 單獨產生及壓縮JavaScript
gen clean - 清除靜態部落格(.git除外)
article (list) - 列出所有文章
article add - 新增文章
blogpage (list) - 列出所以靜態頁面
blogpage add - 新增靜態頁面
deploy - 佈署部落格
初始化部落格
./init.sh
初始化後的資料放置在/path/to/Pointless/Blog/
,並且也生成了靜態資料放置在/path/to/Pointless/Blog/Public
中。
而產生出的Blog資料夾檔案結構為
Blog
├── Config.php (部落格個設定檔,包含部落格的基本設定)
├── Markdown (MD檔的存放資料夾)
│ ├── Article (放置文章)
│ └── BlogPage (放置部落格的靜態頁面)
├── Public (靜態頁面公開的位置,可以將網頁伺服器指向它或是將它傳送到任何免費的網頁空間(Dropbox or Github))
├── Resource (部落格的公開檔案資料,會經由產生器全部複製到Public中)
└── UI (部落格頁面的樣式設定)
├── Resource (放置CSS, Javascript及圖片)
├── Script (產生樣板用的資料)
└── Template (網頁樣板)
新增文章:
poi article add
然後填入相對應的資料然後手動使用文字編輯器去修改內容
Markdown內容
-----
{
"title": "Welcome",
"url": "Welcome",
"tag": "Unset|Pointless",
"category": "Unset",
"date": "1970-01-01",
"time": "00:00:00"
}
-----
Hi, Welcome to my blog!
=======================
文章資訊由 -----
所包圍,而文章資訊是使用JSON格式紀錄可以手動修改,另外 tag 是使用|
所隔開,而在-----
之後就可以開始寫文章了。
部落格靜態頁面亦同。
結束
可能還有一些重要的東西忘了寫...有問題再留言吧,畢竟現在這個工具目前只有我一個人在用。
如果對於程式有什麼提議或發現BUG的話也可以在Github上發個Issue。
Update: 2012/08/20