命令行工具

django-echarts 提供了一个包含若干个命令的 CLI 工具，这些命令都是标准的 Django 管理命令，均定义在 django_echarts.management.commands 包下。

本文档列出的帮助信息不包含继承自django命令的选项，你可以使用以下命令查看完整的帮助信息。

python manage.py <command> -h

静态文件 - 查看(info)和下载(download)

参见 本地化静态资源 一节。

startsite - 生成视图代码

帮助信息

创建 初始化site的代码片段。

E:\projects\django-echarts\example>python manage.py startsite -h
usage: manage.py startsite [-h] [--site-title SITE_TITLE] [--start-year START_YEAR] [--powered-by POWERED_BY]
                           [--override] output

Auto generate site_views.py file.

positional arguments:
  output                The output file.

optional arguments:
  -h, --help            show this help message and exit
  --site-title SITE_TITLE, -t SITE_TITLE
                        The title of site.
  --start-year START_YEAR, -y START_YEAR
                        The start year.
  --powered-by POWERED_BY, -p POWERED_BY
                        The principal of copyright.
  --empty, -e
  --override, -o

starttpl - 生成模板文件

使用方法

E:\projects\zinc> python .\manage.py starttpl -h
usage: manage.py starttpl [-h] [--theme {bootstrap3,bootstrap5,material}] [--output OUTPUT] [--force] tpl_name [tpl_name ...]

Copy the builtin template files to your project templates.


positional arguments:
  tpl_name              The name of template file.

optional arguments:
  -h, --help            show this help message and exit
  --theme {bootstrap3,bootstrap5,material}
                        The name of theme.
  --output OUTPUT, -o OUTPUT
                        The output filename
  --force, -f           Whether to copy if the file exists.

查看主题所有文件

查看当前主题的所有模板文件。

E:\projects\zinc> python .\manage.py starttpl
The template names of Theme [bootstrap3]:
        about.html
        base.html
        blank.html
        chart_collection.html
        chart_single.html
        home.html
        info_card.html
        items_grid.html
        items_list.html
        list.html
        list_with_paginator.html
        message.html
        widgets\values_panel.html

 Start to custom a template: python manage.py starttpl -n blank -o my_page

复制模板文件

使用 -n 复制一个文件，如果项目模板目录已经存在该文件，则需要添加 -o 覆盖，否则跳过复制。-n 的参数可以不添加后缀格式的 .html 。

复制内置的 message.html 文件

E:\projects\zinc> python .\manage.py starttpl message
Generate message.html, Success!

创建新的空白模板

E:\projects\zinc> python .\manage.py starttpl blank -o my_page
Generate my_page.html, Success!