文档章节

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

zendapi
 zendapi
发布于 2017/09/11 15:26
字数 873
阅读 35
收藏 1

经过紧张的开发,我们的 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 里面。

© 著作权归作者所有

共有 人打赏支持
zendapi

zendapi

粉丝 10
博文 12
码字总数 9448
作品 1
程序员
10月新增开源项目:号称最快的 Node.js 应用框架来了

立冬已过,人们认为这是夏天的终结,冬天的开始。立,建始也;冬,终也,万物收藏也。不过在开源的世界里,开发者并不畏惧寒冷,对技术的不懈追求也未曾终结。 开源的世界总是精彩纷呈,十月...

编辑部的故事
2017/11/07
0
16
zendapi/zendapi

zendAPI 是什么? zendAPI 是对 Zend Engine 的 C 接口使用 C++ 的最新标准 C++11 进行而面向对象的封装,从而屏蔽了底层 Zend Engine API 的接口复杂性,加快开发 PHP 扩展的效率。从而让 ...

zendapi
2017/09/08
0
0
注册GitHub账号并创建远程仓库

1、什么是GitHub? GitHub是一个面向开源及私有软件项目的托管平台,因为只支持git作为唯一的版本库格式进行托管,故名GitHub。 这里需要辨析一下GitHub与Git的概念。GitHub是代码托管平台;...

知猪侠_DC
07/22
0
0
[研究] 深入PHP内核之ZendAPI扩展篇

PHPNEWEXTENSION(phphello, phphello.c, $ext_shared) 前面插一个很好笑的报道:“2009/02/27日新浪:首节战罢,火箭命中率27.8%对上骑士17.6%,篮板15对7,助攻4对1”,这是我看过最搞笑的篮...

长平狐
2012/11/19
1K
0
Windows系统下Eclipse上搭建Python开发环境

Windows系统下Eclipse上搭建Python开发环境 在Eclipse上安装和搭建Python开发环境需要以下五步完成: (第一步)下载最新的Eclipse安装包。 我是基于Python版本python-3.6.4。python-3.6.4要...

zhangphil
01/03
0
0

没有更多内容

加载失败,请刷新页面

加载更多

一次由HandlerInterceptor进行的深入思考

HandlerInterceptor 是SpringFramework为我们提供的拦截器,一般我们可以用来鉴权或者日志记录等。 它是一个interface,主要方法有: /** * Intercept the execution of a handler. Called...

kipeng300
29分钟前
1
0
cmd中查询mysql表出现中文乱码

问题:在pycharm中正常的fetchall拉取数据,能够正常显示,而在cmd中直接select却出现中文乱码。 解决思路:右键查看cmd命令窗口属性得到,cmd窗口默认编码是gbk(如下图所示),而设置的mys...

fang_faye
55分钟前
2
0
centOS 安装Python3与python2并存

centOS 安装Python3与python2并存 如果本机安装了python2,尽量不要管他,使用python3运行python脚本就好,因为可能有程序依赖目前的python2环境, 比如yum!!!!! 不要动现有的python2环...

MedivhXu
今天
2
0
Spring JdbcTemplate模板模式与回调结合分析

在看Spring的JdbcTemplate的时候,看到其将模板模式和回调模式结合使用的实现,可以精妙的解决很多的问题。详见Spring中涉及的设计模式总结中的关于模板模式和回调模式结合的具分析,本文利用...

宸明
今天
1
0
docker update:更新一个或多个容器的配置

更新容器的配置 docker update:更新一个或多个容器的配置。 具体内容请访问:https://docs.docker.com/engine/reference/commandline/update/#options 语法:docker update [OPTIONS] CONTA...

lwenhao
今天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部