這是針對 Jekyll / GitHub Pages 的 Ghost 預設主題 Casper v2.1.9 的全功能移植。
幽靈的小精靈 // Jasper2
對多個作者的開箱即用支援(透過_data/authors.yml
)
完整的作者訊息,包括:圖片、簡介、網站、twitter、facebook 等。
標籤描述和個人化封面(透過_data/tags.yml
)
相關貼文查看在每個貼文的底部
所有 Ghost 預設頁面:作者頁面、標籤頁面、關於頁面、404 等。
分頁(無限滾動或標準分頁,即跨多個頁面發布)
Jekyll-feed 的 Atom Feeds
可切換訂閱按鈕(需要外部服務)
使用highlight.js 進行程式碼語法高亮顯示
支援 Google Analytics 追蹤
支持 Disqus 評論(非 Ghost 標準)
建置和部署網站有多種替代方案:
使用 GitHub Actions 建立站點,將產生的檔案( _site/
或../jasper2-pages/
的內容)推送到gh-pages分支。這是目前使用的方法。有關更多詳細信息,請參閱 jekyll_build.yml。
在本地生成網站(更多詳細資訊如下)並將生成的 HTML 推送到 Github 儲存庫,然後由 GitHub Pages 託管;
使用 travis-ci(帶有來自 jekyll-travis 的好東西)建立站點,自動將生成的 HTML 檔案推送到gh-pages分支。
使用與 Jekyll 相容的託管商(例如 https://www.netlify.com/)部署靜態網站,這些託管商允許從 Github 儲存庫進行部署並使用 CDN 發佈網站。 Netlify 提供免費入門優惠。
對於選項2),只需克隆此儲存庫( master 分支),然後在目錄內執行bundle exec jekyll serve
。將產生的_site/
(或../jasper2-pages/
)內容上傳到您的儲存庫(如果上傳到個人頁面(例如 username.github.io),則上傳 master 分支;如果作為專案頁面上傳,則上傳gh-pages 分支(用於演示)。
對於選項3),您需要為您的個人 fork 設定 travis-ci。簡而言之,您所需要的就是更改_config.yml中的詳細信息,以便您可以推送到您的 github 存儲庫。您還需要產生一個安全金鑰以新增至.travis.yml (您可以在該檔案中找到有關如何執行此操作的更多資訊)。請同時確保您閱讀了 jekyll-travis 的文檔。這種方法具有明顯的優勢,因為您只需將檔案變更推送到 GitHub,所有 HTML 檔案都會為您產生並推送到gh-pages 。您還可以了解您的網站建置是否一切正常。如果您仍有任何問題,請隨時與我聯絡(請參閱下面有關問題追蹤的資訊)。
為了正確產生作者頁面,您需要重新命名每篇文章前面的欄位作者,以符合_data/authors.yml檔案中定義的每個作者的使用者名稱。透過最新的更新,現在可以開箱即用地支援多個作者部落格。
以下介紹 Casper 樣式的編譯方式,如下所述:
Jasper2 樣式是使用 Gulp/PostCSS 編譯的,以填入未來的 CSS 規格。您需要全域安裝 Node 和 Gulp。之後,從主題的根目錄:
$ npm 安裝 $ 一口氣
現在您可以編輯/assets/css/
文件,該文件將自動編譯到/assets/built/
。
此安裝可以很好地與 Ruby v2.6.3 和 Jekyll v3.9.0 一起建置。如果您遇到任何問題,請將其記錄在問題追蹤器上。
請隨意要求您的補丁和修復。
非常感謝 Ghost 團隊所做的所有設計工作。也非常感謝所有貢獻者,他們幫助維持專案的活力和更新?
與 Ghost 團隊提供的許可證相同。請參閱 Casper 的主題許可證。
版權所有 (C) 2015-2021 - 根據 MIT 許可證發布。
特此免費授予任何獲得本軟體和相關文件文件(「軟體」)副本的人不受限制地使用本軟體,包括但不限於使用、複製、修改、合併的權利、發布、分發、再授權和/或銷售軟體的副本,並允許向其提供軟體的人員這樣做,但須滿足以下條件:
上述版權聲明和本授權聲明應包含在本軟體的所有副本或主要部分中。
本軟體以「現況」提供,不提供任何明示或暗示的保證,包括但不限於適銷性、特定用途的適用性和不侵權的保證。 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE軟體.