Django集成Aloha HTML5编辑器
apidev-djaloha的Python项目详细描述
贾罗哈
djaloha(django+aloha)是在django站点中使用Aloha Editor的后端。 它允许对html内容进行内联编辑。 它包括一个django表单和一个小部件助手。 Djaloha正在使用aloha.0.23.26
快速启动
在settings.py中,将“djaloha”添加到已安装的应用程序中 在urls.py中,将(r'^djaloha/',include('djaloha.urls'))添加到urlpatterns中
然后创建一个表单。例如
import floppyforms from models import Note from djaloha.widgets import AlohaInput class NoteForm(floppyforms.ModelForm): class Meta: model = Note fields = ('text',) widgets = { 'text': AlohaInput(), }
假设有一个指向noteform实例的form变量。 在模板文件中,调用表单,不要忘记将{{form.media}}放在头文件中。
选项
Djaloha有一个“provider”,允许您通过自动完成字段轻松地向模型(文章、联系人等)添加本地链接,该字段将根据为每个模型定义的规则搜索对象:
- 使用get_absolute_url()搜索此类模型
- 使用其他方法搜索此类模型
- 使用指定的模型字段搜索此类模型
您可以在settings.py中设置DJALOHA_LINK_MODELS设置,以告知“添加链接”小部件的“自动完成”字段中将提供哪些django型号,如下所示
DJALOHA_LINK_MODELS = ('coop_local.Article','calendar.Event')
Djaloha需要jquery,默认情况下与jquery.1.7.2一起提供。如果需要,可以更改jquery版本
DJALOHA_JQUERY = 'js/jquery.1.7.2.js'
aloha有一个很好的插件架构。默认情况下,djaloha包含主要的aloha插件。您可能需要一组不同的插件。 有关插件的详细信息,请参阅aloha文档
DJALOHA_PLUGINS = ( "common/format", "common/highlighteditables", "common/list", "common/link", "common/undo", "common/paste", "common/commands", "common/image", "common/align", "extra/attributes", "common/characterpicker", "common/abbr", "common/horizontalruler", "common/table", "extra/browser", )
请注意,DJALOHA_PLUGINS设置是全局设置。如果需要更改特定表单字段的插件集,则 可以在AlohaInput小部件的aloha_plugins属性中传递类似的元组。 extra_aloha_plugins属性将向默认集添加其他插件。
DJALOHA_INIT_URL设置使得可以覆盖djaloha的aloha init文件。^ AlohaInput的{tt10}$属性也可用于为特定表单字段重载它。
许可证
apidev djaloha是credis/djaloha的叉子(参见http://github.com/credis/djaloha)
Djaloha使用BSD许可证。请参见license.txt
Djaloha开发项目由CREDIS、FSE(欧洲社会基金)和Conseil Regional D'Auvergne提供资金。