如何通过python代码自动生成文档

Python010

如何通过python代码自动生成文档,第1张

代码如下:

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编写。python在生物信息、统计、网页制作、计算等多个领域都体现出了强大的功能。python和其他脚本语言如java、R、Perl 一样,都可以直接在命令行里运行脚本程序。工具/原料

python;CMD命令行;windows操作系统

方法/步骤

1、首先下载安装python,建议安装2.7版本以上,3.0版本以下,由于3.0版本以上不向下兼容,体验较差。

2、打开文本编辑器,推荐editplus,notepad等,将文件保存成 .py格式,editplus和notepad支持识别python语法。

脚本第一行一定要写上 #!usr/bin/python

表示该脚本文件是可执行python脚本

如果python目录不在usr/bin目录下,则替换成当前python执行程序的目录。

3、编写完脚本之后注意调试、可以直接用editplus调试。调试方法可自行百度。脚本写完之后,打开CMD命令行,前提是python 已经被加入到环境变量中,如果没有加入到环境变量,请百度

4、在CMD命令行中,输入 “python” + “空格”,即 ”python “;将已经写好的脚本文件拖拽到当前光标位置,然后敲回车运行即可。

你所说的编辑器是Python自带的IDLE编辑器吧。。。

Python自带的那个开头是“>>>”的IDLE是交互式编译器,只能单步运行。

因为你的代码有很多步骤,所以IDEL不识别,所以没反应。。。

想运行这个文件,先保存成.py文件,然后使用右键中的IDLE运行。具体步骤如下:

1.

打开一个txt,然后粘贴你的内容

2.

粘贴完毕后,单击保存,保存时,注意保存类型一定是“所有文件”,且后缀一定为.py,例如:test.py

3.

在test.py上单击右键,选择“使用IDLE编辑”(我的是英文系统,英文系统的选项是:

Edit

with

IDLE)

4.

然后会打开的两个编辑器,都很像单步运行的IDLE,只是没有了“>>>”,然后在有代码的编辑器上按下F5,或者选择Run

->

Run

Module.

5.

运行的结果会显示在另一个空白的IDLE上。。。