Hello world, zendAPI 项目官方网站正式上线

通过紧张的开发,咱们的 zendAPI 官网正式的与你们见面了,后续的开发动态和项目的文档,咱们都会同步的更新到网站上,谢谢你们的支持。html

zendAPI 的官网网站的源码托管在 : zendAPI official Site前端

下面我将介绍下咱们官网开发使用的一些开源项目:react

  • Hexo 静态博客生成器
  • React 框架
  • UiKit 前端框架
  • Webpack 打包工具
  • Doxygen C++文档生成器

咱们详细介绍下每一种技术在咱们的网站制做中承担的任务webpack

#Hexo 静态博客生成器

感谢 Hexo.io 项目研发团队为咱们带来这么好用的博客生成器,官网主要是基于 Hexo 进行二次开发,在其基础之上咱们实现了 zendAPI 本身的一套风格。
在开发过程当中咱们遇到的问题是 Hexo 自己是为博客而生成的,将其改形成一个官网的时候仍是下了一点功夫。git

#React 框架

为了让咱们的网站后续维护简单,我使用 react 框架对整个网站进行了组件化设计,经过 webpack 进行编译生成 Hexo 所识别的 ejs 模板文件,采用 Hexo 静态生成数据写在网页中,react 进行读取而后渲染出来, 让 react 跟 Hexo 完美的结合在一块儿。github

#UiKit 前端框架

首先我是一个后端开发工程师,我不是产品也不是设计也不是前端,因此我没有从零开始打造这个网站,而是通过了一些调研,在比较各类前端框架以后最终选择了 Uikit,这个框框很是轻量级,清爽的风格我很喜欢,咱们整个网站界面就是基于它进行实现。
详情你们能够访问 Uikit 的官方网站:https://getuikit.com/web

#Webpack 打包工具

咱们在开发网站的时候,后端采用了 Hexo 引擎, 可是我不是很喜欢 Ejs 的嵌套方式,感受很乱,因此采用了 Rect 做为前端渲染框架,顺便咱们就使用了 webpack 对整个前端页面进行打包,事实证实选择是对的,webpack 解决了不少没必要要的麻烦,让维护更简单。后端

#Doxygen C++ 文档生成器

Doxygen 是一个很是优秀的 C++ 文档生成器, 众所周知 C++ 的文法规则是至关复杂的,可是 Doxygen 识别的准确性仍是至关高的,在咱们官网中他主要承担的角色就是 zendAPI 的 api 栏目的生成。api

为了与网站的总体风格作到和谐统一,咱们没有使用 Doxygen 本来的 html 生成器,而是基于 xml 生成结果二次开发,根据 Doxygen 生成的 xml 文件,而后将数据进行解析以后暴露给 Hexo 博客生成器, 利用 Hexo 进行页面的生成,结果显示二者工做的很是完美,详情能够访问 文档中心 进行体验。前端框架

可是在咱们使用 Doxygen 过程当中发现它其实在生成 xml 的时候有一些信息已经被探测出来了,可是没有在最终的 xml 中进行体现出来,针对这种状况我对 Doxygen 进行了二次修改,固然只是针对 zendAPI 项目有用的一些修改。修改以后的源码存放在 Github: zendAPI Doxygen 里面。