跳转到主要内容

django-ace为Ace提供了与Django的集成。

项目描述

Build Coverage PyPI Download PyPI Python Versions PyPI License

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
    ))

安装

  1. 使用pip安装

pip install django_ace
  1. 更新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://:8000https://: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

  • 新增小部件选项 minLinesmaxLinesshowinvisiblesusesofttabs

  • 升级 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

  • 初始版本。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源代码分布

fdemmer-django-ace-2.2.1.tar.gz (2.3 MB 查看散列)

上传时间 源代码

构建版本

fdemmer_django_ace-2.2.1-py3-none-any.whl (2.7 MB 查看散列)

上传时间 Python 3

支持者

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