跳转到主要内容

Django模板标签,用于将CoffeeScript内联或从文件编译。

项目描述

django-coldbrew最初是Django Coffeescript的一个分支。

ColdBrew提供模板标签,将CoffeeScript编译成JavaScript(从模板中)。它支持内联代码和外部文件。

安装

  1. "coldbrew"添加到INSTALLED_APPS设置。

  2. 确保您已安装coffee可执行文件。有关详细信息,请参阅CoffeeScript官方站点

  3. 可选地,您可以使用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

  • 首次发布

项目详情


支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面