README.md

vim-translator

Asynchronou translating plugin for Vim/Neovim

Installation

Plug 'voldikss/vim-translator'

Features

• Asynchronou translating
• Floatwin(NeoVim) & popup(Vim8) support
• Multiple engines/languages available
• Allow to save and export translation history
• Proxy available(http, socks4, socks5)
• Doesn't need appid/appkey

Configuration

g:translator_target_lang

Target language

• Available: Please refer to Supported languages for every engine

• Default: 'zh'

g:translator_default_engines

• Available: 'bing', 'ciba', 'google', 'youdao'.

• Default: ['ciba', 'youdao'] if g:translator_target_lang is 'zh', otherwise ['google', 'bing']

g:translator_proxy_url

i.e. let g:translator_proxy_url = 'socks5://127.0.0.1:1080'

• Default: v:null

g:translator_history_enable

• Default: v:false

g:translator_window_max_width

Max width value of the popup/floating window

• Default: 0.6*&columns

g:translator_window_max_height

Max height value of popup/floating window

• Default: 0.6*&lines

g:translator_window_borderchars

• Default: ['─', '│', '─', '│', '┌', '┐', '┘', '└']

g:translator_window_border_highlight

• Available: see :help group-name and :help highlight-groups

• Default: 'NormalFloat'

Key Mappings

This plugin doesn't supply default mappings.

""" Example configuration
" Echo translation in the cmdline
nmap <silent> <Leader>t <Plug>Translate
vmap <silent> <Leader>t <Plug>TranslateV
" Display translation in a window
nmap <silent> <Leader>w <Plug>TranslateW
vmap <silent> <Leader>w <Plug>TranslateWV
" Replace the text with translation
nmap <silent> <Leader>r <Plug>TranslateR
vmap <silent> <Leader>r <Plug>TranslateRV

Once the translation window is opened, type <Leader>w again to jump into it and again to jump back

Commands

:Translate [-e engines] [-w word] [-l to_lang]

Translate the word to the target language to_lang with engine, echo the result in the cmdline

If no engines, use g:translator_default_engines

If no word, use the word under the cursor

If no to_lang, use g:translator_target_lang

:TranslateW [-e engines] [-w word] [-l to_lang]

The same as :Translate..., display the translation in a window

:TranslateR [-e engines] [-w word] [-l to_lang]

The same as :Translate..., replace the current word with the translation

:TranslateH

Export the translation history

Example:

:TranslateW -w test -e bing youdao -l zh

Highlight

Here are the default highlight links. To customize, use hi link

hi def link TranslatorQuery             Identifier
hi def link TranslatorPhonetic          Type
hi def link TranslatorParaphrase        Statement
hi def link TranslatorExplain           Statement
hi def link TranslatorDelimiter         Special

Known bugs

Can not translate sentences(which has spaces among words) in Vim8

References

• dict.vim
• translator

License

MIT