Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/intellism/vscode-comment-translate

vscode 注释翻译插件, 不干扰正常代码，方便快速阅读源码。
https://github.com/intellism/vscode-comment-translate

translate translate-comments vscode vscode-extension

Last synced: about 1 month ago
JSON representation

vscode 注释翻译插件, 不干扰正常代码，方便快速阅读源码。

Awesome Lists containing this project

README 

        
# VSCode Comment Translation Extension



This extension helps developers translate comments, strings, code hints, error messages, and variable names in their code.



![Licence](https://img.shields.io/github/license/intellism/vscode-comment-translate.svg)



## Introduction

[【中文文档】](./doc/README_ZH.md) [【日本語の文書】](./doc/README_JA.md) [【한국어】](./doc/README_KR.md)



Many excellent projects have extensive comments to help users quickly understand the code's intent. If users are not familiar with the language of the comments, it can be challenging to understand. This extension provides multiple translation scenarios to help developers comprehend and write multilingual code more easily. It supports common translation services like Google, Bing, AliCloud, and DeepL, and allows developers to add custom translation services.



![Introduction](./doc/image/Introduction.gif)



## Features



### Code Reading

The extension identifies multilingual content like comments and strings in the source code using TextMate, translates them quickly, and displays them via Hover, minimizing disruption to development.



**Hover Translation**: Move the mouse over comments, strings, or selected areas to see the translated content in a hover box. Other hover content like exceptions and code documentation are also translated and displayed.



**Immersive Reading**: Turn on immersive comment translation to automatically translate comments and display them in the document. The translated results can be shown alongside the original text or in place of it; toggle the display mode with `Ctrl+Shift+B`.

![Immersive](./doc/image/Immersive.gif)



### Translation and Replacement

The extension can translate source code content and quickly replace it in the document. For instance, translate a description and use it as a variable name; in multilingual development scenarios, translate a string and replace it in the document.



**Translate Variable Naming**: Translate the current description into English and provide various variable names to choose from, then replace the original description.

![naming](<./doc/image/full naming.gif>)



**Hover Replacement**: The hover box provides the ability to replace text with the translation result, which replaces the original content.

![hover](./doc/image/hover_image.png)



**Full Text Replacement Translation**: Supports translating and replacing strings, comments, and selected areas with one click.

![replace](./doc/image/replace.png)



### GitHub Copilot Chat Participant: @translate

  > - Requires pre-installation of the GitHub Copilot Chat extension and authorization.

  > - For GitHub Copilot users, translation is currently supported in the Chat box, but not for comments, text, etc.



This extension extends GitHub Copilot by enabling translations in the Chat box using Copilot's AI model. The target language is set by CommentTranslate. Select text in the Editor and send it to GitHub Copilot Chat for quick translation using commands.

![copilot](./doc/image/copilot.gif)



## Useful Commands



> Mac: `ctrl+shift+?` / Windows: `alt+shift+?`



The extension provides translation or replacement commands for various scenarios, with shortcuts for some common functionalities. Users can also customize shortcuts according to their habits.

- **Immersive Comment Translation**: Toggle immersive translation reading for the current document `ctrl+shift+z`

- **Immersive Display Mode**: Toggle cross-display/placeholder read mode `ctrl+shift+b`

- **Translate Variable Naming**: Translate the current descriptive word and provide named variables `ctrl+shift+n`

- **Translation and Replacement**: Translate selected content and replace it at the current location `ctrl+shift+t`

- **Copilot Quick Translation**: Translate selected content or clipboard content in GitHub Copilot Chat `ctrl+shift+y`



## Translation Services



The extension supports the following translation services:

- **Google Translate**: Built-in, free version, used by default.

  - **Note**: Requires a network connection, some users may need a proxy. If encountering network issues, it is recommended to use Bing.

- **Bing Translate**: Built-in, free version.

- **AliCloud Translate**: Built-in, requires configuration of accessKeyId & accessKeySecret.



Third-party translation services can be found by searching for `@tag:translateSource` in the plugin market. Users can choose the desired translation service through the plugin configuration or expand it by customizing the translation service. [More Links](https://github.com/intellism/vscode-comment-translate/wiki/Translation-Service)



## Common Configurations

* `commentTranslate.hover.enabled`: Enable/disable hover translation (quickly set through status)

* `commentTranslate.hover.concise`: Enable/disable concise mode. Only triggers hover translation when pressing ctrl or command

* `commentTranslate.hover.string`: Enable/disable string hover translation

* `commentTranslate.hover.content`: Enable/disable translation of hover content

* `commentTranslate.multilineMerge`: Merge multiline comments

* `commentTranslate.targetLanguage`: Translation target language, uses the local VSCode language if not set (quickly set through status)

* `commentTranslate.source`: Translation service source configuration. It is recommended to set it through commands. Supports plugin extensions for translation service sources. [example](https://github.com/intellism/deepl-translate)

* `commentTranslate.maxTranslationLength`: Maximum translation length configuration to avoid excessive charges for long character translations

* `commentTranslate.browse.enabled`: Enable/disable project immersive browsing translation function



## Support Us



If you find this extension helpful, please consider supporting us in the following ways:

- Give us a star on GitHub [intellism/vscode-comment-translate](https://github.com/intellism/vscode-comment-translate)

- Submit feedback and suggestions

- Share with your friends and colleagues