Blip 使用特定的目錄結構來進行範本和網站組織。請參閱example-site/
目錄以取得演示,或繼續閱讀以取得完整說明。
範本是網站索引和貼文頁面的佈局指南。以下內容位於config/templates/
中:
index_template.html
:您網站的主索引頁面。
index_post_template.html
:索引頁面上貼文預覽的版面。
post_template.html
:單一貼文頁面的佈局。
Blip 使用一些自訂「標記」來執行常見任務和文字替換。使用Config.swift
自訂替換字串。
降價(貼文):
[[MORE]]
:在index*.html
頁面中中斷帖子,並插入完整帖子的Read More
連結。模板:
$(COPYRIGHT)
:將自訂版權字串插入索引範本中。
$(POSTS)
:將貼文片段清單插入索引範本中。
$(POSTS_OLDER)
:將「較早的貼文」連結插入索引範本中。
$(POSTS_NEWER)
:將「較新貼文」連結插入索引範本中。
$(POST_TITLE)
:將貼文標題插入貼文或索引範本中。
$(POST_TIMESTAMP)
:將貼文時間戳插入貼文或索引範本中。
$(POST_BODY)
:將貼文內文插入貼文或索引範本(索引範本將顯示最多任何[[MORE]]
標記)。
$(POST_PERMALINK)
:將貼文永久連結插入貼文或索引範本中。
貼文應採用 Markdown 格式,並遵循YYYYMMDD.md
命名約定(也支援.markdown
檔案副檔名)。
posts/
目錄應至少包含兩個子目錄:
drafts
:這是您應該放置 Markdown (.md) 文件以進行發布的位置。
published
:Blip 將在此目錄中產生 HTML index*.html
並發布頁面。您應該將此目錄的內容用於您的網站。
發布的帖子根據文件名中的日期進行組織。例如,檔案名稱為20171220.md
的貼文將發佈在以下路徑: posts/published/2017/12/20.md
。目前,Blip 每天只支援一篇文章,主要是因為我不常寫部落格...
published/stylesheets/
:預設範本使用包含的index.css
作為樣式表。如果需要,您可以將其他 CSS 檔案放在這裡並在模板中引用,
published/images/
:將你的圖片放到這裡,你可以在 Markdown 中引用它們,如下所示: ![image](/images/someimage.jpg)
使用正確的檔案名稱約定 ( YYYYMMDD.md
) 以 Markdown 編寫帖子,然後將其放入drafts/
目錄中。
然後運行以下命令:
./blip /path/to/your/blog/ -r
-r
透過發布drafts/
目錄中的所有 Markdown 檔案來重建整個網站。
-w
監視drafts/
目錄中的新 Markdown 文件並自動發布它們。
-i
僅重建網站index*.html
頁面。
-h
顯示幫助。
使用 Swift 的簡單易用/擴充檔案系統觀察器。
Swift 中的 Markdown 渲染速度極快,基於 cmark。
請造訪我的個人網站,以取得 Blip 的使用範例。