Django模板标记,用于内联或从文件编译coffeescript。
django-coldbrew的Python项目详细描述
django coldbrew最初是django coffeescript的叉子。
coldbrew提供了模板标记来将coffeescript从模板编译成javascript。 它可以处理内联代码和外部文件。
安装
- 将"coldbrew"添加到INSTALLED_APPS设置。
- 确保已安装coffee可执行文件。见 CoffeeScript official site了解详细信息。
- 也可以使用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下的COFFEESCRIPT_CACHE文件夹中(如果设置中没有STATIC_ROOT,则保存在MEDIA_ROOT文件夹中)。 您可以使用COFFEESCRIPT_OUTPUT_DIR设置更改此文件夹名。
设置
- COFFEESCRIPT_EXECUTABLE
- coffeescript编译器可执行文件的路径。默认值:"coffee".
- COFFEESCRIPT_OUTPUT_DIR
- 已编译外部脚本的输出目录。它是相对于STATIC_ROOT的。默认值:"COFFEESCRIPT_CACHE".
- COFFEESCRIPT_USE_CACHE
- 是否对内联脚本使用缓存。默认值:True.
- COFFEESCRIPT_CACHE_TIMEOUT
- 内联脚本的缓存超时(秒)。默认值:30天。
- COFFEESCRIPT_MTIME_DELAY
- 读取外部脚本修改时间的缓存超时(秒)。默认值:10秒。
- COLDBREW_FAIL_LOUD
- 如果为true,则在遇到编译错误时引发coldbrewcompiler错误。 否则,记录到错误日志。 默认为与调试相同。
更改
0.5
添加了Coldbrew_fail_loud设置 增加了测试覆盖率 标记现在可用于StaticFiles应用程序
*下面的更改是在从django coffeescript派生fork之前进行的*
0.4
- 记录Coffeescript编译错误
- 修复了Windows上路径的错误(由Syabro提供)
0.3
- 尽可能使用静态根/静态URL设置,而不是媒体根/媒体URL(由Roman Vorushin提供)
0.2.1
- 将changes.rst添加到manifest.in
0.2
- 自动从Coffeescript缓存中删除旧文件
- 添加基本单元测试
0.1
- 初始版本