Vim плагин для генерации комментариев к документации Javascript
Есть ли плагин для vim, что-то вроде Jsbeautify, который автоматически генерирует комментарии JavaDoc в файлах скриптов.
Для примера возьмем вот это
function(a , b , c){
}
И возвращение
/**
* Description.
*
* @param a Description.
* @param b Description.
* @param c Description.
*/
function(a , b , c){
}
3 ответа:
Вот небольшая вещь, чтобы вы начали-настроить по мере необходимости!- )
" generate doc comment template map <LocalLeader>/ :call GenerateDOCComment()<cr> function! GenerateDOCComment() let l = line('.') let i = indent(l) let pre = repeat(' ',i) let text = getline(l) let params = matchstr(text,'([^)]*)') let paramPat = '\([$a-zA-Z_0-9]\+\)[, ]*\(.*\)' echomsg params let vars = [] let m = ' ' let ml = matchlist(params,paramPat) while ml!=[] let [_,var;rest]= ml let vars += [pre.' * @param '.var] let ml = matchlist(rest,paramPat,0) endwhile let comment = [pre.'/**',pre.' * '] + vars + [pre.' */'] call append(l-1,comment) call cursor(l+1,i+3) endfunction
Предполагая, что список параметров находится в одной строке, он пытается сопоставить параметры, создает строку комментария и добавляет эту строку комментария к строке перед заголовком функции.
С помощью snipmate можно создать фрагмент или использовать смесь фактических JS фрагментов