1.要生成类似于erlang的文档 , 模块的代码注释必须按照erlang的规则走。Erlang edoc
2.edoc不支持中文 , edoc_layout.erl 源码是charset=ISO-8859-1字符集 , 如果团队英文水平较高,可以无视这个...
去erlang源码查找edoc_layout.erl文件,然后复制一份 , 需要修改的如下代码。然后编译,我把编译好的文件,放在edoc的源码ebin下。
-module(edoc_layout_utf8).
%% xhtml/3修改如下,其他代码完全照搬edoc_layout.erl即可
-define(UTF8_META,{meta,[{'http-equiv',"Content-Type"},{content,"text/html; charset=UTF-8"}],[]}).
xhtml(Title, CSS, Body) ->
[{html, [?NL,
{head, [?NL,
?UTF8_META,
?NL,
{title, Title},
?NL] ++ CSS},
?NL,
{body, [{bgcolor, "white"}], Body},
?NL]
},
?NL].
生成文档的时候,只需要调用
Files = 你的文件!是列表 ,dir是目录,详细的参数配置去查看erlang的帮助文档
edoc:files(Files, [{dir,"doc"},{new,true},{layout,edoc_layout_utf8}]).
感谢:http://www.cnblogs.com/neutra/archive/2012/02/14/2350283.html