如何写第一个属于自己的Web页面（Django）

Posted 2023-05-03

参考技术A         上期（超实用搭建个人开发Web网页的软件及配置基础）已经详细的介绍了基于Django+mysql+PyCharm组合配置的Web开发的基础架构。这期带读者跟着作者写第一个属于自己的Web页面，同时跟作者同一个局域网的其它用户也可以访问。

首先输入python manage.py startapp myFamilyWeb (表示创建一个自己的Web页面项目)，如图1。

生成的myFamilyWeb里的目录结构里的含义如下：

外层的_init_.py文件标识myFamilyWeb是一个Python包。

admin.py 用于将Model定义注册到管理后台，是Django Admin 应用的配置文件。

apps.py用于应用程序本身的配置。

migrations目录用于存储models.py文件中Model的定义及修改。

migrations/_init_.py文件标识migrations是一个Python包。

models.py用于定义应用中所需要的数据表。

tests.py文件用于编写当前应用程序的单元测试。

views.py文件用于编写应用程序的视图。

以上的介绍都是myFamilyWeb应用的全部内容，后续需要做的就是填充对应的service逻辑对外提供服务。如果就这么启动，就会发现如图2一样访问不了。

想要实现访问自己第一个Web页面（myFamilyWeb），第一步是设置路由和在views.py增加一个可以访问的函数（图3-图6）。

配置模板和html（图7-图13）

配置写好了第一个最简单的Web页面，启动服务器。。。（图14）

在开发者电脑上的浏览器访问http://127.0.0.1:8000/myFamilyWeb/ （图15）

https://jingyan.baidu.com/article/c843ea0b7d5c7177931e4ab1.html（配置防火墙端口）（图16）

设置允许多个主机访问 （图17）

在终端输入ipconfig

回车找到IPv4 的地址：192.168.0.102 （图18）

python manage.py runserver 0.0.0.0:8000 （这次启动的时候在后面添加0.0.0.0:8000）。

然后本地网络中的其它计算机就可以在浏览器中访问你的 IP 地址了，http://192.168.0.102:8000/myFamilyWeb/ （这个网址只能同一个局域网的主机可以访问）

之后就是好好去学习如何写html文件了。。。

Django rest framework + drf-yasg 关于 api 文档 web 页面数据修改方法

参考技术A operation_summary ：操作名称如下图

operation_description ：接口介绍 如下图

operation_id ：操作方法名如下图

manual_parameters : 修改 Parameters 中参数说明

request_body ：post 发送内容 如下图

responses ：响应内容 如下图

enum : 定义改字段可选的参数值，默认写第一个。如下图

description : 字段描述
type : 字段需要什么类型的数据
             TYPE_OBJECT = "object"
             TYPE_STRING = "string"
             TYPE_NUMBER = "number"
             TYPE_INTEGER = "integer"
             TYPE_BOOLEAN = "boolean"
             TYPE_ARRAY = "array"
             TYPE_FILE = "file"

format : 进行验证的方式
             FORMAT_DATE = "date"
             FORMAT_DATETIME = "date-time"
             FORMAT_PASSWORD = "password"
             FORMAT_BINARY = "binary"
             FORMAT_BASE64 = "bytes"
             FORMAT_FLOAT = "float"
             FORMAT_DOUBLE = "double"
             FORMAT_INT32 = "int32"
             FORMAT_INT64 = "int64"
             FORMAT_EMAIL = "email"
             FORMAT_IPV4 = "ipv4"
             FORMAT_IPV6 = "ipv6"
             FORMAT_URI = "uri"
             FORMAT_UUID = "uuid"
             FORMAT_SLUG = "slug"
             FORMAT_DECIMAL = "decimal"