mirror of
https://github.com/neovim/neovim.git
synced 2024-12-20 11:15:14 -07:00
b4ddee1116
runtime(doc): document pandoc compiler and enable configuring arguments
closes: vim/vim#14550
fb8f31ea7d
Co-authored-by: Konfekt <Konfekt@users.noreply.github.com>
56 lines
1.8 KiB
VimL
56 lines
1.8 KiB
VimL
" Vim compiler file
|
|
" Compiler: Pandoc
|
|
" Maintainer: Konfekt
|
|
"
|
|
" Expects output file extension, say `:make html` or `:make pdf`.
|
|
" Passes additional arguments to pandoc, say `:make html --self-contained`.
|
|
|
|
if exists("current_compiler")
|
|
finish
|
|
endif
|
|
|
|
let s:keepcpo = &cpo
|
|
set cpo&vim
|
|
|
|
let current_compiler = 'pandoc'
|
|
|
|
" As of 2024-04-08 pandoc supports the following text input formats with
|
|
" an ftplugin on Github:
|
|
let s:supported_filetypes =
|
|
\ [ 'bibtex', 'markdown', 'creole', 'json', 'csv', 'tsv', 'docbook',
|
|
\ 'xml', 'fb2', 'html', 'jira', 'tex', 'mediawiki', 'nroff', 'org',
|
|
\ 'rtf', 'rst', 't2t', 'textile', 'twiki', 'typst', 'vimwiki' ]
|
|
" .. and out of those the following are included in Vim's runtime:
|
|
" 'xml', 'tex', 'html', 'rst', 'json', 'nroff', 'markdown'
|
|
|
|
silent! function s:PandocFiletype(filetype) abort
|
|
let ft = a:filetype
|
|
if ft ==# 'pandoc'
|
|
return 'markdown'
|
|
elseif ft ==# 'tex'
|
|
return 'latex'
|
|
elseif ft ==# 'xml'
|
|
" Pandoc does not support XML as a generic input format, but it does support
|
|
" EndNote XML and Jats XML out of which the latter seems more universal.
|
|
return 'jats'
|
|
elseif ft ==# 'text' || empty(ft)
|
|
return 'markdown'
|
|
elseif index(s:supported_filetypes, &ft) >= 0
|
|
return ft
|
|
else
|
|
echomsg 'Unsupported filetype: ' . ft . ', falling back to Markdown as input format!'
|
|
return 'markdown'
|
|
endif
|
|
endfunction
|
|
execute 'CompilerSet makeprg=pandoc\ --standalone' .
|
|
\ '\ --metadata\ title=%:t:r:S' .
|
|
\ '\ --metadata\ lang=' . matchstr(&spelllang, '^\a\a') .
|
|
\ '\ --from=' . s:PandocFiletype(&filetype) .
|
|
\ '\ ' . escape(get(b:, 'pandoc_compiler_args', get(g:, 'pandoc_compiler_args', '')), ' ') .
|
|
\ '\ --output\ %:r:S.$*\ %:S'
|
|
|
|
CompilerSet errorformat="%f",\ line\ %l:\ %m
|
|
|
|
let &cpo = s:keepcpo
|
|
unlet s:keepcpo
|