关于-V语言参考手册
为什么要弄这个
- 这是一个新兴的语言(虽然看上去不是那么让人感觉靠谱,但你不得不相信强大的开源社区的力量)
- 国内某些人正在试图通过商业化的相关站点盈利(这看上去违背了开源的初衷)
- V语言虽然有官方文档,但它的参考手册不是那么近如人意
因此,我们将基于github的page实现一个,透明的,开源的,不带任何利益关系的V语言参考手册。 这与V语言官方文档并不冲突,因为在使用一个语言的过程中,学习文档仅仅只是开始,真正上手后,其实更加常查阅的,是那语言的参考手册,或者库类源码。
为什么有些人极力去捧那传说中“世界上最好的语言”,正是因为那语言有完善的参考手册,而不是只有官方的文档和某些所谓的中文网。 在网络编程的世界里,W3C是个好地方,理由也许不需要过多的阐明。在V语言开发的过程中,只希望v-ref可以为一些朋友带来帮助。
何不去直接读源码
- 对于一些不是那么优秀的程序员来说,可能对直接读一个开源的编程语言源码,是有那么一些许的吃力
- 真正的开发过程的,往往开发者还是更倾向于,使用母语编写的手册,而不是去阅读那苦涩的源码
手册原则
不带有个人感情,公正公开。 静态,不使用动态服务器,只依靠github的page,无后端,依靠js实现手册效果。 所有内容与源码公开在github。 代码中不加载任何第三方服务器内容(仅允许github page服务加载),防止含有任何广告。
开源说明
本存储库使用MIT许可,同时建议凭良心遵守996许可证的条款。
对于某些被利益熏心的朋友,若试图违反许可使用,请自行考虑良心的位置关系。
日程计划
- 先把vlang文档翻译了(已完成)
- 基于githubPage,通过编写JS实现参考手册的格局(已完成)
- 将v语言标准库录入参考手册(进行中)
附加说明:由于我的时间有限,因此这个手册的完善可能需要一个过程。欢迎各位朋友一同加入,来编写和完善手册,欢迎大家为本手册提供优质的demo。