Blended

混合

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 网站都使用四个模板文件：

• header.html（必填）
• footer.html（必填）
• home_page.html（不是必需的，但网站看起来更好）
• content_page.html（不是必需的，但网站看起来更好）
• nav(name).html （您最多可以有 6 个不同的导航模板。例如navTest.html或nav_test.html ）
• page_list_item.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 导入

您可以从 WordPress 导入网站和帖子。为此，请使用Posts选项从 WordPress 导出，并将文件下载到您要生成网站的目录。

运行命令blended import-wp ，它将提示您输入文件的名称/文件路径。输入文件名，Blished 将使用该信息创建一个新网站。

从 Blogger 导入

您可以从 Blogger 导入帖子。为此，请使用Backup Site选项从 Blogger 导出，并将文件下载到您想要生成网站的目录。

运行命令blended import-blogger ，它将提示您输入文件的名称/文件路径。输入文件名，Blished 将使用该信息创建一个新网站。

预制模板

请记住，您可以使用blended install-template从 GitHub 安装模板。

• 简单（GitHub 页面）

• 博客（GitHub 页面）

• 软件展示（GitHub 页面）

插件

• Disqus（GitHub 页面）

• 谷歌分析（GitHub 页面）

• HTML 评论框（GitHub 页面）

• Twitter 卡（GitHub 页面）

• Facebook 卡片（GitHub 页面）

• Google 字体（GitHub 页面）

• 导入 Bootstrap（GitHub 页面）

使用混合的项目

• 混合网站

• 幻觉艺术网站重新设计

• 完整的渲染管理仪表板（GitHub 页面）

• DVDStyler 网站重新设计（GitHub 页面）

• MakeHuman 网站重新设计（GitHub 页面）

• LilyPond 网站重新设计（GitHub 页面）