请问写好python模块以后,文档怎么写?
黄舟
黄舟 2017-05-24 11:35:07
0
3
633

我是一个新手,以前从来没有发布过python程序。
最近老师让我写了两个python小模块,一个是将pdf转为txt,另一个是计算转好的txt文档的相似度。我写好了并且也知道如何打包成第三方库,但是不知道配套的文档应该怎么写?
我在网上也查了一下,有的人说'''注释里的内容就是文档(这个注释我都认真写了),但是不知道是不是还要在包里放一个txt文件,写一写不同模块不同函数的用法,还是怎么样?
谢谢各位了,我真的是不知道这个文档咋搞...

黄舟
黄舟

人生最曼妙的风景,竟是内心的淡定与从容!

全部回复(3)
Ty80

狮身人面像

仅有的幸福

我猜你也用过git,类似于git project中的readme 文件,看两个开源项目是怎么写的,写readme的目的,大概就是帮助别人知道这个项目是什么,能干什么,如何使用,注意要点,差不多就酱

漂亮男人

例子:

模块.py

'''
这是模块文档
'''
pass
>>> import 模块
>>> help(模块)
Help on module 模块:

NAME
    模块 - 这是模块文档

FILE
    d:\python34\模块.py


>>> 
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板