帮助构建表单的额外小部件以及模板中渲染表单的特殊方法
项目描述
此应用程序是一组实用工具,它将使使用django和bootstrap 5开发应用程序变得更加容易,因为它提供了一组JavaScript库,例如select2、icheck、datatables等,作为小部件或实用工具更完美地集成,从而简化应用程序创建。
此应用程序有助于您将Django应用程序与Gentelella集成,构建表单的额外小部件以及模板中渲染表单的特殊方法。
文档
查看文档
安装
从PyPI安装
pip install djgentelella
配置您的设置
INSTALLED_APPS = [ ..
'djgentelella',
'rest_framework',
'markitup',
]
MARKITUP_FILTER = ('markdown.markdown', {'safe_mode': True})
MARKITUP_SET = 'markitup/sets/markdown/'
JQUERY_URL = None
运行迁移
python manage.py migrate
从互联网下载创建静态文件(您需要为此步骤安装requests)。
pip install requests
python manage.py loaddevstatic
在您的项目urls.py文件中添加djgentelella URL
from djgentelella.urls import urlpatterns as djgentelellaurls
urlpatterns = djgentelellaurls + [
...
]
用法
在表单中
from djgentelella.forms.forms import GTForm
from djgentelella.widgets import core as genwidgets
class myform(GTForm, forms.ModelForm):
class Meta:
model = MyObject
fields = '__all__'
widgets = {
'name': genwidgets.TextInput,
'borddate': genwidgets.DateInput,
'email': genwidgets.EmailMaskInput
}
在处理表单的模板中
{{ form.as_plain }}
{{ form.as_inline }}
{{ form.as_horizontal }}
使用基本模板的模板中
{% extends 'gentelella/base.html' %}
查看此文件以了解可以覆盖的模板块
测试
要运行所有测试,请使用
cd demo
python manage.py test
要运行响应式测试,请使用
cd demo
python manage.py test demoapp.tests.selenium.responsive
运行演示
cd demo
python manage.py migrate
python manage.py createdemo
python manage.py demomenu
更多请参阅演示应用。
开发说明
base.js是自动生成的,因此您需要调用
python manage.py createbasejs
记得在服务器上部署之前更新包版本。
sudo apt install node-babel-cli npm webpack
翻译
要为单词添加新翻译,有两种选择
django-admin makemessages --all
此命令将django模板内的单词添加到locale/es/LC_MESSAGES/django.po,在这些地方可以翻译这些单词。
要添加单词,可以使用以下语法。
{% trans "new_word" %}
对于JavaScript文件中使用的单词,必须执行以下命令。
django-admin makemessages -d djangojs -l es --ignore *.min.js
此命令将gettext js函数内的单词添加到locale/es/LC_MESSAGES/djangojs.po,在这些地方可以翻译这些单词。
以下是一个gettext实现的示例
alert(gettext("new_word"))
项目详情
下载文件
下载适用于您的平台文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源分布
djgentelella-0.3.21.tar.gz (10.4 MB 查看哈希值)
构建分布
djgentelella-0.3.21-py3-none-any.whl (10.7 MB 查看哈希值)