使用apidoc为你的项目编写api文档

在使用apidoc之前，我一直使用wiki来写文档，后来发现这种方式更新起来比较痛苦，时间一长甚至就忘记了更新了。一直在寻找能够使用注释直接生成文档的程序。某一天同事推荐了apidoc，发现这正是我想要的工具。

apidoc原理

apidoc的原理是扫描你的代码文件，提取出注释部分，根据一些规则生成相应的文档。默认的模板久很美观，十分适合作为api文档的生成器。目前apidoc支持的注释基本涵盖了大部分语言的风格了，c，java，php，js，python，perl，lua, Erlang…

安装

需要使用npm安装，如果没有安装npm，请先去https://www.npmjs.com/下载npm并且安装。安装之后使用如下命令安装apidoc

npm install apidoc -g

开始API文档

通常我们的api的是通过一个方法的调用，在mvc架构的c层。如果一个api是 /foo/bar ,那么可以在相关的方法调用中这样写注释

 

/**
 * @api {GET} /foo/bar 一个测试的接口
 * @apiName  foobar
 * @apiVersion 0.1.0
 * @apiGroup foo
 * @apiDescription 这是一个测试的接口，会输出一个hello world
 */

（更多…）

使用sublime+platuml高效画图

程序员难免要经常画流程图，状态图，时序图等。以前经常用 visio 画，经常为矩形画多大，摆放在哪等问题费脑筋。有时候修改文字后，为了较好的显示效果不得不再去修改图形。今天介绍的工具是如何使用 Sublime + PlantUML 的插件画流程图，状态图，时序图等。这是一种程序员看了就会爱上的画图方式：自然，高效。

什么是 PlantUML

PlantUML 是一个画图脚本语言，用它可以快速地画出：

  • 时序图
  • 流程图
  • 用例图
  • 状态图
  • 组件图

简单地讲，我们使用 visio 画图时需要一个一个图去画，但使用 PlantUML 只需要用文字表达出图的内容，然后就可以直接生成图片。看一个最简单的例子： （更多…）

让sublime支持less css，以及支持压缩css的less插件

要想让sublime支持less，不仅仅是装个sublime插件就完事了啊！

事情的经过还是颇为曲折的。

第一步：安装nodejs

首先先配置一下环境，less需要nodejs支持，所以我们先要安装一下nodejs。到nodejs官网下载就可以了：https://nodejs.org/en/

第二步：安装less插件

由于我的是windows，所以打开cmd啦，用npm安装less，命令为：

npm install -g less@latest （更多…）

介绍一款工具，memcacheadmin，使用php制作的memcached管理监控工具

MemAdmin是一款可视化的Memcached管理与监控工具，使用PHP开发，体积小，操作简单。

主要功能：

  • 服务器参数监控：STATS、SETTINGS、ITEMS、SLABS、SIZES实时刷新
  • 服务器性能监控：GET、DELETE、INCR、DECR、CAS等常用操作命中率实时监控
  • 支持数据遍历，方便对存储内容进行监视
  • 支持条件查询，筛选出满足条件的KEY或VALUE
  • 数组、JSON等序列化字符反序列显示
  • 兼容memcache协议的其他服务，如Tokyo Tyrant (遍历功能除外)
  • 支持服务器连接池，多服务器管理切换方便简洁

guthub地址：https://github.com/junstor/memadmin

来源地址：http://www.junopen.com/memadmin/

ftp命令大全详解

来熟悉熟悉ftp命令，对于服务器之间的文件传输太有用啦，不会怎么能行呢！

先来看看基础的命令，包括了连接，列出列表，下载，上传，断开这最基础的命令，会这些，在使用ftp命令行就毫无压力啦！

1. 连接ftp服务器

格式：ftp [hostname| ip-address]

a)在linux命令行下输入：

ftp 192.168.1.1

b)服务器询问你用户名和密码，分别输入用户名和相应密码，待认证通过即可。

2.列出文件列表以及切换目录

这部分其实和linux并无区别，分别是ls，和cd （更多…）

代码语法高亮插件整理

语法高亮是文本编辑器用来显示文本的，特别是源代码，根据不同的类别来用不同的颜色和字体显示。这个功能有助于编写结构化的语言，比如编程语言，标记语言，这些语言的语法错误显示是有区别的。语法高亮并不会影响文本自身的意义，而且能很好的符合人们的阅读习惯。

语法高亮同时也能帮助开发者很快的找到他们程序中的错误。例如，大部分编辑器会用不同的颜色突出字符串常量。所以，非常容易发现是否遗漏了分隔符，因为相对于其他文本颜色不同。

现 在有各种各样的语法高亮工具，可以格式化语言，并且根据不同的编程语言进行高亮显示。无论是个 HTML 页面还是 PHP，Ruby，Python 或者是 ASP。这篇文章中，我们会介绍 15 款最好的代码语法高亮工具，帮助大家用更迷人的方式展示代码片段。Enjoy！ （更多…）

让sublime支持php，python等脚本的执行

sublime有自己的Build系统，默认的快捷键是ctrl+b。

只需要定制对应语言的执行命令，就可以支持各个语言的编译，执行了。

这里对几种主流的脚本语言执行做一些教程。

打开Tools->Build System -> New Build System  …

插入对应的json格式的配置即可

php

{
    "cmd": ["php", "$file"],
    "file_regex": "php$",
    "selector": "source.php"
}

保存为php.sublime-build，这下执行php不用老是跑去刷网页了，也不用老是开cmd窗口了。 （更多…）

让sublime支持c/c++语言的编译

sublime只是一个编辑器，让sublime支持c或者c++则是通过设定sublime快捷键调用相关的命令，达到编辑和执行c代码的目的。

首先需要下载一个c语言的编译器，对于 Windows 和 Linux 来说可以采用 gcc 。

For Windows:下载安装MinGW，然后在系统环境变量中添加

C:\MinGW\bin

（假设你把 MinGW安装在 C 盘），你安装到哪个路径就写哪个路径，别傻乎乎的直接复制啦，不然没用哦。

验证一下是否成功。win+r（win就是徽标），输入cmd，打开cmd窗口之后输入gcc -v看看，如果有gcc的信息说明成功了，如果显示gcc不是内部或外部命令，也不是可运行的程序那就是环境变量添加错啦！仔细检查一下呗。

最后在Sublime Text 2中Tools –> Build System –> New Build System…输入如下内容并保存为c.sublime-build （更多…）

sublime text自定义快捷键的方法

sublime text如何定义快捷键呢？下面来给出方法

sublime text2和sublime text3自定义快捷键的方法是一样的。打开Preferrences -> Key Bindings-User  这个就是用户自定义快捷键的配置文件了。可以参照  Preferrences -> Key Bindings-Default 这个系统默认的快捷键配置，里面就是一个大大的json啦。

不懂json？那不行，必须得学！

{ "keys": ["ctrl+shift+n"], "command": "new_window" }

keys对应的就是快捷键啦，而command对应的就是sublime的命令。如果想要修改快捷键，直接修改对应的keys里面的快捷键就可以啦。

如何查看command请查阅 http://imhuchao.com/965.html

（更多…）