blog-engine-06-pelican 靜態網站生成 支持 markdown 和 reST 語法

拓展閱讀

blog-engine-01-常見博客引擎 jekyll/hugo/Hexo/Pelican/Gatsby/VuePress/Nuxt.js/Middleman 對比

blog-engine-02-通過博客引擎 jekyll 構建 github pages 博客實戰筆記

blog-engine-02-博客引擎jekyll-jekyll 博客引擎介紹

blog-engine-02-博客引擎jekyll-jekyll 如何在 windows 環境安裝,官方文檔

blog-engine-02-博客引擎jekyll-jekyll SEO

blog-engine-04-博客引擎 hugo intro 入門介紹+安裝筆記

blog-engine-05-博客引擎 Hexo 入門介紹+安裝筆記

blog-engine-06-pelican 靜態網站生成 官方文檔

blog-engine-06-pelican 靜態網站生成 windows 安裝實戰

blog-engine-07-gatsby 建極速網站和應用程序 基於React的最佳框架,具備性能、可擴展性和安全性

blog-engine-08-vuepress 以 Markdown 爲中心的靜態網站生成器

blog-engine-09-nuxt 構建快速、SEO友好和可擴展的Web應用程序變得輕鬆

blog-engine-10-middleman 靜態站點生成器,利用了現代 Web 開發中的所有快捷方式和工具

前言

由於個人一直喜歡使用 markdown 來寫 個人博客,最近就整理了一下有哪些博客引擎。

感興趣的小夥伴也可以選擇自己合適的。

pelican

Pelican 是一個靜態網站生成器,用Python編寫,它允許您通過編寫Markdown、reStructuredText和HTML等格式的文本文件來創建網站。

使用Pelican,您可以創建網站而無需擔心數據庫或服務器端編程。Pelican生成可以通過任何網絡服務器或託管服務提供的靜態站點。

您可以使用Pelican執行以下功能:

  • 使用您選擇的編輯器在Markdown或reStructuredText中編寫內容

  • 簡單的命令行工具重新生成HTML、CSS和JS源內容

  • 易於與版本控制系統和Web掛鉤進行接口

  • 完全靜態的輸出可以簡單地託管在任何地方

功能特點

Pelican的功能亮點包括:

  • 時間排序的內容(例如,文章、博客文章)以及靜態頁面

  • 與外部服務的集成

  • 站點主題(使用Jinja2模板創建)

  • 在多種語言中發佈文章

  • 生成Atom和RSS訂閱源

  • 通過Pygments進行代碼語法高亮顯示

  • 從WordPress、Dotclear或RSS訂閱源導入現有內容

  • 由於內容緩存和選擇性輸出編寫,重建速度快

  • 可通過豐富的插件生態系統進行擴展:Pelican插件

查看 Pelican 文檔 以獲取更多信息。

爲什麼叫“Pelican”?

“Pelican”是“calepin”的一個變位詞,法語中意爲“筆記本”。

Pelican主題

該存儲庫包含了用於Pelican的主題。請隨意克隆、添加您自己的主題,並提交拉取請求。這是由社區管理的!

您可以在 http://www.pelicanthemes.com 查看實時版本。

使用主題

以下說明假定您已經閱讀了所有Pelican文檔,有一個工作站點,並且現在想要應用一個非默認主題。

首先,選擇一個位置來存放您的主題。對於這個示例,我們將使用目錄~/pelican-themes,但您的目錄可能不同。

在您的本地機器上將pelican-themes存儲庫克隆到該位置:

git clone --recursive https://github.com/getpelican/pelican-themes ~/pelican-themes

現在您應該在 ~/pelican-themes/ 下存儲您的 pelican-themes 存儲庫。

要使用其中一個主題,請編輯您的Pelican設置文件以包含以下行:

THEME = "/home/user/pelican-themes/theme-name"

所以,例如,要使用mnmlist主題,您將編輯您的設置文件以包含:

THEME = "/home/user/pelican-themes/mnmlist"

保存對設置文件的更改,然後使用您已經設置的 pelican-quickstart Makefile 重新生成您的站點:

make html

也可以通過-pelican命令的 -t ~/pelican-themes/theme-name 參數直接指定主題。

如果您想要編輯您的主題,請確保您所做的任何編輯都是針對存儲在~/pelican-themes/theme-name中的副本進行的。

對於存儲在站點輸出目錄中的文件所做的任何更改都將在下次生成站點時被刪除。

Pelican插件
重要提示:我們正在將插件從這個單一的存儲庫遷移到它們自己的獨立存儲庫,這些存儲庫位於新的Pelican插件組織下,這是一個供插件作者與Pelican維護者和社區其他成員更廣泛合作的地方。我們的意圖是讓所有新組織下的插件都採用新的“命名空間插件”格式,這意味着這些插件可以輕鬆地通過Pip安裝,並且Pelican 4.5+可以立即識別它們——而不必顯式啓用它們。

這個過渡過程需要一些時間,因此我們感謝您在此期間的耐心等待。如果您想幫助加速這個過渡,以下內容將非常有幫助:

  • 如果您在這裏找到一個尚未遷移到新組織的插件,請在這個存儲庫下創建一個新的問題,並說明您想要幫助遷移的插件,之後Pelican維護者將指導您完成此過程。
  • 如果您來到這裏提交一個拉取請求以添加您的插件,請考慮將您的插件移動到Pelican插件組織下。要開始,請在這個存儲庫下創建一個新的問題,提供您插件的詳細信息,之後Pelican維護者將指導您完成此過程。
  • 無論您是創建新插件還是遷移現有插件,請使用提供的Cookiecutter模板生成符合社區約定的腳手架命名空間插件。查看Simple Footnotes存儲庫,以查看一個已遷移插件的示例。

以下其餘信息與傳統插件相關,但不適用於Pelican插件組織中的新命名空間插件。

如何使用插件

安裝和使用這些插件的最簡單方法是克隆這個存儲庫:

git clone --recursive https://github.com/getpelican/pelican-plugins

並在您的設置文件中激活您想要的插件:

PLUGIN_PATHS = ['path/to/pelican-plugins']
PLUGINS = ['assets', 'sitemap', 'gravatar']

PLUGIN_PATHS可以是相對於您的設置文件的路徑,也可以是絕對路徑。

或者,如果插件位於可導入的路徑中,您可以省略PLUGIN_PATHS並列出它們:

PLUGINS = ['assets', 'sitemap', 'gravatar']

或者您可以直接導入插件並給出:

import my_plugin
PLUGINS = [my_plugin, 'assets']
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章