Files
mingo-ime-spacing-patch/readme.md
T
2026-03-02 08:10:10 +00:00

105 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# mingo-ime-spacing-patch
Fix IME (Korean input) spacing and rendering inconsistencies in the Mingo Electron app.
This repository provides a persistent patch for Mingo's overlay-based editor
to resolve:
- Caret misalignment caused by incorrect monospace fallback
- Spacing inconsistencies during IME composition
- Unintended font fallback to GulimChe
- Visual flicker caused by syntax highlight updates during Korean input
---
## 🧠 Background
Mingo uses an overlay editor structure:
- `textarea.editor` → actual input layer (transparent text)
- `div.displayer` → syntax-highlighted rendered layer
This design enables syntax highlighting (keywords, collection names, MongoDB methods),
but it introduces issues when:
1. The expected monospace font (e.g., Roboto Mono) is not installed.
2. Windows falls back to `GulimChe`.
3. IME composition events cause highlight re-rendering.
4. Overlay rendering and text metrics diverge.
The result is:
- Character spacing distortion
- Caret misalignment
- Highlight flicker during Korean input
This patch corrects the font configuration to ensure consistent rendering.
---
## ✅ What This Patch Does
- Replaces `--font-family-mono` with:
```
"D2Coding", Consolas, monospace
```
- Replaces the default UI font with:
```
"Asta Sans", "Microsoft GothicNeo", "Segoe UI", "Malgun Gothic", sans-serif
````
- Preserves Mingo’s original overlay structure
- Keeps syntax highlighting intact
- Avoids contenteditable refactor
- Minimizes IME rendering artifacts
---
## ⚙️ Requirements
- Windows
- Node.js
- `asar` CLI tool
Install asar globally if needed:
```bash
npm install -g asar
````
---
## 🚀 Usage
Run the provided PowerShell script:
```powershell
.\patch.ps1
```
The script will:
1. Backup `app.asar`
2. Extract contents
3. Locate the largest `index-*.css`
4. Replace:
* `--font-family-mono`
* `body { font-family }`
5. Repack `app.asar`
---
## 🔄 Restore Original Version
If something breaks:
```powershell
Copy-Item "app.asar.bak-<timestamp>" "app.asar" -Force
```