简介
assemble-hekyll是一个npm包，它使用了Assemble插件和Handlebars模板引擎，可以方便地将Markdown文档转换为Jekyll网站的页面。
Jekyll是一个静态网站生成器，它可以将Markdown文档转换为HTML页面，并使用Liquid模板引擎引用页面元素，例如标题、文本、图像和链接。随着静态网站的流行，Jekyll已经成为一个广泛使用的选项。
Assemble是一个基于Grunt的网站生成器，它可以使用Handlebars模板引擎生成HTML页面。它可以与Jekyll集成，并使用Handlebars模板引擎扩展Jekyll功能。
assemble-hekyll是将两者结合在一起的npm包。
安装
使用npm全局安装assemble-hekyll：
npm install -g assemble-hekyll
使用
首先，进入Jekyll网站的根目录，并在其中创建一个新目录，用于存储Assemble文件。例如，如果Jekyll文件存储在_site目录中，则可以在其中创建一个名为_assemble的新目录。
安装assemble-hekyll后，可以使用其命令行界面生成HTML页面。该界面支持多种配置选项，例如源文件目录、目标文件目录、模板目录和Jekyll配置文件。
例如，要在_assemble目录中生成所有Markdown文件的HTML页面，请在命令行中输入以下命令：
assemble-hekyll build -s _assemble -d _site
这将生成一个新的HTML文件，放置在_site目录中，文件名与源文件相同并具有.html扩展名。
示例
下面是一个示例Markdown文件：
--- title: Example --- # 示例 这是一个示例，用于演示assemble-hekyll的用法。
在模板中，可以使用Handlebars模板引擎引用此文件中定义的元数据和HTML内容。以下是示例模板：
-- -------------------- ---- -------
--------- -----
------
------
----- ----------------
--------- ---------- ----------
-------
------
--- ---- ---
-------
-------在此模板中，使用{{{ body }}}引用页面的HTML内容。页面元数据则使用{{ page.title }}引用。
要使用assemble-hekyll创建此页面，请首先创建一个名为_assemble的新目录，然后向其中添加Markdown文件和模板文件。使用以下命令构建页面：
assemble-hekyll build -s _assemble -d _site
现在，将在生成的HTML页面中看到与示例Markdown文件和模板文件相对应的内容。
结论
assemble-hekyll是一个方便的npm包，可以快速而方便地将Markdown文档转换为Jekyll网站的页面。它使用了Assemble插件和Handlebars模板引擎，可以灵活和高效地组织页面内容。使用assemble-hekyll，您可以更轻松地创建漂亮且高效的Jekyll网站。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005625881e8991b448df968