.LESS Web.config/DotlessConfiguration 选项

引言

许多 .LESS CSS 解析器的选项可以直接在 Web.config 文件中设置，但其中许多选项没有得到清晰的描述。这是我尝试记录它们。

lessSource

设置要使用的文件读取器类的名称（必须实现 dotless.Core.Input.IFileReader 接口）。默认值为 dotless.Core.Input.FileReader。

minifyOutput

指示 .LESS 解析器生成的 CSS 是否应随后被最小化。出于性能原因，您可能希望最小化文件，但如果您已经使用 System.Web.Optimization 框架进行最小化，则可以将其关闭。默认值为 false。

debug

设置调试模式，该模式会在控制台输出中打印注释。默认值为 false。

cacheEnabled

指示是否应通过设置 HTTP 标头，由 Web 浏览器缓存从 LESS 文件生成的 CSS 7 天，否则浏览器将始终重新加载 CSS 文件。默认值为 true。

web

指示 .LESS 是在 Web 应用程序中运行还是从命令行运行。根据其他配置以及您可能使用的自定义日志记录器或文件读取器，即使 Web 模式关闭，您的 Web 应用程序也可能正常工作。默认值为 false。

mapPathsToWeb

当 .LESS 作为 Web 应用程序运行时，指示是否应将路径映射到网站的位置。否则，路径相对于当前目录，以允许文件位于 Web 目录结构之外。默认值为 true。

sessionMode

Dotless 不需要会话，但可以通过此选项启用它以在插件中使用会话。可能的值为 Enabled、QueryParam （请参阅下一节）和 Disabled，默认值为 Disabled。

sessionQueryParamName

当 sessionMode 为 QueryParam 时，必须在查询字符串中添加一个参数，以便可以使用会话。参数的名称可以通过此选项指定，默认值为 sstate。

logger

设置要用于记录解析错误的日志记录器名称（必须实现 dotless.Core.Loggers.ILogger 接口）。在 .LESS 版本 1.3.1 之前，它与 Web.config 不兼容，但可以从 DotlessConfiguration 对象手动设置。默认值为 null，但有两个可用的日志记录器：dotless.Core.Loggers.ConsoleLogger （记录到 Visual Studio 控制台输出）和 dotless.Core.Loggers.DiagnosticsLogger （记录到当前应用程序使用的跟踪侦听器）。

logLevel

设置记录解析器错误的级别。可能的值为 Info、Debug、Warn 和 Error，默认值为 Error。请注意，默认情况下未设置日志记录器。

优化

.LESS 通过将 .LESS 文件分成块并解析每个块而不是一次解析整个文件来优化解析。如果值为 0，则不优化操作，如果值大于 0 则使用优化。默认值为 1。

插件

包含应用程序使用的 .LESS 插件列表。插件用于向 .LESS 添加新函数，并创建实现 IFunctionPlugin 接口的类。默认情况下，不添加任何插件。要添加插件

<dotless>
  <plugin name="PluginClassName" assembly="PluginAssemblyName" />
</dotless>

disableUrlRewriting

指示是否应根据导入它的 LESS 文件的位置来调整导入文件中的 URL。默认值为 false。

inlineCssFiles

指示当 @import 指令导入的文件是 CSS 文件时，文件的内容应直接放在输出中，而不是尝试将其解析为 LESS 文件，而不是保留 import 指令。默认值为 false。

importAllFilesAsLess

指示是否应将所有导入的文件作为 LESS 文件处理，即使它们以 .css 扩展名结尾，否则只有 .less 文件才会被作为 LESS 处理。默认值为 false。

handleWebCompression

指示 .LESS 是否应根据请求的 Accept-Encoding 标头处理响应的压缩，否则它不会被压缩，并且可以通过设置 IIS 选项来压缩（相同的响应不应被压缩两次）。Accept-Encoding 标头支持 gzip、deflate 和 identity 选项。默认值为 true ，如果标头中未找到兼容的压缩方法，则默认使用的编码为 gzip。

disableParameters

指示 .LESS 是否应忽略查询字符串的参数，或者是否应在 ParameterDecorator 请求的 LESS 文件中将参数定义为变量。例如，如果启用了参数，style.less?param=value 将被添加为 LESS 文件中的 @param: value;（值应进行 URL 编码）。默认值为 false。

disableVariableRedefines

指示应禁用重新定义变量，因此 less 会从文件底部向上搜索。这用于使 .LESS 在处理变量时表现得像 Less.js。默认值为 false。

keepFirstSpecialComment

指示 LESS 文件中以 /** 开头的第一个注释即使在最小化后也应该保留。默认值为 false。

如果您需要使用 Web.config 中不起作用的选项，Less.Parse 方法可以接受一个 DotlessConfiguration 对象作为参数。在我的情况下，我已经使用了 System.Web.Optimization 进行 CSS 文件的最小化和捆绑，所以我创建了自己的捆绑转换类，它实现了 IBundleTransform 接口并调用解析器。