spacevim/.SpaceVim.d/autoload/SpaceVim/dev/api.vim

97 lines
3.3 KiB
VimL
Raw Permalink Normal View History

2024-08-21 14:17:26 +08:00
"=============================================================================
" api.vim --- Develop script for update api index
" Copyright (c) 2016-2023 Wang Shidong & Contributors
" Author: Wang Shidong < wsdjeg@outlook.com >
" URL: https://spacevim.org
" License: GPLv3
"=============================================================================
scriptencoding utf-8
let s:FILE = SpaceVim#api#import('file')
let s:SYS = SpaceVim#api#import('system')
let s:CMP = SpaceVim#api#import('vim#compatible')
let s:AUTODOC = SpaceVim#api#import('dev#autodoc')
let s:AUTODOC.autoformat = 1
function! SpaceVim#dev#api#update() abort
let s:AUTODOC.begin = '^<!-- SpaceVim api list start -->$'
let s:AUTODOC.end = '^<!-- SpaceVim api list end -->$'
let s:AUTODOC.content_func = function('s:generate_content')
call s:AUTODOC.update()
endfunction
function! SpaceVim#dev#api#updateCn() abort
let s:AUTODOC.begin = '^<!-- SpaceVim api cn list start -->$'
let s:AUTODOC.end = '^<!-- SpaceVim api cn list end -->$'
let s:AUTODOC.content_func = function('s:generate_content_cn')
call s:AUTODOC.update()
endfunction
function! s:generate_content_cn() abort
let content = ['', '## 可用 APIs', '']
let content += s:api_list_cn()
let content += ['']
return content
endfunction
function! s:generate_content() abort
let content = ['', '## Available APIs', '', 'Here is the list of all available APIs, and welcome to contribute to SpaceVim.', '']
let content += s:api_list()
let content += ['']
return content
endfunction
function! s:api_list() abort
let layers = s:CMP.globpath('~/.SpaceVim/', 'docs/api/**/*.md')
let list = [
\ '| Name | Description |',
\ '| ---------- | ------------ |'
\ ]
if s:SYS.isWindows
let pattern = join(['', 'docs', 'api', ''], s:FILE.separator . s:FILE.separator)
else
let pattern = join(['', 'docs', 'api', ''], s:FILE.separator)
endif
for layer in layers
let name = split(layer, pattern)[1][:-4] . s:FILE.separator
let url = join(split(name, s:FILE.separator), '/') . '/'
let content = readfile(layer)
if len(content) > 3
let line = '| [' . join(split(name, s:FILE.separator), '#') . '](' . url . ') | ' . content[2][14:-2] . ' | '
else
let line = '| [' . join(split(name, s:FILE.separator), '#') . '](' . url . ') | can not find Description |'
endif
call add(list, line)
endfor
return list
endfunction
function! s:api_list_cn() abort
let layers = s:CMP.globpath('~/.SpaceVim/', 'docs/cn/api/**/*.md')
let list = [
\ '| 名称 | 描述 |',
\ '| ---------- | ------------ |'
\ ]
if s:SYS.isWindows
let pattern = join(['', 'docs', 'cn', 'api', ''], s:FILE.separator . s:FILE.separator)
else
let pattern = join(['', 'docs', 'cn', 'api', ''], s:FILE.separator)
endif
for layer in layers
let name = split(layer, pattern)[1][:-4] . s:FILE.separator
let url = join(split(name, s:FILE.separator), '/') . '/'
let content = readfile(layer)
if len(content) > 3
let line = '| [' . join(split(name, s:FILE.separator), '#') . '](' . url . ') | ' . content[2][14:-2] . ' | '
else
let line = '| [' . join(split(name, s:FILE.separator), '#') . '](' . url . ') | can not find Description |'
endif
call add(list, line)
endfor
return list
endfunction