# incontext_translation

**Repository Path**: webvip/incontext_translation

## Basic Information

- **Project Name**: incontext_translation
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-08
- **Last Updated**: 2026-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# In-Context Custom Translation for Frappe Apps

A Frappe app for creating custom translations right where you see them. Work faster with in-context editing and one-click automated suggestions.

## ✨ Features

- **Automated Suggestions**: Get instant, one-click translation suggestions.
- **In-Context Editing**: Edit translations directly on the page where the text appears.
- **Quick Translation Dialog**: Instantly add or update translations with an easy-to-use popup.
- **Optional Context Support**: Control whether a translation is saved with specific context.
- **Wide Coverage**: Works with Workspace, Sidebar, Forms, and other common UI areas.
- **Multi-Language Ready**: Designed to work with any language supported by Frappe.

## 📦 Installation

1. Navigate to your Frappe Bench directory.
2. Get the app:
   ```bash
   bench get-app https://github.com/Mazen-Almortada/incontext_translation.git
   ```

3. Install the app on your site:

   ```bash
   bench --site yoursite.local install-app incontext_translation
   ```
4. Build and clear cache:

   ```bash
   bench build
   bench --site yoursite.local clear-cache
   ```

## 🚀 Demo

![Demo of Translation Mode](docs/demo.gif)

## 🔧 Configuration

**Permissions**: Only **System Manager** or **Translation Editor** roles can use this feature.

**Dependencies**: This app uses the `deep-translator` library for the translation suggestion feature.

**Customization**: You can extend the list of selectors in `translation_mode.js` to target more elements.

## 🪪 License

**MIT License**