Blended 是一個用 Python 編寫的靜態網站產生器,並根據 GPL 3.0 開源授權授權。它支援基於 HTML 的模板系統、以 HTML、Markdown、Textile、reStructuredText、Jade、Docx 和純文字編寫的內容。它也支援SASS、Less、Stylus和CoffeeScript的編譯。 Blended 透過內建的 FTP 上傳器讓您可以輕鬆部署網站。此外,Blded 具有強大的可升級性,因為它支援 Python 插件系統。
若要從 PyPi 安裝 Blended(建議),請執行:
pip install blended
要從原始程式碼運行建置並安裝 Blended:
git clone https://github.com/johnroper100/Blended.git
cd Blended
pip install .
安裝後要使用 Blended,請執行:
blended init
這將幫助您啟動一個新網站。如果您需要協助,請運行:
blended --help
您將看到所有可用的命令。
建立您使用 Blended run 建立的站點
blended build
或者
blended interactive
(用於文件更改建置)
對於您執行的任何命令,您可以指定一個替代的--outdir
來建置或檢視。例如,要建置到source_output
資料夾,請執行blended build --outdir source_output
。
在config.py
檔案中,您可以將minify_css
和minify_js
設定為 true,以在建置後最佳化 CSS 和 JS 檔案。
您可以使用blended install-template
從 GitHub 安裝範本。
每個 Blended 網站都使用四個範本檔案:
navTest.html
或nav_test.html
){name}
、 {content}
、 {content_short}
、 {date}
、 {day}
、 {month}
、 {month_name}
{year}
, {path}
)在這些文件中,您可以為要產生的每個部分放置標記。
使用頁面時,您可以選擇指定所需的範本(除了content_page.html
),方法是將範本檔案的名稱(不含副檔名)新增至頁面的第一行,然後在第二行新增至少 5 個+
s 。例如,如果我想對某個頁面使用名為blog_page.html
的模板,我會輸入
blog_page
+++++
在頁面頂部。確保將其放在頂部,否則將無法工作!
您可以在模板中使用一些變數來在建置時提取值:
{website_name}
{website_description}
{website_description_long}
(用於長描述,例如作者簡介){author_name}
{author_bio}
{website_language}
{website_license}
{website_url}
{page_content}
(只能在content_page.html範本檔案中使用){page_date}
(頁面寫入/修改的日期/時間){page_day}
(頁面編寫/修改的日期){page_month}
(頁面編寫/修改的月份){page_month_name}
(頁面編寫/修改的月份名稱){page_year}
(頁面編寫/修改的年份){relative_root}
(傳回目前檔案的相對路徑){random_number}
{build_date}
{build_time}
{build_datetime}
{
(page_filename) _active}
(建置時,如果活動頁面等於標記中的檔案名,則標記將替換為active
ex. {getting-started.html_active}
){nav
(name) }
(用於放置導覽列。若要新增導覽列,請撰寫nav
加上其他內容。例如, {nav2}
或{nav_test}
){page_list}
(以<ul><li><a href="page-name.html">page-name</a></li></ul>
格式列出所有頁面){page_file}
(頁面的完整檔案名稱。例如getting-started.html
){page_filename}
(不含 .html 副檔名的頁面檔名。例如getting-started
){page_name}
(給出目前頁面的名稱。讓頁面名稱看起來更漂亮。例如, getting-started.html
轉換為Getting Started
){page_folder}
(給出目前頁面資料夾的名稱。讓資料夾名稱看起來更漂亮。例如, getting-started
轉換為Getting Started
){page_folder_orig}
(給出目前頁面資料夾的名稱){blended_version}
(提供 Blended 的目前版本){blended_version_message}
(為 Blended 的當前版本提供一條不錯的消息: Built with Blended v4.9
)無論您將這些變數放在模板中的何處,它們都將被 config.py 檔案中的值取代。變數必須位於大括號內。您甚至可以將變數放入其他變數的內容中!
您可以從 PyPi 安裝插件,例如pip install blended_google_analytics
。您也可以使用blended install-plugin
從 GitHub 安裝插件。
若要使用插件,請將它們包含在config.py
的plugins
清單中。
如果該插件要在您的模板中調用,例如。 {html_comment_box}
然後將其插入外掛程式清單中,如plugins = ["html_comment_box"]
。
您可以一次使用多個插件,例如。 plugins = ["html_comment_box", "minify_images"]
在config.py
內部有一個變數custom_variables = {}
。這是您想要使用的所有自訂變數的字典。若要新增變量,請將其新增為字典項。
以下是一些範例:
custom_variables = {"software_name": "Blended"}
custom_variables = {"software_name": "Blended", "software_version": "5.0"}
您可以從 WordPress 匯入網站和貼文。為此,請使用Posts
選項從 WordPress 匯出,並將檔案下載到您要產生網站的目錄。
執行命令blended import-wp
,它將提示您輸入檔案的名稱/檔案路徑。輸入檔名,Blished 將使用該資訊建立一個新網站。
您可以從 Blogger 匯入貼文。為此,請使用Backup Site
選項從 Blogger 匯出,並將檔案下載到您想要產生網站的目錄。
執行命令blended import-blogger
,它將提示您輸入檔案的名稱/檔案路徑。輸入檔名,Blished 將使用該資訊建立一個新網站。
請記住,您可以使用blended install-template
從 GitHub 安裝範本。
簡單(GitHub 頁面)
部落格(GitHub 頁面)
軟體展示(GitHub 頁面)
Disqus(GitHub 頁面)
Google分析(GitHub 頁面)
HTML 評論框(GitHub 頁面)
Twitter 卡(GitHub 頁面)
Facebook 卡片(GitHub 專頁)
Google 字型(GitHub 頁面)
導入 Bootstrap(GitHub 頁面)
混合網站
幻覺藝術網站重新設計
完整的渲染管理儀表板(GitHub 頁面)
DVDStyler 網站重新設計(GitHub 頁面)
MakeHuman 網站重新設計(GitHub 頁面)
LilyPond 網站重新設計(GitHub 頁面)