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