docor 自动从package.json生成排版好看的readme

2013-09-07 15:54:13 +08:00
 turing
很多人懒得写readme,虽然markdown写起来已经够简单了,但是还是写不出好看的readme,因为觉得写文档是一件很麻烦的事情,我经常在npm上开坑,发现readme很多东西都可以从package.json中抓出来然后排版好,docor这个工具就做了这样一个工作。

$ sudo npm install docor -g

然后在你的目录下npm init之后,会有一个package.json文件,这个时候在本目录执行 docor 就可以看到生成的readme,根据pkg指定的license文件,和相应的ignore文件了。

我还写了一些小功能,比如从pkg.main文件里将暴露出来的函数打印在readme中,方便以后写api文档。如果要指定文档的logo,可以在package.json中加一个 { "logo": "someurl" }

目前有两个readme模板,如果希望要自己修改这个默认模板,可以在你的全局模块目录里修改 tpl/readme.md

如果要新建中文语言的readme,可以这样: $ docor -c README.zh-cn.md,中文模板文件也在tpl目录下。

Github:
https://github.com/turingou/docor
3041 次点击
所在节点    Node.js
2 条回复
turing
2013-09-07 15:57:36 +08:00
对了,docor的readme也是docor生成的。欢迎贡献代码或者补全license文件夹下的lincense文件,目前只有MIT,BSD和一个apache协议文件
turing
2013-09-07 16:10:28 +08:00

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/81662

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX