Add readme.md
This commit is contained in:
1 parent
9630d66d18
commit
2c6b0d41b9
1 file changed
+113
@@ -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 구조 다이어그램 포함)
|
||||||
|
* 한글/영문 병기 버전
|
||||||
|
* 내부 동작 분석 섹션 추가
|
||||||
|
* 자동 재패치 설계 포함
|
||||||
|
|
||||||
|
같은 방향으로 확장해줄까?
|
||||||
Reference in new issue
Block a user