易于在django项目中安装、配置和使用语义ui框架的库
django-semantic-ui的Python项目详细描述
django语义用户界面
简单的python包,允许在django项目中安装、配置和使用语义ui框架。
要求
- NPM(最新稳定版本)
- python 2.7.x
- django 1.11.x
安装
- 安装gulp(cli),3.9.1版本可用于语义ui框架。
$ sudo npm install -g gulp@3.9.1
- 安装django语义ui包:
$ pip install django-semantic-ui
- 在settings.py: 中配置django语义用户界面
INSTALLED_APPS=[...,'django_semantic_ui',]
- 运行install命令
$ python manage.py semantic_ui install
注意:您需要定义安装语义ui模块所需的设置,请参见:Install Semantic
- 配置语义用户界面模块时,可以使用以下选项:
❯ Automatic (Use default locations and all components) ? We detected you are using NPM Nice! Is this your project folder? /home/franklinitiel/Documents/TSJ/projects/personal/python_tests/semanticui/static (Use arrow keys) ❯ Yes ? Where should we put Semantic UI inside your project? (semantic/) semantic
- 运行gulp build命令
$ python manage.py semantic_ui gulp_build
设置开发或本地环境
- 将“django.template.context_processors.static”添加到“模板”设置上的“context_processors”选项中
# settings.py# TEMPLATES settings'context_processors':[...,'django.template.context_processors.static',...,]
- 配置静态文件和文件夹,请参见:Managing static files
STATIC_URL='/static/'
- 将css和js添加到django项目中
{% load dsu %} <!DOCTYPE html><htmllang="en"><head><metacharset="UTF-8"><title>Semantic UI Test</title> {% dsu_stylesheet_url %} </head><body><!-- Your HTML code --> {% dsu_jquery_url %} {% dsu_javascript_url %} </body></html>
设置生产环境
- 配置静态文件和文件夹,请参见:Managing static files
STATIC_URL='/static/'STATIC_ROOT=os.path.join(BASE_DIR,'static')
- 并执行collectStatic命令
$ python manage.py collectstatic
附加设置
- gulp_version默认为none,如果要安装特定版本的gulp模块(本地),可以使用此设置,例如:
# settings.pyGULP_VERSION='3.9.1'
- 默认情况下,semantic_ui_version为none,如果要安装特定版本的semantic ui module(local),可以使用此设置,例如:
# settings.pySEMANTIC_UI_VERSION='^2.4.2'
- 语义目录名默认为“语义”,如果在安装语义ui框架时为js和css文件定义了自定义目录名(步骤4),则需要将其添加到此设置中。
# settings.pySEMANTIC_DIRNAME='semantic'
- dsu-jquery-url默认为https://code.jquery.com/jquery-3.1.1.min.js,如果您定义了jquery的自定义路径,那么可以使用此模板标记。
# settings.pyDSU_JQUERY_URL='...your jquery path...'
卸载django语义用户界面
- 您可以使用以下命令卸载语义ui框架和gulp(本地版本):
$ python manage.py semantic_ui uninstall && pip uninstall django-semantic-ui
发行说明:
- 1.0.0:初始版本和测试版(仅安装和设置)。
- 1.0.1:错误修复的文件夹不存在或不存在。
- 1.0.2:错误修复了未找到或不存在的静态文件夹和静态文件夹。
- 1.0.3:readme.md文件已更新,错误已修复self.semantic_ui_版本未定义。
- 1.1.0:逻辑更新为安装/卸载django语义用户界面,添加了新设置。
- 1.1.1:修复了与语义文件路径相关的错误。
- 1.1.2:readme.md已更新
- 1.2.0:添加了新的templateTags以加载javascripts和样式表文件
- 1.2.1:使用dsu jquery_url设置修复的错误。
- 1.2.2:readme.md已更新,添加了新的静态方法以从Django项目加载静态URL。
- 1.2.3:readme.md更新,修复了安装后执行命令“python manage.py runserver”的错误。