Hollo limodou:

  epydoc ??
一句话，
python E:\LAMPS\CJKPython23\Scripts\epydoc.py -o doc/api --private .

这是我在 UltraEdit 中设定的一个定制工具命令;
意思就是将当前目录中的模块进行文档摄取，输出到 doc\api 目录中，

你完全可以在代码编写过程中随时进行epydoc 提取，看一看自个儿的类说明什么的，是否在组织化的文档中合适，
在说明文本中 epydoc 支持非常轻量级别的结构化文本具体语法:
http://epydoc.sourceforge.net/epytext.html

如果有 wiki,reST 等等结构化文本的经历，会非常快速的上手的


/******** [2004-08-25]19:20:25 ; limodou wrote:

limodou> Zoom.Quiet,您好！

limodou> 	对了，把
limodou> epydoc给简单地讲一讲，文档生成得不错，现在很流行这种框架结构的文档。象wxWindows有一种新的文档结构就是这种框架结构的。

limodou>    
limodou> 不过模板系统虽然方便但也不能完全代替编程，因此可能另一种解决方法是在数据中提供编程接口，也就是在进行某些模板替换时，可以调用客户代码进行处理。

limodou> ======= 2004-08-25 18:26:10 您在来信中写道：=======

>>Hollo limodou:
>>
>>  嗯嗯！数据驱动！也是在下直觉的第一反应
>>对应代码
>>   def fixlineblock(self,model,cntli):
>>        """行模式标签处理
>>            - model
>> 输出模式("标准字串格式化模式直接使用%s来设置替换位置"
>>                ,"前导字符，除头行外其它都要加缀的字符")
>>            - cntli 内容列表，一组字串的列表
>>        """
>>        exp = ""
>>        i=0
>>        for node in cntli:
>>            if 0==i:
>>                exp="%s%s"%(exp,(model[0]%node))
>>            else:
>>                exp="%s%s%s"%(exp,model[1],(model[0]%node))
>>            i+=1
>>        return exp
>>
>>但是，作为Py代码的解析输出，有个缩进的问题，一直没有敢处理，直接使用模板的原始标签位置，小新是采用专门的函式进行再次处理……………………
>>
>>只是如此一来，三层以上的嵌套以及嵌套  中再含有编辑判定！！！
>>就太复杂了！
>>使用递归的话，代码太难读，不利于维护………………也是种烦恼！
>>
>>
>>/******** [2004-08-25]18:22:26 ; limodou wrote:
>>
>>limodou> hoxide,您好！
>>
>>limodou>
>>	我设计的模板系统在示例中已经支持交叉引用和循环，不过没有经过很细致的测试。对于循环我与ZoomQuiet的想法是一致的，由数据来驱动的。因此你不用写什么
>>limodou> for，只要给我的是一个列表我就循环，不是列表就是替换一次。
>>
>>limodou>    
>>limodou>
>>但meteor绝对不是psp，因为它可以做代码的解析，而meteor只进行替换，因此功能简单简单得多，不能与psp相比。
>>
>>limodou> ======= 2004-08-25 17:23:57 您在来信中写道：=======
>>
>>>>limodou,您好！
>>>>
>>>>	谢谢. 看来limodou的模板系统, 我在一次感到他真的就像psp的翻版.
>>>>不知道这个系统实现了没有, 没实现的话可以参考一下psp的实现.
>>>>当然和也有一些不同, 特别是交叉应用方面, 不过这不是个本质上的问题,
>>>>交叉应用可以在key的解析时一下子解决.
>>>>    psp最大的好处是可以处理循环.比如:
>>>>
>>>><%for i in range(10):
>>>>     #这个空格是必须的
>>>>%>
>>>>number: <%=i%>
>>>><%#这个也是%>
>>>>
>>>>可以产生:
>>>>number: 0
>>>>number: 1
>>>>number: 2
>>>>number: 3
>>>>number: 4
>>>>number: 5
>>>>number: 6
>>>>number: 7
>>>>number: 8
>>>>number: 9
>>>>
>>>>当然我只是例子, 具体实现还有很多可以改进的地方.
>>>>
>>>>======= 2004-08-25 17:13:34 您在来信中写道：=======
>>>>
>>>>>hoxide,您好！
>>>>>
>>>>>	总结不错，希望能看到你在社区里大显身手。
>>>>>
>>>>>======= 2004-08-25 16:32:40 您在来信中写道：=======
>>>>>
>>>>>>这也是我的社会实践报告~~~ 				
>>>>>>
>>>>>>　　　　　　　　hoxide
>>>>>>　　　　　　　　hoxide_dirac at yahoo.com.cn
>>>>>>　　　　　　　　　　2004-08-25
>>>>>>_______________________________________________
>>>>>>python-chinese list
>>>>>>python-chinese at lists.python.cn
>>>>>>http://python.cn/mailman/listinfo/python-chinese
>>>>>>
>>>>>
>>>>>= = = = = = = = = = = = = = = = = = = =
>>>>>			
>>>>>
>>>>>　　　　　　　　致
>>>>>礼！
>>>>> 
>>>>>				 
>>>>>　　　　　　　　limodou
>>>>>　　　　　　　　chatme at 263.net
>>>>>　　　　　　　　　　2004-08-25
>>>>>
>>>>>_______________________________________________
>>>>>python-chinese list
>>>>>python-chinese at lists.python.cn
>>>>>http://python.cn/mailman/listinfo/python-chinese
>>>>>
>>>>
>>>>= = = = = = = = = = = = = = = = = = = =
>>>>			
>>>>
>>>>　　　　　　　　致
>>>>礼！
>>>> 
>>>>				 
>>>>　　　　　　　　hoxide
>>>>　　　　　　　　hoxide_dirac at yahoo.com.cn
>>>>　　　　　　　　　　2004-08-25
>>>>
>>>>_______________________________________________
>>>>python-chinese list
>>>>python-chinese at lists.python.cn
>>>>http://python.cn/mailman/listinfo/python-chinese
>>>>
>>
>>limodou> = = = = = = = = = = = = = = = = = = = =
>>			
>>
>>limodou> 　　　　　　　　致
>>limodou> 礼！
>> 
>>				 
>>limodou> 　　　　　　　　limodou
>>limodou> 　　　　　　　　chatme at 263.net
>>limodou> 　　　　　　　　　　2004-08-25
>>
>>
>>
>>********************************************/
>>
>>-- 
>>Free as in Freedom
>>
>> Zoom.Quiet                           
>>
>>#=========================================#
>>]Time is unimportant, only life important![
>>#=========================================#
>>
>>sender is the Bat!2.12.00
>>
>>_______________________________________________
>>python-chinese list
>>python-chinese at lists.python.cn
>>http://python.cn/mailman/listinfo/python-chinese
>>

limodou> = = = = = = = = = = = = = = = = = = = =
			

limodou> 　　　　　　　　致
limodou> 礼！
 
				 
limodou> 　　　　　　　　limodou
limodou> 　　　　　　　　chatme at 263.net
limodou> 　　　　　　　　　　2004-08-25



********************************************/

-- 
Free as in Freedom

 Zoom.Quiet                           

#=========================================#
]Time is unimportant, only life important![
#=========================================#

sender is the Bat!2.12.00