noflo jekyll

基于流量的jekyll静态站点生成器的重新实现。这为Node.js，尤其是NOFLO开发人员提供了一些优势：

• 纯JavaScript ，在您的环境中不需要Ruby或其他运行时间。如果您将Grunt用于现场生成，特别是方便的
• 其他数据源，在noflo中，一切都只是数据流。您可以轻松地插入其他数据源。例如，数据库查询结果
• 不同的转换器，不想使用Markdown？只需插入您自己的标记处理器组件
• 不同的模板引擎不想使用液体？只需插入您自己的模板处理器组件
• 用作库或可执行文件，此Jekyll实现只是一个NOFLO图。您可以在其他noflo应用程序中使用它，作为node.js模块，也可以用作命令行可执行文件

但是，与积极开发的应用程序的任何重新实现一样，还有一些潜在的警告需要观察。

noflo jekyll已作为NOFLO图实现。大多数逻辑都由各种现有的NOFLO组件来处理，但是在某些地方，将事物作为自定义组件有意义。但是，超过85％的代码库是完全可重复使用的。

这是使用noflo ui可视化时的主要流程：

您可以从图形文件夹中找到主流量和不同的子图。

如果要将其用作命令行可执行文件，那么最简单的选项是用以下方式在全球安装它。

 $ npm install -g noflo-jekyll

如果要将其用作较大应用程序中的库，则只需将其作为依赖项安装：

 $ npm install noflo-jekyll --save

由于该项目的目的是与Jekyll的功能均衡，因此命令行的使用情况相似。要生成一个站点，请运行：

 $ noflo-jekyll source_dir target_dir

站点生成图也可以用作Node.js应用程序中的库。

 var Jekyll , generator ;
Jekyll = require ( 'noflo-jekyll' ) . Jekyll ;

// Prepare the site generator
generator = new Jekyll ( 'source_dir' , 'target_dir' ) ;

// Event handling
generator . on ( 'start' , function ( ) {
  console . log ( "Build started" ) ;
} ) ;

generator . on ( 'error' , console . error ) ;

generator . on ( 'end' , function ( end ) {
  var seconds = end . uptime / 1000 ;
  console . log ( "Build finished in " + seconds ) ;
} ) ;

// Start the process
generator . run ( ) ; 

主要的站点生成流程为jekyll/Jekyll图。这是在另一个图中使用它的一个简单示例：

 # Directory setup
'/some/source/directory' -> SOURCE Generator(jekyll/Jekyll)
'/some/target/directory' -> DESTINATION Generator()

# Outputs
Generator() GENERATED -> IN Drop(Drop)
Generator() ERRORS -> IN Display(Output)

我们使用的液体模板库不覆盖液体规格的100％，因此与Jekyll一起使用的某些模板参数可能尚不正常。

我们正在与液体节点开发人员合作以改善覆盖范围，这也是您可以提供帮助的。如果您使用的是不起作用的问题，请报告一个问题！

当这个项目开始时，杰基尔仍处于1.0之前的阶段，其发展已经停止。从那时起，它的开发恢复了，1.0添加了我们尚未提供的功能。其中包括：

• 草稿职位
• 时带
• baseurl

请报告您遇到这些或其他Jekyll功能的任何问题。

Ruby Jekyll包含用于测试目的的基本Web服务器。由于这超出了静态站点生成的范围，因此noflo jekyll实施中未包含此功能。您可以在许多方面使用生成的页面，包括Grunt-Contrib-Connect，Simple-Server或Noflo Web服务器。

欢迎任何丢失的Jekyll功能或其他问题的拉动请求！如果您想与存储库一起工作，最好能够在本地进行测试。

我们的主体测试由jekyll网站源组成，该网站源是我们使用Ruby Jekyll生成静态站点的test/fixtures/source 。我们通过相同来源运行noflo jekyll ，并检查结果是否相同（除了某些空格差异外）。

如果您发现noflo jekyll无法正确处理的东西，请将它们添加到该jekyll站点源，然后使用以下方式运行Ruby Jekyll固定装置。

 $ grunt jekyll

此后，您应该能够使用以下方式进行测试：

 $ grunt test