Ruby on Rails 清单文件和指令

示例

在assetsinitalizer（ config/initializers/assets.rb）有一些文件明确定义为预编译。

# 预编译其他资产。
# 已经添加了application.coffee，application.scss和app / assets文件夹中的所有非JS / CSS。
# Rails.application.config.assets.precompile + =％w(search.js)

在此示例中，application.coffee和application.scss被称为“清单文件”。此文件应用于包含其他JavaScript或CSS资产。可以使用以下命令：

• require <path>：该require指令的功能类似于Ruby自己的require。它提供了一种声明路径中文件依赖项的方法，并确保仅在源文件之前加载一次。

• require_directory <path>：需要单个目录中的所有文件。之所以类似，是path/*因为它不遵循嵌套目录。

• require_tree <path>：需要目录中的所有嵌套文件。其等效glob为path/**/*。

• require_self：导致当前文件的正文插入到任何后续require指令之前。在CSS文件中很有用，其中索引文件通常包含需要在加载其他依赖项之前定义的全局样式。

• stub <path>：从包含文件中删除文件

• depend_on <path>：允许您声明对文件的依赖关系而不包含它。这用于缓存目的。对依赖文件所做的任何更改将使源文件的缓存无效。

一个application.scss文件可能看起来像：

/*
 *= require bootstrap
 *= require_directory .
 *= require_self
 */

另一个示例是application.coffee文件。这里包括jquery和Turbolinks：

#=需要jquery2
#=需要jquery_ujs
#=需要Turbolinks
#= require_tree。

如果您不使用CoffeeScript，而是使用纯JavaScript，则语法为：

//=需要jquery2
//=需要jquery_ujs
//=需要Turbolinks
//= require_tree。