Django模板标签,用于将CoffeeScript内联或从文件编译。
项目描述
django-coldbrew最初是Django Coffeescript的一个分支。
ColdBrew提供模板标签,将CoffeeScript编译成JavaScript(从模板中)。它支持内联代码和外部文件。
安装
将"coldbrew"添加到INSTALLED_APPS设置。
确保您已安装coffee可执行文件。有关详细信息,请参阅CoffeeScript官方站点。
可选地,您可以使用COFFEESCRIPT_EXECUTABLE设置指定coffee可执行文件的完整路径。默认设置为coffee。
示例用法
外部文件
{% load coldbrew %} <script type="text/javascript" src="{{ STATIC_URL}}{% coffeescript "path/to/script.coffee" %}"> </script>
渲染为
<script type="text/javascript" src="/media/COFFEESCRIPT_CACHE/path/to/script-91ce1f66f583.js"> </script>
内联
{% load coldbrew %} <script type="text/javascript"> {% inlinecoffeescript %} console.log "Hello, World!" {% endinlinecoffeescript %} </script>
渲染为
<script type="text/javascript"> (function() { console.log("Hello, World!"); }).call(this); </script>
请注意,默认情况下,编译的文件将保存到您设置中的STATIC_ROOT(或如果没有STATIC_ROOT,则为MEDIA_ROOT)下的COFFEESCRIPT_CACHE文件夹中。您可以使用COFFEESCRIPT_OUTPUT_DIR设置更改此文件夹名称。
设置
- COFFEESCRIPT_EXECUTABLE
咖啡脚本编译器可执行文件的路径。默认:"coffee"。
- COFFEESCRIPT_OUTPUT_DIR
编译的外部脚本输出目录。它是相对于STATIC_ROOT的。默认:"COFFEESCRIPT_CACHE"。
- COFFEESCRIPT_USE_CACHE
是否使用缓存内联脚本。默认:True。
- COFFEESCRIPT_CACHE_TIMEOUT
内联脚本的缓存超时时间(秒)。默认:30天。
- COFFEESCRIPT_MTIME_DELAY
读取外部脚本修改时间的缓存超时时间(秒)。默认:10秒。
- COLDBREW_FAIL_LOUD
如果为真,遇到编译错误时将抛出ColdBrewCompileError。否则,记录到错误日志。默认与DEBUG相同。
变更
0.5
添加COLDBREW_FAIL_LOUD设置 添加测试覆盖率标签 现在可以与staticfiles应用一起使用
以下变更是在从django-coffeescript分叉之前进行的*
0.4
记录coffeescript编译错误
修复Windows上的路径问题(由syabro修复)
0.3
尽可能使用STATIC_ROOT / STATIC_URL设置而不是MEDIA_ROOT / MEDIA_URL(由Roman Vorushin提供)
0.2.1
将CHANGES.rst添加到MANIFEST.in
0.2
自动从COFFEESCRIPT_CACHE中删除旧文件
添加基本单元测试
0.1
首次发布