# django-echarts
   [](https://github.com/kinegratii/django-echarts/actions/workflows/unittest.yaml) [](https://codecov.io/gh/kinegratii/django-echarts)
> A visual site scaffold based on pyecharts and django.
django-echarts 是一个基于[pyecharts](https://github.com/pyecharts/pyecharts) 和 [Django](https://www.djangoproject.com) 整合的可视化网站脚手架。
## 概述(Summary)
django-echarts 主要提供了以下的内容：
- 支持 90%+的pyecharts图表类型
- 页面：主页 / 列表 / 详情 / 关于 / 设置
- 组件：导航栏 / 网站底部栏 / 热门板块 / 列表 / 合辑 / 关于面板
- UI主题：Bootstrap3 / Bootstrap5 / Material ，支持更换颜色模式
- 可灵活扩展: 支持整合 Django用户认证 / 数据库 / Session
- 基于Django Template Engine 的后端渲染
- js/css静态文件托管，支持在线/本地切换
- 生产力工具：代码生成器 / 静态文件下载器
- 90%+ Python Typing Hints覆盖
- 单元测试和85%+代码覆盖率
## 安装(Install)
django-echarts的运行环境要求如下：
| django-echarts版本系列 | pyecharts & echarts | django | python |
| ------ | ------ | ----- | ----- |
| 0.6.x | 1.9 / 4.8.0 | 2.0 - 4.1 | 3.7+ |
| | 2.0 / 5.4.1 | 2.0 - 4.1 | 3.7+ |
| 0.5.x | 1.9 | 2.0 - 4.0 | 3.7+ |
可以使用 pip 命令安装。
```shell
pip install django-echarts
```
在 *requirements.txt* 引用 django-charts时，推荐使用 **固定次版本号** 的方式。
```
django-echarts~=0.6
```
## 3分钟上手(Quickstart in 3 Minutes)
**1.** 创建Django项目。
```shell
django-admin startproject MyDemo
```
项目目录结构如下：
```text
MyDemo
|-- MyDemo
|-- __init__.py
|-- asgi.py
|-- settings.py
|-- urls.py
|-- site_views.py
|-- wsgi.py
|-- manage.py
```
**2.** 添加 django_echarts包和对应的主题包到项目配置模块的 `INSTALL_APPS`列表。
```python
INSTALL_APPS = (
# Your apps
'django_echarts',
'django_echarts.contrib.bootstrap5'
# Your apps
)
```
**3.** 创建新文件 *site_views.py* ，输入下列代码。
```python
# ...
from django_echarts.starter.sites import DJESite
from django_echarts.entities import Copyright
from pyecharts import options as opts
from pyecharts.charts import Bar
site_obj = DJESite(site_title='福建统计')
site_obj.add_widgets(copyright_=Copyright(start_year=2022, powered_by='Zinc'))
chart_description = '截止2020年底，福建省土地面积1240.29万公顷，占我国国土总面积1.3%。全省森林面积811.58万公顷，森林覆盖率为66.8%，连续42年位居全国首位。
@site_obj.register_chart(title='森林覆盖率', description = chart_description, catalog='基本信息')
def fujian_forest_coverage():
bar = Bar().add_xaxis(
['福州', '厦门', '莆田', '三明', '漳州', '泉州', '南平', '龙岩', '宁德']
).add_yaxis(
'森林覆盖率', [54.7, 45, 58.1, 76.8, 63.4, 61, 75.3, 78, 75]
).set_global_opts(
title_opts=opts.TitleOpts(title="福建省各地市森林覆盖率", subtitle="单位：%"),
visualmap_opts=opts.VisualMapOpts(is_show=True, max_=100, min_=0)).set_series_opts(
markline_opts=opts.MarkLineOpts(
data=[
opts.MarkLineItem(y=66.8, name="全省"),
]
)
)
return bar
```
在函数`fujian_forest_coverage` 中编写pycharts代码，返回对应的图表对象。
根据需要修改文字显示，添加组件等。
**4.** 在项目的路由模块 *urls.py* 添加挂载点。
```python
from django.conf.urls import url, include
from django.urls import path
from .site_views import site_obj
urlpatterns = [
# Your urls
path('', include(site_obj.urls))
]
```
**5.** 启动开发服务器，打开浏览器预览结果。
```text
python manage.py runserver 0.0.0.0:8900
```
运行效果（下图已添加其他组件）
## 文档(Document)
[在线文档](https://django-echarts.readthedocs.io/)
Build on [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/)
## 示例项目(Demo Project)
在线示例 [https://zinc.pythonanywhere.com](https://zinc.pythonanywhere.com)
参见项目 [kinegratii/zinc](https://github.com/kinegratii/zinc) 。
## 截图(Screen Shots)
**Home with ValuesPanel (bootstrap5)**
**Chart Detail Page (bootstrap3.paper)**
## 开源协议(License)
MIT License
基于pyecharts和django的可视化网站脚手架。.zip （199个子文件） 
setup.cfg 119B .coveragerc 802B .gitignore 1KB
base.html 5KB base.html 5KB base.html 3KB list_with_paginator.html 2KB list_with_paginator.html 2KB list_with_paginator.html 2KB home.html 1KB home.html 1KB chart_single.html 1KB chart_single.html 1KB chart_single.html 1KB detail_frontend.html 1KB items_grid.html 912B items_grid.html 890B items_list.html 879B items_grid.html 856B settings.html 758B list.html 635B list.html 611B list.html 561B home.html 504B value_item.html 466B value_item.html 454B page.html 414B page.html 414B page.html 414B items_list.html 400B items_list.html 382B settings.html 366B settings.html 360B message.html 341B message.html 324B about.html 306B message.html 297B jumbotron.html 279B value_item.html 264B chart_collection.html 263B chart_collection.html 263B chart_collection.html 263B row_container.html 243B row_container.html 243B jumbotron.html 236B row_container.html 235B container.html 227B container.html 227B container.html 227B items_simple_list.html 205B title.html 203B title.html 182B blank.html 179B blank.html 179B blank.html 179B link_group.html 177B title.html 172B chart_info.html 162B link_group.html 154B link_group.html 154B jumbotron.html 145B chart_parametric.html 144B chart_parametric.html 144B chart_parametric.html 144B chart_info.html 135B about.html 113B about.html 91B chart_info.html 49B MANIFEST.in 225B LICENSE 1KB widget_and_layout.md 15KB views_and_templates.md 11KB base.md 9KB custom_maps.md 7KB themes.md 6KB localize_staticfiles.md 5KB v060.md 5KB dms.md 5KB configure.md 5KB entity_params.md 5KB site_configuration.md 5KB README.md 5KB widget_collection.md 5KB index.md 4KB pyecharts_project.md 4KB tags.md 4KB use_custom_geojson.md 3KB commands.md 3KB changelog.md 3KB about.md 2KB system_design.md 2KB v050.md 2KB third_html_library.md 2KB v051.md 2KB advance_development.md 2KB stores.md 1KB long_description.md 1KB new_page_feature.md 1KB gallery.md 467B breaking-change.md 310B共 199 条
- 1
- 2
资源评论
嵌入式大圣
- 粉丝: 2608
- 资源: 715
最新资源
- 多种编程语言下的算法实现资源及其应用场景
- BGM坏了吗111111
- 高等工程数学试题详解：矩阵分析与最优化方法
- 这是一个以20位中国著名书法家的风格编写的汉字作品的数据集 每个子集中有1000-7000张jpg图像（平均5251张图像）
- 【Academic tailor】学术小裁缝必备知识点：全局注意力机制（GAM）pytorch
- 数据科学领域的主流数据集类型及其应用分析
- 【Academic tailor】学术小裁缝必备知识点：全局注意力机制（GAM）TensorFlow
- Apple MacBook Pro和macOS Monterey用户的全方位使用指南
- 知识付费系统-直播+讲师入驻+课程售卖+商城系统-v2.1.9版本搭建以及资源分享下载
- Python爬虫技术深度解析与实战应用指南
资源上传下载、课程学习等过程中有任何疑问或建议，欢迎提出宝贵意见哦~我们会及时处理！
点击此处反馈
