From 97ec656e43f61412ad59657c7f70d96aa749b292 Mon Sep 17 00:00:00 2001 From: jaywcjlove Date: Tue, 1 Nov 2022 14:47:25 +0000 Subject: [PATCH] doc: update `djiango.md` (#16) a52d7d4b15e27743160331d1a57b60a011cd1735 --- docs/djiango.html | 210 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 206 insertions(+), 4 deletions(-) diff --git a/docs/djiango.html b/docs/djiango.html index 669906ae..593e7ca2 100644 --- a/docs/djiango.html +++ b/docs/djiango.html @@ -40,7 +40,7 @@

Django 是 Python 的一款 Web 框架，本备忘单旨在快速理解 Django 所涉及的主要概念，提供了最常用的 API 示例参考

入门

+

入门

准备环境

$ python --version
@@ -520,8 +520,8 @@
 <p>This is my webpage</p>
-

过滤器参考

- +

过滤器参考

+ @@ -771,7 +771,209 @@ -
KeywordDescription
add添加指定的值
addslashes在任何引号字符之前添加一个斜杠，以转义字符串
capfirst返回大写的第一个字母
center使值在指定宽度的中间居中
cut删除任何指定的字符或短语
date以指定格式返回日期
default如果值为 False，则返回指定值
default_if_none如果值为 None，则返回指定的值
dictsort按给定值对字典进行排序
dictsortreversed按给定值对字典进行反向排序
divisibleby如果该值可以除以指定的数字，则返回 True，否则返回 False
escape从字符串中转义 HTML 代码
escapejs从字符串中转义 JavaScript 代码
filesizeformat将数字返回为文件大小格式
first返回对象的第一项（对于字符串，返回第一个字符）
floatformat将浮点数四舍五入到指定的小数位数，默认为一位小数
force_escape从字符串中转义 HTML 代码
get_digit返回数字的特定数字
iriencode将 IRI 转换为 URL 友好字符串
join将列表中的项目返回为字符串
json_script将一个对象返回为由 <script></script> 标签包围的 JSON 对象
last返回对象的最后一项（对于字符串，返回最后一个字符）
length返回对象中的项目数，或字符串中的字符数
length_is如果长度与指定的数字相同，则返回 True
linebreaks返回带有 <br> 而不是换行符和 <p> 而不是多个换行符的文本
linebreaksbr返回带有 <br> 的文本，而不是换行符
linenumbers返回每行带有行号的文本
ljust根据指定的宽度左对齐值
lower以小写字母返回文本
make_list将值转换为列表对象
phone2numeric将带字母的电话号码转换为数字电话号码
pluralize如果指定的数值不是 1，则在值的末尾添加一个 s
pprint
random返回对象的随机项
rjust根据指定的宽度右对齐值
safe标记此文本是安全的，不应进行 HTML 转义
safeseq将对象的每个项目标记为安全且项目不应进行 HTML 转义
slice返回文本或对象的指定切片
slugify将文本转换为一个长字母数字小写单词
stringformat将值转换为指定格式
striptags从文本中删除 HTML 标记
time以指定格式返回时间
timesince返回两个日期时间之间的差
timeuntil返回两个日期时间之间的差
title文本中每个单词的第一个字符大写，所有其他字符都转换为小写
truncatechars将字符串缩短为指定数量的字符
truncatechars_html将字符串缩短为指定数量的字符，而不考虑任何 HTML 标记的长度
truncatewords将字符串缩短为指定数量的单词
truncatewords_html将字符串缩短为指定数量的单词，而不考虑任何 HTML 标记
unordered_list将对象的项目返回为无序列的 HTML 列表
upper以大写字母返回文本
urlencodeURL 对字符串进行编码
urlize将字符串中的任何 URL 作为 HTML 链接返回
urlizetrunc将字符串中的任何 URL 作为 HTML 链接返回，但会将链接缩短为指定的字符数
wordcount返回文本中的单词数
wordwrap以指定的字符数换行
yesno将布尔值转换为指定值
i18n
l10n
tz
+
Keyword描述
add添加指定的值
addslashes在任何引号字符之前添加一个斜杠，以转义字符串
capfirst返回大写的第一个字母
center使值在指定宽度的中间居中
cut删除任何指定的字符或短语
date以指定格式返回日期
default如果值为 False，则返回指定值
default_if_none如果值为 None，则返回指定的值
dictsort按给定值对字典进行排序
dictsortreversed按给定值对字典进行反向排序
divisibleby如果该值可以除以指定的数字，则返回 True，否则返回 False
escape从字符串中转义 HTML 代码
escapejs从字符串中转义 JavaScript 代码
filesizeformat将数字返回为文件大小格式
first返回对象的第一项（对于字符串，返回第一个字符）
floatformat将浮点数四舍五入到指定的小数位数，默认为一位小数
force_escape从字符串中转义 HTML 代码
get_digit返回数字的特定数字
iriencode将 IRI 转换为 URL 友好字符串
join将列表中的项目返回为字符串
json_script将一个对象返回为由 <script></script> 标签包围的 JSON 对象
last返回对象的最后一项（对于字符串，返回最后一个字符）
length返回对象中的项目数，或字符串中的字符数
length_is如果长度与指定的数字相同，则返回 True
linebreaks返回带有 <br> 而不是换行符和 <p> 而不是多个换行符的文本
linebreaksbr返回带有 <br> 的文本，而不是换行符
linenumbers返回每行带有行号的文本
ljust根据指定的宽度左对齐值
lower以小写字母返回文本
make_list将值转换为列表对象
phone2numeric将带字母的电话号码转换为数字电话号码
pluralize如果指定的数值不是 1，则在值的末尾添加一个 s
pprint
random返回对象的随机项
rjust根据指定的宽度右对齐值
safe标记此文本是安全的，不应进行 HTML 转义
safeseq将对象的每个项目标记为安全且项目不应进行 HTML 转义
slice返回文本或对象的指定切片
slugify将文本转换为一个长字母数字小写单词
stringformat将值转换为指定格式
striptags从文本中删除 HTML 标记
time以指定格式返回时间
timesince返回两个日期时间之间的差
timeuntil返回两个日期时间之间的差
title文本中每个单词的第一个字符大写，所有其他字符都转换为小写
truncatechars将字符串缩短为指定数量的字符
truncatechars_html将字符串缩短为指定数量的字符，而不考虑任何 HTML 标记的长度
truncatewords将字符串缩短为指定数量的单词
truncatewords_html将字符串缩短为指定数量的单词，而不考虑任何 HTML 标记
unordered_list将对象的项目返回为无序列的 HTML 列表
upper以大写字母返回文本
urlencodeURL 对字符串进行编码
urlize将字符串中的任何 URL 作为 HTML 链接返回
urlizetrunc将字符串中的任何 URL 作为 HTML 链接返回，但会将链接缩短为指定的字符数
wordcount返回文本中的单词数
wordwrap以指定的字符数换行
yesno将布尔值转换为指定值
i18n
l10n
tz
+

字段查询参考

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Keyword描述
contains包含短语
icontains与包含相同，但不区分大小写
date匹配日期
day匹配日期(日期，1-31)(日期)
endswith以。。结束
iendswith与 endwidth 相同，但不区分大小写
exact完全匹配
iexact与精确相同，但不区分大小写
in匹配其中一个值
isnull匹配 NULL 值
gt比...更棒
gte大于或等于
hour匹配一个小时(对于日期时间)
lt少于
lte小于或等于
minute匹配一分钟(对于日期时间)
month匹配一个月(日期)
quarter匹配一年中的一个季度 (1-4)(用于日期)
range之间的匹配
regex匹配正则表达式
iregex与正则表达式相同，但不区分大小写
second匹配一秒(对于日期时间)
startswith以 ... 开始
istartswith与 startswith 相同，但不区分大小写
time匹配时间(用于日期时间)
week匹配周数 (1-53)(用于日期)
week_day匹配一周中的某一天 (1-7) 1 是星期日
iso_week_day匹配 ISO 8601 星期几 (1-7) 1 是星期一
year匹配一年(日期)
iso_year匹配 ISO 8601 年份(日期)
+

添加静态文件

+

添加 CSS 文件

+
myworld
+  ├┈ manage.py
+  ├┈ myworld/
+  ╰┈ members/
+     ├┈ templates/
+     ├┈ static/
+        ╰┈ myfirst.css
+
+

打开 CSS 文件 (members/static/myfirst.css) 并插入以下内容：

+
body {
+  background-color: lightblue;
+  font-family: verdana;
+}
+
+

修改模板 (members/templates/template.html) 引入 css 文件

+
{% load static %}
+<!DOCTYPE html>
+<html>
+<link rel="stylesheet" href="{% static 'myfirst.css' %}">
+<body>
+
+ +

添加 JS 文件

+
myworld
+  ├┈ manage.py
+  ├┈ myworld/
+  ╰┈ members/
+     ├┈ templates/
+     ├┈ static/
+        ╰┈ myfirst.js
+
+

打开 JS 文件 (members/static/myfirst.js) 并插入以下内容：

+
function myFunction() {
+  alert("Hello from a static file!");
+}
+
+

修改模板 (members/templates/template.html) 引入 JS 文件

+
{% load static %}
+<!DOCTYPE html>
+<html>
+<script src="{% static 'myfirst.js' %}"></script>
+<body>
+<button onclick="myFunction()">Click me!</button>
+
+ +

添加图片文件

+
myworld
+  ├┈ manage.py
+  ├┈ myworld/
+  ╰┈ members/
+     ├┈ templates/
+     ├┈ static/
+        ╰┈ pineapple.jpg
+
+

打开 JS 文件 (members/static/pineapple.jpg) 并插入以下内容：

+
function myFunction() {
+  alert("Hello from a static file!");
+}
+
+

修改模板 (members/templates/template.html) 引入 jpg 文件

+
{% load static %}
+<!DOCTYPE html>
+<html>
+<body>
+<img src="{% static 'pineapple.jpg' %}">
+</body>
+</html>
+
+

另见