谁还有啊共享啊!
回复 (18)
怎么没人回复下啊 中文node api 没用了吗
又有人吐槽这个了...哎....
...我是不是弱爆了!
@haizeiwanghuoying 没有..问这个很正常..只是大神们貌似都不鸟这事..
@youxiachai 那个中文API文档已经很老了,得有人翻译新的才行呐
@leizongmin 一个问题是翻译哪个版本? 还有更新以后怎么办?
@jiyinyiyong 如果要翻译肯定得 >= v0.10 的
@leizongmin 要不拿这个翻译... http://nodejs.org/docs/latest/api/all.json
@jiyinyiyong 有空做一个工具:自动读取出这个文件的数据,可以让多个人参与进来翻译不同的条目。 翻译应该精确到每一段,让按照原来这种方式存储,以后有更新时,扫描出有更改的部分,再翻译一下即可。
@jiyinyiyong 我觉得还是保留 all.json 这种格式比较好
@leizongmin 的确写 JSON 的人多一些, 比 YAML 不容易写错. 现在的计划里是有个 Web 界面送来显示的, 相对翻译工作量比较小
扫描更该部分是通过 JSON 的 Diff 来实现的, 我觉得问题不大,
期望 Node 文档改动不要大到 git diff 受不了的程度
多个人参与的话,, 让发 Issue 吧,, 这个做 Web 界面略麻烦的样子. 要做 jsoneditor + pen 整个, 就算限制死 JSON 的格式, 工作量也不小
http://www.jsoneditoronline.org/ http://sofish.github.io/pen/
@jiyinyiyong 我刚才研究了一下,可以直接修改node源码中的 doc/api 下的markdown文件,再用node自带的工具可以生成json文件或者html页面。
@leizongmin 他的目录做了 index index.html 之类设置, 你是怎么抓到里边文件的?
@jiyinyiyong Node源码的 doc/api 目录
@leizongmin 那边的文档, 为了和代码的对应, 估计不会拆单独的模块 但是拆出来的话, 居然能 Markdown 直接生成 JSON 吗, 怎么弄的?
@jiyinyiyong 源码里面有个工具:tools/doc ,具体生成方法你看 Makefile 文件