# TranslationPlugin

**Repository Path**: timmy008/TranslationPlugin

## Basic Information

- **Project Name**: TranslationPlugin
- **Description**: IntelliJ IDEA/Android Studio 翻译插件，支持中英互译、单词朗读
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-09-06
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


TranslationPlugin [![GitHub release][release-img]][latest-release] [![Jetbrains Plugins][plugin-img]][plugin] [![Gitter][badge-gitter-img]][badge-gitter]
=================

[![Version](http://phpstorm.espend.de/badge/8579/version)][plugin]
[![Downloads](http://phpstorm.espend.de/badge/8579/downloads)][plugin]
[![Downloads last month](http://phpstorm.espend.de/badge/8579/last-month)][plugin]

### IntelliJ IDEA/Android Studio 翻译插件，支持中英互译、单词朗读。

![screenshots](./images/screenshots.gif)

![截图1](./images/0.png)

安装
----

- 使用**IDEA**内置插件系统:
  - <kbd>Preferences(Settings)</kbd> > <kbd>Plugins</kbd> > <kbd>Browse repositories...</kbd> > <kbd>搜索并找到"Translation"</kbd> > <kbd>Install Plugin</kbd>
- 手动:
  - 下载[`最新发布的插件包`][latest-release] -> <kbd>Preferences(Settings)</kbd> > <kbd>Plugins</kbd> > <kbd>Install plugin from disk...</kbd>

重启**IDEA**.


Actions
-------

TranslationPlugin有四个Action，它们分别是：`Translation`, `Translate`, `Translate(Inclusive)` 和 `Translate(Exclusive)`.

- **Translation:** <kbd>Alt + 0</kbd> 打开翻译对话框，默认显示在工具栏上。
  ![Translate](./images/action0.gif)
- **Translate:** <kbd>Alt + 1</kbd> 取词并翻译。如果有已选择的文本，优先从选择的文本内取词，否则默认以最大范围自动取词（该取词模式可在Settings中配置）。此Action默认显示在编辑器右键菜单上。
  ![Translate](./images/action1.gif)
- **Translate(Inclusive):** <kbd>Alt + 2</kbd> 取词并翻译。以最大范围自动取词，忽略手动选择的文本。
  ![Translate(Inclusive)](./images/action2.gif)
- **Translate(Exclusive):** <kbd>Alt + 3</kbd> 取词并翻译。自动取单个词，忽略手动选择的文本。
  ![Translate(Exclusive)](./images/action3.gif)


使用
----

1. **打开翻译对话框:**

   点击工具栏上的 ![图标](./images/2.png) 图标即可打开翻译对话框。

2. **翻译编辑器中的文本:**

   在编辑器中 <kbd>选择文本或者鼠标指向文本</kbd> > <kbd>单击鼠标右键</kbd> > <kbd>Translate</kbd>

   ![翻译](./images/3.png)

   或者使用快捷键<kbd>Alt + 1/2/3</kbd>进行翻译（Mac下默认快捷键可能无效，需要自定义快捷键），详见 **[Actions](#actions)**

3. **自定义快捷键（Mac下默认快捷键可能无效）:**

   <kbd>Preferences(Settings)</kbd> > <kbd>Keymap</kbd> > <kbd>搜索Translation</kbd>。在需要添加快捷键Action上 <kbd>右键</kbd> > <kbd>add Keyboard Shortcut...</kbd> 设置快捷键（按<kbd>ESC</kbd>键可关闭气泡和翻译对话框）。

   ![keymap](./images/keymap.png)

4. **设置有道API KEY:**

   <kbd>Preferences(Settings)</kbd> > <kbd>Other Settings</kbd> > <kbd>Translation</kbd>。 由于有道的API在查询请求数量上存在限制，如果在1小时内查询请求次数达到一定数量后将会暂时禁止查询一段时间（大概1小时）。如果很多人同时使用同一个KEY，可能会很容易就达到了限制条件，这就可以通过使用自己的KEY来避免（一人一个KEY基本足够用了）。

5. **如何获取有道API KEY？**

   <kbd>Preferences(Settings)</kbd> > <kbd>Other Settings</kbd> > <kbd>Translation</kbd> > <kbd>获取有道API KEY</kbd>

   或者 [**点击这里**](http://fanyi.youdao.com/openapi?path=data-mode) 也可申请有道API KEY。

6. **Settings(Preferences)**

   ![Settings](./images/4.png)


更新日志
--------

## [v1.3.1][v1.3.1] (2016-11-7)

- 网络请求优化，支持网络代理 [#21][#21]
- 修复：气泡重叠显示

[v1.3.1]: https://github.com/YiiGuxing/TranslationPlugin/tree/v1.3.1
[#21]:    https://github.com/YiiGuxing/TranslationPlugin/issues/21 "支持网络代理"

[完整的更新历史记录](./CHANGELOG.md)

[release-img]: https://img.shields.io/github/release/YiiGuxing/TranslationPlugin.svg
[latest-release]: https://github.com/YiiGuxing/TranslationPlugin/releases/latest
[badge-gitter-img]: https://img.shields.io/gitter/room/YiiGuxing/TranslationPlugin.svg
[badge-gitter]: https://gitter.im/TranslationPlugin/Lobby
[plugin-img]: https://img.shields.io/badge/plugin-8579-orange.svg
[plugin]: https://plugins.jetbrains.com/plugin/8579