Add readme.md

This commit is contained in:
dahyeon committed 2026-03-02 08:09:41 +00:00
1 parent 9630d66d18
commit 2c6b0d41b9
1 file changed
+113
+113
View File
@@ -0,0 +1,113 @@
# 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-mingo-fonts.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
```
* 더 기술적으로 깊게 (DOM 구조 다이어그램 포함)
* 한글/영문 병기 버전
* 내부 동작 분석 섹션 추가
* 자동 재패치 설계 포함
같은 방향으로 확장해줄까?