gitbook-summary 标题

当前解析的标题名字，都是文件名吧，可不可以解析一下文件，取第一行，作为标题呢？

Feb 02 '16 10:02 lonelyclick

技术上是可以的，不过这样会强迫用户写入标题。如果用户不写，或者直接大段大段写文章，我们的标题就没意义了。。。

Feb 12 '16 09:02 imfly

新建一个 issue ，标题是必填的吧？

Feb 16 '16 02:02 lonelyclick

@lonelyclick 不知道你说的必填是什么意思？你是不是在用gitbook编辑器？如果是，您就要按照编辑器要求来做，它可能要求必填。不过，如果你用过git，不建议你使用gitbook编辑器。

我的做法是：直接在电脑上建立一个书目工程文件夹，自由撰写，随时修改。使用自己喜欢的ide（我用的ubuntu的文本编辑器gedit），直接编辑写作。为了实时预览，可以开启一个gitbook serve，浏览器会实时更新显示。最后，用gitbook-summary生成需要的目录。

这样做，简单自由，效果更好。因此，Summary 一个重要的作用就是把分散在各文件夹下的诸多文件一键索引出符合gitbook电子书要求的目录文件，而不过多限制用户操作行为， Summary 仅仅把文件（md文件，其他.html文件等自动过滤掉）名作为目录名。

其实，把文件名设成目录标题，更便于思考和维护。如果不习惯，生成的目录也是可以手动修改的（工作量比没有summary要少很多）。

Feb 16 '16 05:02 imfly

可以加个判断，如果没有写标题就直接取文件名。这样文件名可以简单点，标题可以写很长。

Feb 22 '16 00:02 greedbell

考虑用 front matter? https://www.npmjs.com/package/front-matter

Jan 22 '17 23:01 garyng

@garyng :+1: 这种方式倒是一种很好的选择，这样用户就更加自由了。

欢迎你们提供PR，我最近专注于亿书的开发，时间不宽裕，暂时还不能添加这些功能， :cry:

Jan 23 '17 00:01 imfly

gitbook-summary gitbook-summary copied to clipboard