Hello world, zendAPI 項目官方網站正式上線

通過緊張的開發，咱們的 zendAPI 官網正式的與你們見面了，後續的開發動態和項目的文檔，咱們都會同步的更新到網站上，謝謝你們的支持。

zendAPI 的官網網站的源碼託管在 : zendAPI official Site

下面我將介紹下咱們官網開發使用的一些開源項目：

• Hexo 靜態博客生成器
• React 框架
• UiKit 前端框架
• Webpack 打包工具
• Doxygen C++文檔生成器

咱們詳細介紹下每一種技術在咱們的網站製做中承擔的任務

#Hexo 靜態博客生成器

感謝 Hexo.io 項目研發團隊爲咱們帶來這麼好用的博客生成器，官網主要是基於 Hexo 進行二次開發，在其基礎之上咱們實現了 zendAPI 本身的一套風格。
在開發過程當中咱們遇到的問題是 Hexo 自己是爲博客而生成的，將其改形成一個官網的時候仍是下了一點功夫。

#React 框架

爲了讓咱們的網站後續維護簡單，我使用 react 框架對整個網站進行了組件化設計，經過 webpack 進行編譯生成 Hexo 所識別的 ejs 模板文件，採用 Hexo 靜態生成數據寫在網頁中，react 進行讀取而後渲染出來， 讓 react 跟 Hexo 完美的結合在一塊兒。

#UiKit 前端框架

首先我是一個後端開發工程師，我不是產品也不是設計也不是前端，因此我沒有從零開始打造這個網站，而是通過了一些調研，在比較各類前端框架以後最終選擇了 Uikit，這個框框很是輕量級，清爽的風格我很喜歡，咱們整個網站界面就是基於它進行實現。
詳情你們能夠訪問 Uikit 的官方網站：https://getuikit.com/

#Webpack 打包工具

咱們在開發網站的時候，後端採用了 Hexo 引擎， 可是我不是很喜歡 Ejs 的嵌套方式，感受很亂，因此採用了 Rect 做爲前端渲染框架，順便咱們就使用了 webpack 對整個前端頁面進行打包，事實證實選擇是對的，webpack 解決了不少沒必要要的麻煩，讓維護更簡單。

#Doxygen C++ 文檔生成器

Doxygen 是一個很是優秀的 C++ 文檔生成器， 衆所周知 C++ 的文法規則是至關複雜的，可是 Doxygen 識別的準確性仍是至關高的，在咱們官網中他主要承擔的角色就是 zendAPI 的 api 欄目的生成。

爲了與網站的總體風格作到和諧統一，咱們沒有使用 Doxygen 本來的 html 生成器，而是基於 xml 生成結果二次開發，根據 Doxygen 生成的 xml 文件，而後將數據進行解析以後暴露給 Hexo 博客生成器， 利用 Hexo 進行頁面的生成，結果顯示二者工做的很是完美，詳情能夠訪問 文檔中心 進行體驗。

可是在咱們使用 Doxygen 過程當中發現它其實在生成 xml 的時候有一些信息已經被探測出來了，可是沒有在最終的 xml 中進行體現出來，針對這種狀況我對 Doxygen 進行了二次修改，固然只是針對 zendAPI 項目有用的一些修改。修改以後的源碼存放在 Github: zendAPI Doxygen 裏面。