SublimePHPNinJaManual

Sublime 函数手册提示
授权协议 Apache
开发语言 Java
所属分类 插件和扩展、 Sublime Text 扩展
软件类型 开源软件
地区 国产
投 递 者 邬宏扬
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

SublimePHPNinJaManual 是 Sublime 中的函数手册提示,中文,其他语言的可以通过命令生成

由来

自己因为sublime中没有一个好的php函数提示所苦恼。曾经在Sublime的thinkphp插件里实现过一次,那个时候用的是netbeans 里 php提示的文件库,然后显示也不大好看。一直以为sublime 没法做到好看的ui 因为api少。

前几天发现了国人的自己做的Ctranslator tool 

这不就是我想要的吗?看源码发现是用了一个开源的库 StyledPopup。 用html灵活多了。

而后,自己其实一直用的chrome 浏览器的插件,PHP NanJa Manual。支持各种语言,也有示列,就是每次写代码开浏览器太麻烦了。由于他提供一个开源库PHP doc parser,可以将php官方手册转换成json文件,自己就有了移植的想法。  所以名字就参考了他的,希望不要告侵权。 由于son文件过于大,python没有缓存机制(或许我不知道),我就用thinkphp 转成了一个db。2个表 fun、funlist fun存 函数名, funlist存 函数名和对应son数据。

安装

使用Sublime Text 3 Package Control 插件(http://wbond.net/sublime\_packages/package\_control) 按 CTRL + SHIFT + P 后 找到 Package Control: Install Package 然后回车。列表中找到PhpNinJaManual这个插件(等审核过了会有)。

或者直接 git clone 到你的 Sublime Text 3 packages 目录 (usually located at /Sublime Text 3/Packages/)。记得把SublimePHPNinJaManual 改为PhpNinJaManual。pac 安装的应该没这个问题。

使用说明

选中要查看的php函数名,然后右键会发现 “查看函数说明”菜单 ,点击后, 会弹出函数说明浮层 

如果想配快捷键,只需要你自定义快捷键里 commond 写 show_php_document就行了,这个参考Sublime手册快捷键,自己定义一个就好了。比如 f1或者 其他。

关于手册其他语言的生成

拿英文 en 举例。 先到 手册解析器主页:https://github.com/martinsik/php-doc-parser 找一个目录 写上composer.json 内容:

{
    "require": {
      ...
      "martinsik/php-doc-parser": "~2.0"
    }
}

然后 composer.phar install 也可能 composer install 装好后, 当前目录vendor/bin 下会有 执行文件,然后

vendor/bin/doc-parser help parser:run  生成好这2个json文件后, 复制到,插件目录的 App/Runtime/Data里,

到时候就不是zh 而是en。 然后 命令行切换到插件目录里执行

会提示多少函数导入了。我没生成英文的,所以是0。

未来特性

可能会用PHPConnector 重构下。 可能会把示列加上,不过数据库体积就更大了,而且可能显示会更长

注意点

  • 有的函数因为返回了&$count 这类Sublime插件语言中的关键字导致解析不了向后的html字符串

    。暂时不知道怎么修复 已经被作者告知了方法,已修复。PHP返回那边转义了'&'符号 √

  • 由于那个浮层组件不支持设定宽高,目前长内容会出现滚动条,只能等作者解决了,我会向他提Issue的。 作者也告知了有个宽度的参数 ,我改了下插件,设了700 以后提供配置吧。反正我用str_replace函数测试足够了。√

  • 解析手册用的是PHP,需要你们的 命令行里php 可用,所有, 最好检查下自己的系统环境变量或者聪明的里 php -v 能不能用

  • 参数解释前添加了 返回类型显示和高亮,另外函数名可以点击 去PHP官网查看。

  • 如果你想定义输出的格式,和样式可以去看插件目录里的app Doc控制器的find方法。和find.html 模板。

find.html

<style>
a{
    color: #62D9EF;
}
</style>
<span class="keyword">{$fun.params.0.ret_type}</span> <a class="entity name function" href="{$url}">{$fun.params.0.name}</a> (<span class="comment line"><volist name="fun.params.0.list" id="i">
    [ <neq name="key" value="0">,</neq><span class="keyword">{$i.type}</span> <span class="string quoted">{$i.var}</span> ]' {$i['beh']? $i['beh']:$i['type']}  {$i.var}
</volist></span>)
<p>{$fun.long_desc}</p>
<p>参数: <br>
<volist name="fun.params.0.list" id="i">
    {$i.var} - {$i['desc']? $i['desc']: '暂无说明'} <br>
    </volist>
</p>

直接改HTML和控制器后直接调试插件的效果太他妈爽了,可惜我没有配色天赋。曾经尝试body白色,想弄个清淡的浮层,发现body外还有边距。反正大家可以自由DIY。配出适合自己主题的样式。可以告诉我,我以后,可以动态的针对不同主题调用不同样式,达到显示最优化。

 相关资料
  • Pandas 是基于 NumPy 的一种工具,该工具是为解决数据分析任务而创建的。Pandas 纳入了大量库和一些标准的数据模型,提供了高效地操作大型数据集所需的工具。

  • 全局函数 在 0.2.0 之前,需要手工引入 bui-weex var buiweex = require("bui-weex"); 在 0.2.0+ 为了方便开发人员使用,将 bui-weex 做成了 Vue plugin, 通过 Vue.use 的方式注入到全局。所有的vue页面无需再引入bui-weex了。该库内置了一些工具方法,参考如下: this.$toast /** * 吐司信息

  • Linux C 函数 使用手册,共收录278个函数,函数是模块化程序设计思想的产物,是构成C语言程序的基本功能模块,它完成一项相对独立的任务。

  • 提示 (bui-tip)     用法 value 提示的文本内容,参考如下: <bui-tip value="This is success tip."></bui-tip> type 提示条的类型,也就是色值,组件提供了多个色值的提示条,参考如下: <bui-tip value="bui-weex success tip."></bui-tip> <bui-tip type="info" va

  • 配置报警策略的时候open-falcon支持多种报警触发函数,比如all(#3) diff(#10)等等,这些#后面的数字表示的是最新的历史点。比如#3代表的是最新的三个点。 all(#3): 最新的3个点都满足阈值条件则报警 max(#3): 对于最新的3个点,其最大值满足阈值条件则报警 min(#3): 对于最新的3个点,其最小值满足阈值条件则报警 sum(#3): 对于最新的3个点,其和满足

  • 扩展内可以调用registerFunction来注册内置函数到PHP中。需要注意Zend有限制,必须在Extension对象创建时注册函数。这与类的注册不同,扩展类必须在onStart回调中注册。 PHPX_EXTENSION() { Extension *ext = new Extension("test", "0.0.1"); ext->registerFunction(PHP

  • [基础类型](./Basic Types.md) [变量声明](./Variable Declarations.md) 接口 类 函数 泛型 枚举 [类型推论](./Type Inference.md) [类型兼容性](./Type Compatibility.md) [高级类型](./Advanced Types.md) Symbols [Iterators 和 Generators](./It

  • void register_function(string name, mixed impl, bool cacheable, array or null cache_attrs) Use this to dynamically register template function plugins. Pass in the template function name, followed by t