- 使用JSDoc生成漂亮的文档
胡西风_foxww
#JavaScript#vuejsdocjsdoc-vue文档vuejs文档生成
原文地址:https://qdgithub.com/home/index/article/aid/248.html1.什么是JSDocJSDoc是一个用于JavaScript的API文档生成器,类似于Javadoc或phpDocumentor。可以将文档注释直接添加到源代码中。JSDoc工具将扫描您的源代码并为您生成一个HTML文档网站。2.JSDoc可以用来干什么生成清晰文档:通过为函数、方法和
- 玩转微服务-技术篇-JSDOC教程
Elcker
玩转微服务javascript微服务
一.简介JSDoc3是一个用于JavaScript的API文档生成器,类似于Javadoc或phpDocumentor。可以将文档注释直接添加到源代码中。JSDoc工具将扫描您的源代码并为您生成一个HTML文档网站。JSDoc是一种用于JavaScript代码文档注释的标记语言和工具。它不仅仅是一种文档编写方式,更是一种代码规范和团队协作工具。通过使用JSDoc注释,开发人员可以将关于函数、类、方
- 使用jsDoc(注释规范)
smouns_
前端javascript
jsDoc,顾名思义,jsDoc是一个用于JavaScript的API文档生成器,类似于Javadoc或phpDocumentor。它根据JavaScript文件中的注释信息,生成JS应用程序或模块的API文档。通过使用JSDoc标记如:命名空间,类,方法参数等,从而使开发者能够轻易地阅读代码,掌握代码定义的类和和其属性和方法,从而降低维护成本并提高开发效率。JSDoc中文文档JSDoc注释通常应
- 前端教程-文档工具
累牛满面
前端前端
JSDoc入门JSDoc3是一个用于JavaScript的API文档生成器,类似于Javadoc或phpDocumentor。可以将文档注释直接添加到源代码中。JSDoc工具将扫描您的源代码并为您生成一个HTML文档网站。JSDoc官网VuePressVue驱动的静态网站生成器以Markdown为中心的项目结构,以最少的配置帮助你专注于写作。官网docsifydocsify可以快速帮你生成文档网站
- php 的代码解析相关的扩展
sorry510
https://github.com/PHP-DI/PhpDocReader在PHPdocblocks注释中解析@varand@param的值https://github.com/Roave/BetterReflection更好的反射解析工具https://github.com/phpDocumentor/phpDocumentor注释文档解析工具https://github.com/nikic/
- php经常用到的一些composer包
a7442358
phpcomposer
列举一些对开发有帮助的composer包,对于各个包的安装和使用不在这里做过多的介绍,持续更新。1.phpDocumentor对于有规范注释的PHP文件,生成对应的注释文档。GitHub地址:https://github.com/phpDocumentor/phpDocumentor2composerrequire"phpdocumentor/phpdocumentor:2.*"2.PHP-CS-
- PHPDoc/PHPDocumentor生成API文档
r_martian
PHP
PHPDocumentor是一个用PHP写的强大的文档自动生成工具,对于有规范注释的php程序,能够快速生成具有结构清晰、相互参照、索引等功能的API文档。旧版本是PHPDoc,PHPDoc是PEAR下面的一个非常优秀的模块,类似于javadoc。从1.3.0开始,更名为phpDocumentor,新版本新加了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF、
- PHP编码规范-笔记
Towering~
所有的代码都要变成可供他人容易阅读的良好的代码书写习惯+良好的注释习惯+PhpDocumentor=程序说明书整理日期:2013-07-30为什么要编码规范:编码规范(codeconventions)对于程序员而言尤为重要,有以下几个原因:1.在一个软件的生命周期中,80%的花费用于维护。2.几乎没有任何一个软件在其整个生命周期中均由最初的开发人员来维护。3.编码规范可以改善软件的可读性,可以让程
- PHP注释生成文档
w_w_wei
PHP注释为了让代码更具可读性,需要给出一些关键的提示注释,为了跟好的生成帮助文档,更需要对注释进行规范。这里选用了PhpDocumentor的注释风格,如果需要生成文档,也只要用工具直接生成就行了。关于PhpDocumentor项目地址:https://github.com/phpDocumentor/phpDocumentor2Composer:https://packagist.org/pa
- 完美解决phpdoc导出文档中@package的warning及Error的错误
今天在编写PHPDoc的导出文档的时候发现一个很郁闷的错误,虽然这个warning不是什么重要错误,但是看着总是很不爽的。于是就去网上找了很多相关的资料,可是郁闷的是不知道是我用的PHPDoc版本太新(1.4的版本),还是说很多人都没遇到这个问题,反正就是没有相关的这个资料找到,只是找到了一些从PHPDocumentor官方网倒出来的关于@package的使用注意事项,然后就只能一条一条检查,看了
- PHP注释标记整理
烟草的香味.
PHP
什么是注释标记我们在平常写代码或看别人写的代码时,在方法的说明注释中经常会有这样的注释:/***@param$num*@returnarray*/上面的*@param*@return就是注释标记注释标记用于生成文档,param指明需要接收的参数,return指明返回值在使用phpDocumentor等工具生成文档时,会识别相关注释,而且IDE也会识别,在编码的过程中会给出提示.PHP注释标记总结@
- PHP 规范开发(四):重构、代码规范及设计模式
半斤桃花
代码规范重构和设计模式
预期学习目标重构:改善既有代码的设计代码简洁之道程序员修炼之道设计模式写代码总结四本书的学习心得语法糖可变数量的参数列表类似与func_get_args()functionsum(...$numbers){$acc=0;foreach($numbersas$n){$acc+=$n;}return$acc;}echosum(1,2,3,4);#将会输出:10注释规范PHPDocumentor代码解耦
- 如何做好 PHP 项目文档管理?PHPer 开发的必备利器!
zicochan
对于常年写PHP的老司机来说,PHPDoc一定不会陌生,不过从1.3.0开始,更名为phpDocumentor。它作为一个用PHP写的工具,主要作用是从你的源代码的注释中生成文档,因此在给你的程序做注释的过程,也就是你编制文档的过程。这样也促使你要养成良好的编程习惯,尽量使用规范,也避免了事后编制文档和文档的更新不同步的一些问题。新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操
- Phpdocumentor使用心得
久度
如果你是一名码农,除了敲代码之外还要做一些琐事例如:写文档。那么你就应该学会使用工具自动生成,这样会大大提高工作效率。下面介绍一下笔者自行研究的phpdocumentor,欢迎讨论。首先说明一下笔者环境:window系统xampp集成环境php安装目录:G:xampp/php先附一张简单的phpdocumentor生成图:Phpdocumentor使用心得一、非集成环境1、依赖pear安装:a)安
- 基础级-phpDocumentor
m18779186977
PHP文档团队协作
设想一下,你自己设计、书写的程序,倘若无需他人参与,你是否就不需要文档?时隔一年,你还能记清代码中的细节吗?一个方法的参数是整型,还是字符串类型?亦或是布尔型?编程作为一种兴趣,我对它报以热情、投入成本,自然就不希望:我亲手书写的代码,变成盘根错节的麻绳,绊倒我自己。毕竟,我们很难追踪系统的工作方式和编码目的,对于一个大型项目来说,往往文档会成为致命级的存在。用法格式特殊关键字结语用法在phpDo
- php文档工具PHP Documentor安装与使用方法
张映
本文讲述了php文档工具PHPDocumentor安装与使用方法。分享给大家供大家参考,具体如下:PHPDocumentor是PEAR下面的一个模块,用来生成文档。PHPDocumentor扫描指定目录下面的php源代码,扫描其中的关键字,截取需要分析的注释,然后分析注释中的专用的tag,生成html文件,接着根据已经分析完的类和模块的信息,建立相应的索引,生成html文件。在review代码的时
- PhpDocumentor
素人派surenpi
phpdocumentor
PhpDocumentor是PHP写的,用来生成PHP文档的一个工具。安装方法pearinstallPhpDocumentor
- PhpDocumentor
素人派surenpi
phpdocumentor
PhpDocumentor是PHP写的,用来生成PHP文档的一个工具。安装方法pearinstallPhpDocumentor
- PHP Document 代码注释规范
document
HPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是 phpdoc。
1. 什么是phpDocumentor ?
PHPDocumentor 是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是 phpdoc,从1.3.0开始,更名为phpDocu
- 如何正确安装phpDocumentor
document
我们在进行PHP环境配置时,需要对phpDocumentor进行安装,那么如何才能正确的实现安装呢?我们介绍了两种方法。安装phpDocumentor的第一种方式是从pear.php.net 或 sourceforge.net下载压缩包并解压。另一种方式是通过pear安装
为你解读PHP realpath路径函数
深入分析几种PHP获取客户端IP的情况
解读PHP函数strrev
- PHPDocumentor代码注释规范说明
document
PHPDocumentor是一个的用PHP写的道具,对于有规则注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。 标记 用途 描述 @abstract 抽象类的变量和方法 @access public, private or protected 文档的访问、使用权限. @access private 表明这个文档是被保护的。
- windows下安装PhpDocumentor(phpdoc)笔记
document
PhpDocumentor简介
PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种形式,非常的方便。
&nbs
- PHP编程规范
PHP
一直以来我都是以php函数的风格来写php,所有变量,函数,类都使用小写,单词之间以下划线隔开,一直比较排斥驼峰式的代码规范,个人觉得在大小写字母之间的书写代码,很麻烦,而且PHP自己的函数都是小写,为什么我不用这种格式呢?
良好的代码书写习惯 + 良好的注释习惯 + PhpDocumentor = 程序说明书
一个团队,必须有整齐的代码书写习惯,如果再配上统一的IDE开发环境,详细的任
- 修改PhpDocumentor默认编码
document
最近项目需要
phpdoc生成文档,首先安装
phpDocumentor,利用pear安装:
切换用户:
su root 安装PhpDocumentor:
pear install PhpDocumentor 生成文档:
phpdoc -o HTML:frames:earthli -d CustomService/ -t docs/ &nbs
- Zend Framework的PHP编码规范【2】
framework
4.4. 类 4.4.1. 类的声明
类的声明应该遵守以下要求:
l 大括号必须写在类名字的下一行;
l 每个类都必须有一个遵守PHPDocumentor标准的注释文档块;
l &n
- PHPDocumentor代码注释规范说明
document
PHPDocumentor是一个的用PHP写的道具,对于有规则注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。 标记 用途 描述 @abstract 抽象类的变量和方法 @access public, private or protected 文档的访问、使用权限. @access private 表明这个文档
- phpDocumentor学习使用记录
wms3001
浏览器客户端记录PHP程序
phpDocumentor学习使用记录一.phpDocumentor简介PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种
- phpDocumentor学习使用记录
wms3001
浏览器客户端记录PHP程序
phpDocumentor学习使用记录一.phpDocumentor简介PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种
- phpDocumentor学习使用记录
一耳听世界
phpDocumentor学习使用记录一.phpDocumentor简介PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种
- php一键环境包xammp 安装 phpDocumentor
wms3001
targetblankPHP程序
1.phpDocumentor简介。PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档。老的版本是phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种形式,非常的方便。phpDocum
- 解线性方程组
qiuwanchi
package gaodai.matrix;
import java.util.ArrayList;
import java.util.List;
import java.util.Scanner;
public class Test {
public static void main(String[] args) {
Scanner scanner = new Sc
- 在mysql内部存储代码
annan211
性能mysql存储过程触发器
在mysql内部存储代码
在mysql内部存储代码,既有优点也有缺点,而且有人倡导有人反对。
先看优点:
1 她在服务器内部执行,离数据最近,另外在服务器上执行还可以节省带宽和网络延迟。
2 这是一种代码重用。可以方便的统一业务规则,保证某些行为的一致性,所以也可以提供一定的安全性。
3 可以简化代码的维护和版本更新。
4 可以帮助提升安全,比如提供更细
- Android使用Asynchronous Http Client完成登录保存cookie的问题
hotsunshine
android
Asynchronous Http Client是android中非常好的异步请求工具
除了异步之外还有很多封装比如json的处理,cookie的处理
引用
Persistent Cookie Storage with PersistentCookieStore
This library also includes a PersistentCookieStore whi
- java面试题
Array_06
java面试
java面试题
第一,谈谈final, finally, finalize的区别。
final-修饰符(关键字)如果一个类被声明为final,意味着它不能再派生出新的子类,不能作为父类被继承。因此一个类不能既被声明为 abstract的,又被声明为final的。将变量或方法声明为final,可以保证它们在使用中不被改变。被声明为final的变量必须在声明时给定初值,而在以后的引用中只能
- 网站加速
oloz
网站加速
前序:本人菜鸟,此文研究总结来源于互联网上的资料,大牛请勿喷!本人虚心学习,多指教.
1、减小网页体积的大小,尽量采用div+css模式,尽量避免复杂的页面结构,能简约就简约。
2、采用Gzip对网页进行压缩;
GZIP最早由Jean-loup Gailly和Mark Adler创建,用于UNⅨ系统的文件压缩。我们在Linux中经常会用到后缀为.gz
- 正确书写单例模式
随意而生
java 设计模式 单例
单例模式算是设计模式中最容易理解,也是最容易手写代码的模式了吧。但是其中的坑却不少,所以也常作为面试题来考。本文主要对几种单例写法的整理,并分析其优缺点。很多都是一些老生常谈的问题,但如果你不知道如何创建一个线程安全的单例,不知道什么是双检锁,那这篇文章可能会帮助到你。
懒汉式,线程不安全
当被问到要实现一个单例模式时,很多人的第一反应是写出如下的代码,包括教科书上也是这样
- 单例模式
香水浓
java
懒汉 调用getInstance方法时实例化
public class Singleton {
private static Singleton instance;
private Singleton() {}
public static synchronized Singleton getInstance() {
if(null == ins
- 安装Apache问题:系统找不到指定的文件 No installed service named "Apache2"
AdyZhang
apachehttp server
安装Apache问题:系统找不到指定的文件 No installed service named "Apache2"
每次到这一步都很小心防它的端口冲突问题,结果,特意留出来的80端口就是不能用,烦。
解决方法确保几处:
1、停止IIS启动
2、把端口80改成其它 (譬如90,800,,,什么数字都好)
3、防火墙(关掉试试)
在运行处输入 cmd 回车,转到apa
- 如何在android 文件选择器中选择多个图片或者视频?
aijuans
android
我的android app有这样的需求,在进行照片和视频上传的时候,需要一次性的从照片/视频库选择多条进行上传
但是android原生态的sdk中,只能一个一个的进行选择和上传。
我想知道是否有其他的android上传库可以解决这个问题,提供一个多选的功能,可以使checkbox之类的,一次选择多个 处理方法
官方的图片选择器(但是不支持所有版本的androi,只支持API Level
- mysql中查询生日提醒的日期相关的sql
baalwolf
mysql
SELECT sysid,user_name,birthday,listid,userhead_50,CONCAT(YEAR(CURDATE()),DATE_FORMAT(birthday,'-%m-%d')),CURDATE(), dayofyear( CONCAT(YEAR(CURDATE()),DATE_FORMAT(birthday,'-%m-%d')))-dayofyear(
- MongoDB索引文件破坏后导致查询错误的问题
BigBird2012
mongodb
问题描述:
MongoDB在非正常情况下关闭时,可能会导致索引文件破坏,造成数据在更新时没有反映到索引上。
解决方案:
使用脚本,重建MongoDB所有表的索引。
var names = db.getCollectionNames();
for( var i in names ){
var name = names[i];
print(name);
- Javascript Promise
bijian1013
JavaScriptPromise
Parse JavaScript SDK现在提供了支持大多数异步方法的兼容jquery的Promises模式,那么这意味着什么呢,读完下文你就了解了。
一.认识Promises
“Promises”代表着在javascript程序里下一个伟大的范式,但是理解他们为什么如此伟大不是件简
- [Zookeeper学习笔记九]Zookeeper源代码分析之Zookeeper构造过程
bit1129
zookeeper
Zookeeper重载了几个构造函数,其中构造者可以提供参数最多,可定制性最多的构造函数是
public ZooKeeper(String connectString, int sessionTimeout, Watcher watcher, long sessionId, byte[] sessionPasswd, boolea
- 【Java命令三】jstack
bit1129
jstack
jstack是用于获得当前运行的Java程序所有的线程的运行情况(thread dump),不同于jmap用于获得memory dump
[hadoop@hadoop sbin]$ jstack
Usage:
jstack [-l] <pid>
(to connect to running process)
jstack -F
- jboss 5.1启停脚本 动静分离部署
ronin47
以前启动jboss,往各种xml配置文件,现只要运行一句脚本即可。start nohup sh /**/run.sh -c servicename -b ip -g clustername -u broatcast jboss.messaging.ServerPeerID=int -Djboss.service.binding.set=p
- UI之如何打磨设计能力?
brotherlamp
UIui教程ui自学ui资料ui视频
在越来越拥挤的初创企业世界里,视觉设计的重要性往往可以与杀手级用户体验比肩。在许多情况下,尤其对于 Web 初创企业而言,这两者都是不可或缺的。前不久我们在《右脑革命:别学编程了,学艺术吧》中也曾发出过重视设计的呼吁。如何才能提高初创企业的设计能力呢?以下是 9 位创始人的体会。
1.找到自己的方式
如果你是设计师,要想提高技能可以去设计博客和展示好设计的网站如D-lists或
- 三色旗算法
bylijinnan
java算法
import java.util.Arrays;
/**
问题:
假设有一条绳子,上面有红、白、蓝三种颜色的旗子,起初绳子上的旗子颜色并没有顺序,
您希望将之分类,并排列为蓝、白、红的顺序,要如何移动次数才会最少,注意您只能在绳
子上进行这个动作,而且一次只能调换两个旗子。
网上的解法大多类似:
在一条绳子上移动,在程式中也就意味只能使用一个阵列,而不使用其它的阵列来
- 警告:No configuration found for the specified action: \'s
chiangfai
configuration
1.index.jsp页面form标签未指定namespace属性。
<!--index.jsp代码-->
<%@taglib prefix="s" uri="/struts-tags"%>
...
<s:form action="submit" method="post"&g
- redis -- hash_max_zipmap_entries设置过大有问题
chenchao051
redishash
使用redis时为了使用hash追求更高的内存使用率,我们一般都用hash结构,并且有时候会把hash_max_zipmap_entries这个值设置的很大,很多资料也推荐设置到1000,默认设置为了512,但是这里有个坑
#define ZIPMAP_BIGLEN 254
#define ZIPMAP_END 255
/* Return th
- select into outfile access deny问题
daizj
mysqltxt导出数据到文件
本文转自:http://hatemysql.com/2010/06/29/select-into-outfile-access-deny%E9%97%AE%E9%A2%98/
为应用建立了rnd的帐号,专门为他们查询线上数据库用的,当然,只有他们上了生产网络以后才能连上数据库,安全方面我们还是很注意的,呵呵。
授权的语句如下:
grant select on armory.* to rn
- phpexcel导出excel表简单入门示例
dcj3sjt126com
PHPExcelphpexcel
<?php
error_reporting(E_ALL);
ini_set('display_errors', TRUE);
ini_set('display_startup_errors', TRUE);
if (PHP_SAPI == 'cli')
die('This example should only be run from a Web Brows
- 美国电影超短200句
dcj3sjt126com
电影
1. I see. 我明白了。2. I quit! 我不干了!3. Let go! 放手!4. Me too. 我也是。5. My god! 天哪!6. No way! 不行!7. Come on. 来吧(赶快)8. Hold on. 等一等。9. I agree。 我同意。10. Not bad. 还不错。11. Not yet. 还没。12. See you. 再见。13. Shut up!
- Java访问远程服务
dyy_gusi
httpclientwebservicegetpost
随着webService的崛起,我们开始中会越来越多的使用到访问远程webService服务。当然对于不同的webService框架一般都有自己的client包供使用,但是如果使用webService框架自己的client包,那么必然需要在自己的代码中引入它的包,如果同时调运了多个不同框架的webService,那么就需要同时引入多个不同的clien
- Maven的settings.xml配置
geeksun
settings.xml
settings.xml是Maven的配置文件,下面解释一下其中的配置含义:
settings.xml存在于两个地方:
1.安装的地方:$M2_HOME/conf/settings.xml
2.用户的目录:${user.home}/.m2/settings.xml
前者又被叫做全局配置,后者被称为用户配置。如果两者都存在,它们的内容将被合并,并且用户范围的settings.xml优先。
- ubuntu的init与系统服务设置
hongtoushizi
ubuntu
转载自:
http://iysm.net/?p=178 init
Init是位于/sbin/init的一个程序,它是在linux下,在系统启动过程中,初始化所有的设备驱动程序和数据结构等之后,由内核启动的一个用户级程序,并由此init程序进而完成系统的启动过程。
ubuntu与传统的linux略有不同,使用upstart完成系统的启动,但表面上仍维持init程序的形式。
运行
- 跟我学Nginx+Lua开发目录贴
jinnianshilongnian
nginxlua
使用Nginx+Lua开发近一年的时间,学习和实践了一些Nginx+Lua开发的架构,为了让更多人使用Nginx+Lua架构开发,利用春节期间总结了一份基本的学习教程,希望对大家有用。也欢迎谈探讨学习一些经验。
目录
第一章 安装Nginx+Lua开发环境
第二章 Nginx+Lua开发入门
第三章 Redis/SSDB+Twemproxy安装与使用
第四章 L
- php位运算符注意事项
home198979
位运算PHP&
$a = $b = $c = 0;
$a & $b = 1;
$b | $c = 1
问a,b,c最终为多少?
当看到这题时,我犯了一个低级错误,误 以为位运算符会改变变量的值。所以得出结果是1 1 0
但是位运算符是不会改变变量的值的,例如:
$a=1;$b=2;
$a&$b;
这样a,b的值不会有任何改变
- Linux shell数组建立和使用技巧
pda158
linux
1.数组定义 [chengmo@centos5 ~]$ a=(1 2 3 4 5) [chengmo@centos5 ~]$ echo $a 1 一对括号表示是数组,数组元素用“空格”符号分割开。
2.数组读取与赋值 得到长度: [chengmo@centos5 ~]$ echo ${#a[@]} 5 用${#数组名[@或
- hotspot源码(JDK7)
ol_beta
javaHotSpotjvm
源码结构图,方便理解:
├─agent Serviceab
- Oracle基本事务和ForAll执行批量DML练习
vipbooks
oraclesql
基本事务的使用:
从账户一的余额中转100到账户二的余额中去,如果账户二不存在或账户一中的余额不足100则整笔交易回滚
select * from account;
-- 创建一张账户表
create table account(
-- 账户ID
id number(3) not null,
-- 账户名称
nam