编译coffeescript的django模板标记
django-coffeescript的Python项目详细描述
此包未维护。
Django咖啡脚本
django coffeescript提供了模板标记，可以将coffeescript从模板编译成javascript。 它可以处理内联代码和扩展文件。
安装
- 将"coffeescript"添加到INSTALLED_APPS设置。
- 确保已安装coffee可执行文件。见 CoffeeScript official site了解详细信息。
- 也可以使用COFFEESCRIPT_EXECUTABLE设置指定coffee可执行文件的完整路径。 默认设置为coffee。
- 如果使用django的staticfiles contrib应用程序，则必须将django coffeescript的文件查找程序添加到STATICFILES_FINDERS设置中，例如：
STATICFILES_FINDERS = (
'django.contrib.staticfiles.finders.FileSystemFinder',
'django.contrib.staticfiles.finders.AppDirectoriesFinder',
# other finders..
'coffeescript.finders.CoffeescriptFinder',
)
示例用法
内联
{% load coffeescript %}
<script type="text/javascript">
{% inlinecoffeescript %}
console.log "Hello, World!"
{% endinlinecoffeescript %}
</script>
渲染到
<script type="text/javascript">
(function() {
console.log("Hello, World!");
}).call(this);
</script>
外部文件
{% load coffeescript %}
<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>
请注意，默认情况下，编译的文件保存在STATIC_ROOT下的COFFEESCRIPT_CACHE文件夹中（如果设置中没有STATIC_ROOT，则保存在MEDIA_ROOT文件夹中）。 您可以使用COFFEESCRIPT_ROOT和COFFEESCRIPT_OUTPUT_DIR设置更改此文件夹名。
设置
- COFFEESCRIPT_EXECUTABLE
- coffeescript编译器可执行文件的路径。默认值："coffee".
- COFFEESCRIPT_ROOT
- 控制编译文件将写入的绝对文件路径。默认值：STATIC_ROOT.
- COFFEESCRIPT_OUTPUT_DIR
- 控制COFFEESCRIPT_ROOT中编译文件将写入的目录。默认值："COFFEESCRIPT_CACHE".
- COFFEESCRIPT_USE_CACHE
- 是否对内联脚本使用缓存。默认值：True.
- COFFEESCRIPT_CACHE_TIMEOUT
- 内联脚本的缓存超时（秒）。默认值：30天。
- COFFEESCRIPT_MTIME_DELAY
- 读取外部脚本修改时间的缓存超时（秒）。默认值：10秒。
变化
0.7.2
- 使用hashlib而不是django 1.5中不推荐使用的django.utils.hashcompat
0.7.1
- 始终创建已编译的文件，即使没有从编译器接收到输出
0.7
- 添加coffeescript根设置
- 添加staticfiles finder以在开发模式下提供编译文件
0.6
- 在调试模式下查找文件时切换到staticfiles.finders。
0.5.1
- 添加对带前缀的静态文件目录的支持
0.5
- 在调试模式下，查找所有静态文件目录中的coffee脚本
0.4
- 记录Coffeescript编译错误
- 修复了Windows上路径的错误（由Syabro提供）
0.3
- 尽可能使用静态根/静态URL设置，而不是媒体根/媒体URL（由Roman Vorushin提供）
0.2.1
- 将changes.rst添加到manifest.in
0.2
- 自动从Coffeescript缓存中删除旧文件
- 添加基本单元测试
0.1
- 初始版本
欢迎加入QQ群-->： 979659372
