django模板标记编译成css更少
django-less的Python项目详细描述
此包未维护。
django小于
django less提供了模板标记,可以从模板将less编译成css。 它可以处理内联代码和扩展文件。
安装
- 将"less"添加到INSTALLED_APPS设置。
- 确保已安装lessc可执行文件。见 LESS official site了解详细信息。
- 也可以使用LESS_EXECUTABLE设置指定lessc可执行文件的完整路径。 默认设置为lessc。
- 如果使用django的staticfiles contrib应用程序,则必须将django less的文件查找程序添加到STATICFILES_FINDERS设置中,例如:
STATICFILES_FINDERS = ( 'django.contrib.staticfiles.finders.FileSystemFinder', 'django.contrib.staticfiles.finders.AppDirectoriesFinder', # other finders.. 'less.finders.LessFinder', )
示例用法
内联
{% load less %} <style> {% inlineless %} #header { h1 { font-size: 26px; font-weight: bold; } p { font-size: 12px; a { text-decoration: none; &:hover { border-width: 1px } } } } {% endless %} </style>
呈现到
<style> #header h1 { font-size: 26px; font-weight: bold; } #header p { font-size: 12px; } #header p a { text-decoration: none; } #header p a:hover { border-width: 1px; } </style>
外部文件
{% load less %} <link rel="stylesheet" href="{{ STATIC_URL}}{% less "path/to/styles.less" %}" />
渲染到
<link rel="stylesheet" href="/media/LESS_CACHE/path/to/styles-91ce1f66f583.css" />
请注意,默认情况下,编译的文件保存在STATIC_ROOT下的LESS_CACHE文件夹中(如果设置中没有STATIC_ROOT,则保存在MEDIA_ROOT文件夹中)。 您可以使用LESS_ROOT和LESS_OUTPUT_DIR设置更改此文件夹
注意,样式表中的所有相对url都使用STATIC_URL设置转换为绝对url。
设置
- LESS_EXECUTABLE
- 更少编译器可执行文件的路径。默认值:"lessc".
- LESS_OPTIONS
- 发送到lessc的选项。默认值:[].
- LESS_ROOT
- 控制编译文件将写入的绝对文件路径。默认值:STATIC_ROOT.
- LESS_OUTPUT_DIR
- 控制LESS_ROOT中编译文件将写入的目录。默认值:"LESS_CACHE".
- LESS_USE_CACHE
- 是否对内联样式使用缓存。默认值:True.
- LESS_CACHE_TIMEOUT
- 内联样式的缓存超时(秒)。默认值:30天。
- LESS_MTIME_DELAY
- 读取外部样式表修改时间的缓存超时(秒)。默认值:10秒。
变化
0.7.2
- 添加较少的配置变量
- 使用urlparse而不是posixpath在url中留下双斜杠。
- 在编译错误时引发异常。
0.7.1
- 使用hashlib而不是django 1.5中不推荐使用的django.utils.hashcompat
- 在Windows上运行时,将shell=true添加到弹出参数。
0.7
- 添加staticfiles finder以在开发模式下提供编译文件
0.6
- 添加较少的根设置
0.5.1
- 在较少的文件中用非ascii修复unicodedecodeerror
0.5
- 在调试模式下查找文件时切换到staticfiles.finders
0.4
- 添加对staticfiles目录中查找的支持
0.3
- 无日志编译错误
- 修复了Windows上路径的错误
0.2
- 尽可能使用静态根/静态URL设置,而不是媒体根/媒体URL
0.1
- 初始版本