关于python自动注释函数的信息

Python教程：单行多行注释

工具/材料

python

01

在python中使用#号表示单行注释

02

使用""" """或''' '''做为多行注释

03

单行注释和多行注释不宜过多,不是每行代表都要注释,最好用来解释函数的操作

04

以下是一些错误使用注释的方式,一些能直接看到结果的代码最好不要多写注释

特别提示

关键代码,复杂代码使用注释

相关问答

Q1: Python-openpyxl教程11 - 注释和样式

注释具有text属性和author属性，必须同时设置它们。

加载时工作薄中存在的注释会自动存储在其相应单元格的注释属性中。格式信息(如字体大小，粗体和斜体)以及注释的容器框的原始尺寸和位置都将丢失。

保存工作薄时保留在工作薄中的注释会自动保存到工作薄文件中

注释尺寸可以指定为只写。评论尺寸以像素为单位。

如果需要, openpyxl.utils.units 包含用于从其他度量单位(例如mm或点)转换为像素的辅助函数:

样式用于屏幕上显示时更改数据的外观。他们还用于确定数字的格式。

样式可以应用于以下方面：

- 用于设置字体大小，颜色，下划线等的字体

- 填充以设置图案或颜色渐变

- border可以设置单元格的边框

- 单元格对齐

- 保护

以下是默认值：

有两种类型的样式：单元样式和命名样式，也成为样式模板

单元格样式在对象之间共享，并且一旦分配了它们就无法更改。这样可以避免不必要的副作用，例如，仅更改一个单元格时就可以更改许多单元格的样式。

样式也可以复制

字体，背景，边框等的颜色都可以通过三种方式设置：索引，aRGB或主题。 索引颜色是旧版实现，颜色本身取决于工作薄或应用程序默认提供的索引。主题颜色可用于互补色，但也取决于工作薄中存在的主题，因此，建议使用RGB颜色。

RGB颜色使用红色，绿色和蓝色的十六进制值设置

理论上，alpha值是指颜色的透明度，但这与单元格样式无关。默认值00将加在任何简单的RGB值之前:

还支持传统索引颜色以及主题和色彩。

索引64和65不能设置，并且分别留给系统前景色和背景色

样式直接应用于单元格

样式也可以应用于行和列，但是请注意，这仅适用于关闭文件后再Excel中创建的单元格。如果要将样式应用于整个行和列，则必须自己将样式应用于每个单元格。这是文件格式的限制：

合并的单元格的行为与其他单元格对象相似。其值和格式在其左上角的单元格中定义。为了更改整个合并单元格的边框。请更改其左上角单元格的边框。格式化是出于编写目的而生成的。

与单元格样式相反，命名样式是可变的。当您想一次将格式应用于许多不同的单元格时，它们很有意义。注意: 将命名样式分配给单元格之后，对样式的其他更改将不会影响该单元格。

一旦将命名样式注册到工作薄中，就可以简单的通过名称来引用它。

创建命名样式后，可以将其注册到工作薄中：

wb.add_name_style(highlight)

但是，命名样式在首次分配给单元时也将自动注册：

ws['A1'].style = highlight

注册后，仅使用名称分配样式：

ws['D5'].style = 'highlight'

该规范包括一些内置样式，也可以使用，不幸的是，这些样式的名称以本地化形式存储。

openpyxl仅会识别英文名称，并且只能与此处的文字完全一样。如下：

Number formats

Informative

Text Styles

Comparisons

Highlights

Q2: Python 程序有什么好的自动从注释生成文档的方法

用Sphinx

以win32系统为例python自动注释函数，最简单的安装方式是在Dos下输入如下代码

pip install -U sphinx

安装好了之后python自动注释函数，用最简单的半自动生成API文档的方式进行

例如：你的python安装在C:\python27， 想要给flask包自动制作文档，制作完成的文档放在C:\python_doc\flask的文件夹

代码如下：

sphinx-apidoc -F -o C:\python_doc\flask C:\python27\lib\site-packages\

（此处-o应紧跟输出文件夹，不然会产生一个-F的文件夹，多谢@Hyacz）

然后进入C:\python_doc\flask文件夹

cd C:\python_doc\flask

此文件夹下有一个make.bat文件，再执行一下

make html

然后就能在\_build\html文件夹中看到生成好的文档了，还支持查找的功能

python自动注释函数的介绍就聊到这里吧，感谢你花时间阅读本站内容，更多关于、python自动注释函数的信息别忘了在本站进行查找喔。