zguide for aardio 的简单说明

namwonsta

从源码到html的全过程全部开源，概括的讲目前是一个框架，两个库组成。

框架是代码注释翻译框架，可能用途不会太广，留待以后扩展它用。

一个库是基于zeromq库的高层API绑定，第3章后半部分用到，此库暂供测试。

另一个库是markdown for aardio，makdown在开源界的文档书写中非常流行，它的目标是完成流畅自然语言书写，写完后脏活累活交给它代劳自动转换成html，可参考库源码+搜索学习其语法，比较简单。markdown for aardio目前可以完成简单的html5转换，zguide for aardio的html文档即由它完成，其中：
chapter[1-5]_html5.html，这些是html5的阅读版本，带简单导航，推荐使用。
chapter[1-5].html，这些是xhtml的版本，不带导航，测试markdown库时一并生成。

注意：
1.前3章基本完成，不定期会做更新，代码全部测试后几乎全部通过，如果遇到问题先确保zguide for aardio全部读过，还有问题请先查阅doc-2.1和doc-3.0目录下的api文档，应该基本解决。
2. 欢迎讨论，交流和此文档项目的完善、开发、错误修复，水平有限不能提供咨询与技术支持。

低调点

感谢~

look

大工程，楼主辛苦了！

sphawkcn

向楼主做出的巨大贡献表示崇高的敬意，好人一生平安。

donque2010

非常感谢namwonsta 版主的贡献，我花了接近两天时间学习了文档。 这里更新一个文档中的范例：偏执海盗队列
范例是在svn失效前下载的zguide for aardio基础上写的，范例中对zlist的next 函数做了一点修正。

希望大家能继续补充。

namwonsta

donque2010 发表于 2012-10-28 17:45
非常感谢namwonsta 版主的贡献，我花了接近两天时间学习了文档。 这里更新一个文档中的范例：偏执海盗队列
...

很高兴看到论坛有人在继续研究这种课题。svn失效后我这边只做了非常小的一些修订，然后在生产环境中已稳定运行4个多月了。很高兴看到你的修订，说明有人能够理解它并且还有可能进一步演化。你的这个范例我会收入第4章，日后打算把这个文档全部做完后放到github上，我只是抛砖引玉，欢迎同道中人补充，我将一一署名标注。

短平快

非常感谢namwonsta和donque2010，前人栽树后人乘凉。
这几天在研究zeromq，zguide for c已经看完，期待zguide for aardio。