django-ace为Ace提供了与Django的集成。
项目描述
django-ace为Ace - The High Performance Code Editor for the Web与Django提供集成。
django-ace是Bradley Ayers基于Kit Sunde的django-ace-editor的一个分支,由Julien Palard等人继续开发。
这是Florian Demmer的另一个分支;通过比较变更日志和源代码,决定是否需要更改或更好的使用上游。
使用方法
from django import forms
from django_ace import AceWidget
class EditorForm(forms.Form):
text = forms.CharField(widget=AceWidget)
可以通过指定语言来启用语法高亮和静态分析
class EditorForm(forms.Form):
text = forms.CharField(widget=AceWidget(mode='css'))
也支持主题
class EditorForm(forms.Form):
text = forms.CharField(widget=AceWidget(mode='css', theme='twilight'))
要完全禁用语法检查器,请禁用Web Worker
class EditorForm(forms.Form):
text = forms.CharField(widget=AceWidget(
mode='css', theme='twilight', use_worker=False
))
所有选项及其默认值如下
class EditorForm(forms.Form):
text = forms.CharField(widget=AceWidget(
mode=None, # try for example "python"
theme=None, # try for example "twilight"
use_worker=True,
wordwrap=False,
width="500px",
height="300px",
minlines=None,
maxlines=None,
showprintmargin=True,
showinvisibles=False,
usesofttabs=True,
tabsize=None,
fontsize=None,
toolbar=True,
readonly=False,
showgutter=True, # To hide/show line numbers
behaviours=True, # To disable auto-append of quote when quotes are entered
))
安装
使用pip安装
pip install django_ace
更新INSTALLED_APPS
INSTALLED_APPS = (
# ...
'django_ace',
)
示例项目
源代码中包含一个示例项目,要尝试它请
# install in virtualenv
cd example/
virtualenv .env
. .env/bin/activate
pip install -e ..
# prepare sqlite database
./manage.py makemigrations app
./manage.py migrate
# user for admin access
./manage.py createsuperuser
# run dev-server
./manage.py runserver
然后浏览到https://:8000或https://:8000/admin。
变更日志
v2.2.1
将Ace编辑器更新到v1.32.3
公开了由@okaycj在上游v1.32.0中贡献的扩展
v2.1.0
将Ace编辑器更新到v1.31.2
添加CSS以与Django 4.2中的admin更改一起使用。现在您可以使用width="100%"而不会破坏布局。(Anh Tran <anhtran.sky@gmail.com>在上游v1.15.4中)
用ruff替换flake8
版本 v2.0.0
更新 Ace 编辑器到版本 v1.10.1 并使用压缩版本
代码的一般清理和现代化
更新示例,使用 TabularInline 中的小部件
更新打包工作由 Julien Palard 完成
需要 Python >= 3.6
版本 v1.1.0
重写 init() 函数以支持管理内联表单
新增小部件选项 use_worker
使用模板引擎生成小部件 HTML
重写布尔数据属性
添加测试,更新示例以包含管理集成
最后一个支持 Python 2.7 的版本
版本 v1.0.11
支持 Grappelli 内联功能。
版本 v1.0.10
修复使用 JavaScriptCatalog 时出现的 JavaScript 错误。
版本 v1.0.9
新增小部件选项 showgutters 用于隐藏行号。
新增小部件选项 behaviours 用于避免自动插入引号。
版本 v1.0.8
新增小部件选项 readonly。
更新 ACE 编辑器到版本 v1.4.12。
版本 v1.0.7
新增小部件选项 toolbar。
更新 ACE 编辑器到版本 v1.4.8。
版本 v1.0.6
新增小部件选项 fontsize。
更新 ACE 编辑器到版本 v1.4.7。
版本 v1.0.5
新增小部件选项 tabsize。
升级 ACE 编辑器到版本 v1.4.2。
版本 v1.0.4
更新 Django 兼容性到 >1.11,<=2.1
新增小部件选项 minLines、maxLines、showinvisibles、usesofttabs。
升级 ACE 编辑器到版本 v1.4.0。
更新 Django 1.11 的示例
PEP8 改进
版本 v1.0.2
升级 ACE 编辑器到版本 1.1.8
添加对 showprintmargin 的支持
版本 v1.0.1
通过删除已弃用的导入来添加对 Django 1.7 的支持。
版本 v1.0.0
初始版本。
项目详情
下载文件
下载适合您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。