-
上次了解了注释
-
注释是为了让程序更可读
-
注释不会影响程序运行速度
-
注释分为两种
-
单行的
-
以#开头
-
不能是字符串当中的#
-
准备插入下面三项的注释
-
date 编写日期
-
description 描述信息
-
author 作者
-
:r !date
-
date
-
是外部shell中可以执行的命令
-
可以得到当前日期时间
-
!date
-
可以在shell中执行外部命令date
-
r !date
-
将外部命令date输出的结果
-
输出到当前文件缓存中
-
可以在命令行中
-
查看到 main.py 的帮助手册吗?
-
这很眼熟啊
-
可以到游乐场里面
-
首先 import main
-
然后 help(main)
-
在当前路径,进入游乐场之后
-
import main
-
help(main)
-
python3 -m pydoc -w main
-
对于 main.py 生成
-
帮助网页 main.html
-
注意{BANNED}最佳后一句
-
wrote main.html
-
写下了一个新文件
-
这个文件main.html
-
就是main.py的帮助文件
-
就生成在当前的 test 文件夹
-
然后用火狐打开这个网页文件
-
firefox main.html
-
右上角是两个链接
-
当前文件夹索引
-
当前 html 对应的 py 文件
-
再下面是三个链接
-
是 main.py 引入的三个 module
-
目前这三个模块的链接都无法打开
-
因为都还没有生成
-
红框中
-
只提到了 apple
-
没有提到banana
-
只有{BANNED}最佳开头的三引号注释
-
才被写入模块帮助
-
让源代码更容易阅读和理解
-
尽量减少维护或扩展遗留系统所需的工作量
-
减少系统的用户和开发人员查阅二级文档来源的需要
-
通过自成一体的知识表征促进自动化
-
这次了解了 帮助文档的 生成
-
开头的三引号注释 可以生成 帮助文档
-
文档 可以写成网页
-
下次再说!????
-
蓝桥->
-
github->
-
gitee->
阅读(192) | 评论(0) | 转发(0) |