ScarShow

< IS >

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