410 lines
13 KiB
Plaintext
410 lines
13 KiB
Plaintext
*Trans.txt* For NVIM v0.8.0 Last change: 2023 March 14
|
||
|
||
==============================================================================
|
||
Table of Contents *Trans-table-of-contents*
|
||
|
||
1. Trans.nvim |Trans-trans.nvim|
|
||
- 特点 |Trans-trans.nvim-特点|
|
||
- 屏幕截图 |Trans-trans.nvim-屏幕截图|
|
||
- 安装 |Trans-trans.nvim-安装|
|
||
- 配置 |Trans-trans.nvim-配置|
|
||
- 快捷键绑定 |Trans-trans.nvim-快捷键绑定|
|
||
- 高亮组 |Trans-trans.nvim-高亮组|
|
||
- 声明 |Trans-trans.nvim-声明|
|
||
- 感谢 |Trans-trans.nvim-感谢|
|
||
- 贡献 |Trans-trans.nvim-贡献|
|
||
- 待办 (画大饼) |Trans-trans.nvim-待办-(画大饼)|
|
||
|
||
==============================================================================
|
||
1. Trans.nvim *Trans-trans.nvim*
|
||
|
||
|
||
- |Trans-trans.nvim|
|
||
- |Trans-特点|
|
||
- |Trans-屏幕截图|
|
||
- |Trans-演示|
|
||
- |Trans-主题|
|
||
- |Trans-安装|
|
||
- |Trans-配置|
|
||
- |Trans-快捷键绑定|
|
||
- |Trans-高亮组|
|
||
- |Trans-声明|
|
||
- |Trans-感谢|
|
||
- |Trans-贡献|
|
||
- |Trans-待办-(画大饼)|
|
||
|
||
|
||
特点 *Trans-trans.nvim-特点*
|
||
|
||
|
||
- 使用纯 lua 编写, 速度极快
|
||
`Lazy.nvim`的记录: `➜ Trans.nvim 0.82ms`
|
||
- **可以定义快捷键读英文单词**
|
||
见 wiki
|
||
- 大部分功能可以自定义:
|
||
- 高亮
|
||
- 悬浮大小
|
||
- 排版顺序
|
||
- 弹窗大小
|
||
- `舒服窗口动画`
|
||
- etc (更多可以查看|Trans-配置|)
|
||
- **完全离线** 的单词翻译体验 (可能后面会支持在线翻译)
|
||
- 支持显示:
|
||
- 柯林斯星级
|
||
- 牛津 3000 词汇
|
||
- 中文翻译
|
||
- 英文翻译 (不是英译中, 而是用英文解释)
|
||
- 词根
|
||
- etc
|
||
- 舒服的排版和`动画`
|
||
- 支持 `normal`和 `visual`模式 > 不支持 visual-block mode
|
||
- 本地词库单词量: `430w`
|
||
|
||
|
||
屏幕截图 *Trans-trans.nvim-屏幕截图*
|
||
|
||
|
||
演示 ~
|
||
|
||
|
||
https://user-images.githubusercontent.com/107862700/213752097-2eee026a-ddee-4531-bf80-ba2cbc8b44ef.mp4
|
||
|
||
|
||
视频演示的在线查询, 查询速度取决于你的网络状况
|
||
可以打开音量查看自动读音
|
||
|
||
https://user-images.githubusercontent.com/107862700/215941500-3293c571-20a1-44e2-b202-77079f158ce9.mp4
|
||
|
||
|
||
主题 ~
|
||
|
||
|
||
如果你有更美观或者更适合的配色, 欢迎提 PR 主题配色在:
|
||
`lua/Trans/theme.lua`文件中，你只需要添加你主题的表就可以了
|
||
|
||
- `default`
|
||
- `dracula`
|
||
- `tokyonight`
|
||
|
||
|
||
安装 *Trans-trans.nvim-安装*
|
||
|
||
_安装之前, 首先需要明确本插件的依赖:_
|
||
|
||
|
||
- ECDICT <https://github.com/skywind3000/ECDICT>: 插件所用的离线单词数据库
|
||
- sqlite.lua <https://github.com/kkharji/sqlite.lua>: 操作数据库所用的库
|
||
- sqlite3: 数据库
|
||
|
||
Packer.nvim ~
|
||
|
||
>lua
|
||
use {
|
||
'JuanZoran/Trans.nvim'
|
||
run = function() require('Trans').install() end, -- 自动下载使用的本地词库
|
||
requires = { 'kkharji/sqlite.lua', },
|
||
-- 如果你不需要任何配置的话, 可以直接按照下面的方式启动
|
||
config = function ()
|
||
require'Trans'.setup{
|
||
-- your configuration here
|
||
}
|
||
end
|
||
}
|
||
<
|
||
|
||
**如果你想要使用 Packer 的惰性加载，这里有一个例子**
|
||
|
||
>lua
|
||
use {
|
||
"JuanZoran/Trans.nvim",
|
||
keys = {
|
||
{ {'n', 'x'}, 'mm' }, -- 换成其他你想用的key即可
|
||
{ {'n', 'x'}, 'mk' },
|
||
{ 'n', 'mi' },
|
||
},
|
||
run = function() require('Trans').install() end, -- 自动下载使用的本地词库
|
||
requires = { 'kkharji/sqlite.lua', },
|
||
config = function()
|
||
require("Trans").setup {} -- 启动Trans
|
||
vim.keymap.set({"n", 'x'}, "mm", '<Cmd>Translate<CR>', { desc = ' Translate' }) -- 自动判断virtual 还是 normal 模式
|
||
vim.keymap.set({'n', 'x'}, 'mk', '<Cmd>TransPlay<CR>', {desc = ' 自动发音'}) -- 自动发音选中或者光标下的单词
|
||
vim.keymap.set("n", "mi", "<Cmd>TranslateInput<CR>", { desc = ' Translate' })
|
||
end
|
||
}
|
||
<
|
||
|
||
Lazy.nvim ~
|
||
|
||
>lua
|
||
{
|
||
"JuanZoran/Trans.nvim",
|
||
keys = {
|
||
-- 可以换成其他你想映射的键
|
||
{ 'mm', mode = { 'n', 'x' }, '<Cmd>Translate<CR>', desc = ' Translate' },
|
||
{ 'mk', mode = { 'n', 'x' }, '<Cmd>TransPlay<CR>', desc = ' 自动发音' },
|
||
|
||
-- 目前这个功能的视窗还没有做好，可以在配置里将view.i改成hover
|
||
{ 'mi', '<Cmd>TranslateInput<CR>', desc = ' Translate From Input' },
|
||
},
|
||
dependencies = { 'kkharji/sqlite.lua', },
|
||
opts = {
|
||
-- your configuration there
|
||
}
|
||
}
|
||
<
|
||
|
||
**注意事项**:
|
||
|
||
|
||
- `install.sh`
|
||
- 使用了 `wget`下载词库, 安装请确保你的环境变量中存在 wget
|
||
- install.sh 下载后会自动将词库解压, 并移动到 `$HOME/.vim/dict`文件夹下
|
||
- 目前仅在 `Ubuntu22.04`的环境下测试通过
|
||
> 如果上述条件不符合, 请删掉 `run = 'install.sh'`部分, 考虑手动安装词库
|
||
> 如果上述条件满足, 仍出现问题, 欢迎在 issue 里向我反馈,我会及时尝试解决
|
||
- 下载词典的过程中, 需要能够 `流畅的访问github下载`
|
||
词库文件压缩包大小为: **281M** 解压缩后的大小大概为: 1.2G
|
||
- 安装后如果不能正常运行, 请尝试检查一下问题:
|
||
- 本机是否已经安装了 `sqlite3`
|
||
> Linux 下安装:
|
||
> `sudo pacman -S sqlite # Arch`
|
||
> `sudo apt-get install sqlite3 libsqlite3-dev # Ubuntu`
|
||
后续会增加 `healthcheck` 进行检查
|
||
- **auto_play** 使用步骤:
|
||
linux 只需要安装`festival` sudo apt-get install festival festvox-kallpc16k
|
||
**如果你想要设置音色，发音可以访问:** Festival 官方
|
||
<https://www.cstr.ed.ac.uk/projects/festival/morevoices.html>
|
||
可以选择英音、美音、男声、女声
|
||
其他操作系统
|
||
- 需要确保安装了`nodejs`
|
||
- 进入插件的`tts`目录运行`npm install`
|
||
> 如果`install`运行正常则自动安装，如果安装失败，请尝试手动安装
|
||
- `title`的配置，只对`neovim 0.9+`版本有效
|
||
|
||
Festival配置(仅针对linux用户) ~
|
||
|
||
|
||
- 配置文件
|
||
- 全局配置: `/usr/share/festival/siteinit.scm`
|
||
- 用户配置: `~/.festivalrc`
|
||
- 更改声音
|
||
- 在 festival 的 voices 文件内建立自己的文件夹
|
||
一般其默认配置目录在`/usr/share/festival/voices`
|
||
示例:
|
||
`sudo mkdir /usr/share/festival/voices/my_voices`
|
||
- 下载想要的 voices 文件并解压
|
||
可能需要
|
||
- 试听在这里 <https://www.cstr.ed.ac.uk/projects/festival/morevoices.html>)
|
||
- 下载在这里 <http://festvox.org/packed/festival/2.5/voices/>)
|
||
> 假设下载的文件在`Downloads`文件夹, 下载的文件为:`festvox_cmu_us_aew_cg.tar.gz`
|
||
示例:
|
||
`cd ~/Downloads && tar -xf festvox_cmu_us_aew_cg.tar.gz`
|
||
- 将音频文件拷贝到 festival 文件夹 示例:
|
||
`sudo cp -r festival/lib/voices/us/cmu_us_aew_cg/
|
||
/usr/share/festival/voices/my_voices/`
|
||
- 在配置文件中设置默认的声音 示例:
|
||
加入`(set! voice_default voice_cmu_indic_hin_ab_cg)`到配置文件
|
||
- 安装完成
|
||
- 相关说明网站 > 可能需要
|
||
- wiki <https://archlinux.org/packages/community/any/festival-us/> 查看更多详细配置
|
||
- 官方网站 <http://festvox.org/dbs/index.html>
|
||
- 用户手册 <http://www.festvox.org/docs/manual-2.4.0/festival_toc.html>
|
||
|
||
|
||
配置 *Trans-trans.nvim-配置*
|
||
|
||
>lua
|
||
require'Trans'.setup {
|
||
view = {
|
||
i = 'float',
|
||
n = 'hover',
|
||
v = 'hover',
|
||
},
|
||
hover = {
|
||
width = 37,
|
||
height = 27,
|
||
border = 'rounded',
|
||
title = vim.fn.has('nvim-0.9') == 1 and {
|
||
{ '', 'TransTitleRound' },
|
||
{ ' Trans', 'TransTitle' },
|
||
{ '', 'TransTitleRound' },
|
||
} or nil,
|
||
keymap = {
|
||
pageup = '[[',
|
||
pagedown = ']]',
|
||
pin = '<leader>[',
|
||
close = '<leader>]',
|
||
toggle_entry = '<leader>;',
|
||
play = '_',
|
||
},
|
||
animation = {
|
||
-- open = 'fold',
|
||
-- close = 'fold',
|
||
open = 'slid',
|
||
close = 'slid',
|
||
interval = 12,
|
||
},
|
||
auto_close_events = {
|
||
'InsertEnter',
|
||
'CursorMoved',
|
||
'BufLeave',
|
||
},
|
||
auto_play = true,
|
||
timeout = 2000,
|
||
spinner = 'dots', -- 查看所有样式: /lua/Trans/util/spinner
|
||
-- spinner = 'moon'
|
||
},
|
||
order = { -- only work on hover mode
|
||
'title',
|
||
'tag',
|
||
'pos',
|
||
'exchange',
|
||
'translation',
|
||
'definition',
|
||
},
|
||
icon = {
|
||
star = '',
|
||
notfound = ' ',
|
||
yes = '✔',
|
||
no = '',
|
||
-- --- char: ■ | □ | ▇ | ▏ ▎ ▍ ▌ ▋ ▊ ▉ █
|
||
-- --- ◖■■■■■■■◗▫◻ ▆ ▆ ▇⃞ ▉⃞
|
||
cell = '■',
|
||
-- star = '⭐',
|
||
-- notfound = '❔',
|
||
-- yes = '✔️',
|
||
-- no = '❌'
|
||
},
|
||
theme = 'default',
|
||
dir = vim.fn.expand('$HOME/.vim/dict'),
|
||
-- float = {
|
||
-- width = 0.8,
|
||
-- height = 0.8,
|
||
-- border = 'rounded',
|
||
-- keymap = {
|
||
-- quit = 'q',
|
||
-- },
|
||
-- animation = {
|
||
-- open = 'fold',
|
||
-- close = 'fold',
|
||
-- interval = 10,
|
||
-- },
|
||
-- tag = {
|
||
-- wait = '#519aba',
|
||
-- fail = '#e46876',
|
||
-- success = '#10b981',
|
||
-- },
|
||
-- },
|
||
}
|
||
<
|
||
|
||
|
||
快捷键绑定 *Trans-trans.nvim-快捷键绑定*
|
||
|
||
**示例:**
|
||
|
||
|
||
示例中展示, 将`mm`映射成快捷键
|
||
>lua
|
||
vim.keymap.set({'n', 'x'}, 'mm', '<Cmd>Translate<CR>')
|
||
vim.keymap.set({'n', 'x'}, 'mk', '<Cmd>TransPlay<CR>') -- 自动发音选中或者光标下的单词
|
||
vim.keymap.set('n', 'mi', '<Cmd>TranslateInput<CR>')
|
||
<
|
||
|
||
|
||
高亮组 *Trans-trans.nvim-高亮组*
|
||
|
||
|
||
默认定义
|
||
>lua
|
||
{
|
||
TransWord = {
|
||
fg = '#7ee787',
|
||
bold = true,
|
||
},
|
||
TransPhonetic = {
|
||
link = 'Linenr'
|
||
},
|
||
TransTitle = {
|
||
fg = '#0f0f15',
|
||
bg = '#75beff',
|
||
bold = true,
|
||
},
|
||
TransTitleRound = {
|
||
fg = '#75beff',
|
||
},
|
||
TransTag = {
|
||
fg = '#e5c07b',
|
||
},
|
||
TransExchange = {
|
||
link = 'TransTag',
|
||
},
|
||
TransPos = {
|
||
link = 'TransTag',
|
||
},
|
||
TransTranslation = {
|
||
link = 'TransWord',
|
||
},
|
||
TransDefinition = {
|
||
link = 'Moremsg',
|
||
},
|
||
TransWin = {
|
||
link = 'Normal',
|
||
},
|
||
TransBorder = {
|
||
link = 'FloatBorder',
|
||
},
|
||
TransCollins = {
|
||
fg = '#faf743',
|
||
bold = true,
|
||
},
|
||
TransFailed = {
|
||
fg = '#7aa89f',
|
||
},
|
||
}
|
||
<
|
||
|
||
|
||
声明 *Trans-trans.nvim-声明*
|
||
|
||
|
||
- 本插件词典基于ECDICT <https://github.com/skywind3000/ECDICT>
|
||
|
||
|
||
感谢 *Trans-trans.nvim-感谢*
|
||
|
||
|
||
- ECDICT <https://github.com/skywind3000/ECDICT> 本地词典的提供
|
||
- sqlite.lua <https://github.com/kharji/sqlite.lua> 数据库访问
|
||
- T.vim <https://github.com/sicong-li/T.vim> 灵感来源
|
||
|
||
|
||
贡献 *Trans-trans.nvim-贡献*
|
||
|
||
|
||
更新比较频繁, 文档先鸽了 如果你想要参加这个项目,
|
||
可以提 issue, 我会把文档补齐
|
||
|
||
待办 (画大饼) *Trans-trans.nvim-待办-(画大饼)*
|
||
|
||
|
||
- ☒ 多风格样式查询
|
||
- ☒ 重新录制屏幕截图示例
|
||
- ☒ 快捷键定义
|
||
- ☒ 自动读音
|
||
- ☐ 变量命名的支持
|
||
- ☐ 历史查询结果保存
|
||
- ☐ 在线多引擎异步查询
|
||
- ☐ `句子翻译` | `中翻英` 的支持
|
||
|
||
==============================================================================
|
||
2. Links *Trans-links*
|
||
|
||
1. *default*: ./theme/default.png
|
||
2. *dracula*: ./theme/dracula.png
|
||
3. *tokyonight*: ./theme/tokyonight.png
|
||
|
||
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
|
||
|
||
vim:tw=78:ts=8:noet:ft=help:norl:
|