简介
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:
--- ------- -- ---------------
使用
首先,进入Jekyll网站的根目录,并在其中创建一个新目录,用于存储Assemble文件。例如,如果Jekyll文件存储在_site
目录中,则可以在其中创建一个名为_assemble
的新目录。
安装assemble-hekyll后,可以使用其命令行界面生成HTML页面。该界面支持多种配置选项,例如源文件目录、目标文件目录、模板目录和Jekyll配置文件。
例如,要在_assemble
目录中生成所有Markdown文件的HTML页面,请在命令行中输入以下命令:
--------------- ----- -- --------- -- -----
这将生成一个新的HTML文件,放置在_site
目录中,文件名与源文件相同并具有.html
扩展名。
示例
下面是一个示例Markdown文件:
--- ------ ------- --- - -- ------------------------------
在模板中,可以使用Handlebars模板引擎引用此文件中定义的元数据和HTML内容。以下是示例模板:
--------- ----- ------ ------ ----- ---------------- --------- ---------- ---------- ------- ------ --- ---- --- ------- -------
在此模板中,使用{{{ body }}}
引用页面的HTML内容。页面元数据则使用{{ page.title }}
引用。
要使用assemble-hekyll创建此页面,请首先创建一个名为_assemble
的新目录,然后向其中添加Markdown文件和模板文件。使用以下命令构建页面:
--------------- ----- -- --------- -- -----
现在,将在生成的HTML页面中看到与示例Markdown文件和模板文件相对应的内容。
结论
assemble-hekyll是一个方便的npm包,可以快速而方便地将Markdown文档转换为Jekyll网站的页面。它使用了Assemble插件和Handlebars模板引擎,可以灵活和高效地组织页面内容。使用assemble-hekyll,您可以更轻松地创建漂亮且高效的Jekyll网站。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/6005625881e8991b448df968