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 中引用它們,如下所示: 
使用正確的檔案名稱約定 ( 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 的使用範例。