Guida alla Formattazione CJK
VMark include un insieme completo di regole di formattazione per testo cinese, giapponese e coreano. Questi strumenti aiutano a mantenere una tipografia coerente quando si mischiano caratteri CJK e latini.
Avvio Rapido
Usa Formato → Formatta Documento CJK o premi Alt + Mod + Shift + F per formattare l'intero documento.
Per formattare solo una selezione, usa Mod + Shift + F.
Regole di Formattazione
1. Spaziatura CJK-Latino
Aggiunge automaticamente spazi tra caratteri/numeri CJK e latini.
| Prima | Dopo |
|---|---|
| 学习Python编程 | 学习 Python 编程 |
| 共100个 | 共 100 个 |
| 使用macOS系统 | 使用 macOS 系统 |
2. Punteggiatura a Larghezza Intera
Converte la punteggiatura a mezza larghezza in punteggiatura a larghezza intera nel contesto CJK.
| Prima | Dopo |
|---|---|
| 你好,世界 | 你好，世界 |
| 什么? | 什么？ |
| 注意:重要 | 注意：重要 |
3. Conversione Caratteri a Larghezza Intera
Converte lettere e numeri a larghezza intera in mezza larghezza.
| Prima | Dopo |
|---|---|
| １２３４ | 1234 |
| ＡＢＣ | ABC |
4. Conversione Parentesi
Converte le parentesi a mezza larghezza in parentesi a larghezza intera quando circondano contenuto CJK.
| Prima | Dopo |
|---|---|
| (注意) | （注意） |
| [重点] | 【重点】 |
| (English) | (English) |
5. Conversione Trattini
Converte i doppi trattini in trattini CJK corretti.
| Prima | Dopo |
|---|---|
| 原因--结果 | 原因 —— 结果 |
| 说明--这是 | 说明 —— 这是 |
6. Conversione Virgolette Tipografiche
VMark usa un algoritmo di abbinamento virgolette basato su stack che gestisce correttamente:
- Apostrofi: Le contrazioni come
don't,it's,l'amourvengono preservate - Possessivi:
Xiaolai'srimane invariato - Apici: Le misure come
5'10"(piedi/pollici) vengono preservate - Decenni: Le abbreviazioni come
'90svengono riconosciute - Rilevamento contesto CJK: Le virgolette intorno al contenuto CJK ricevono virgolette curve/a forcella
| Prima | Dopo |
|---|---|
| 他说"hello" | 他说 "hello" |
| "don't worry" | "don't worry" |
| 5'10" tall | 5'10" tall |
Con l'opzione parentesi a forcella abilitata:
| Prima | Dopo |
|---|---|
| "中文内容" | 「中文内容」 |
| 「包含'嵌套'」 | 「包含『嵌套』」 |
7. Normalizzazione dei Puntini di Sospensione
Standardizza la formattazione dei puntini di sospensione.
| Prima | Dopo |
|---|---|
| 等等. . . | 等等... |
| 然后. . .继续 | 然后... 继续 |
8. Punteggiatura Ripetuta
Limita i segni di punteggiatura consecutivi (limite configurabile).
| Prima | Dopo (limite=1) |
|---|---|
| 太棒了！！！ | 太棒了！ |
| 真的吗？？？ | 真的吗？ |
9. Altre Pulizie
- Spazi multipli compressi:
多个 空格→多个 空格 - Spazi finali rimossi
- Spaziatura barre:
A / B→A/B - Spaziatura valute:
$ 100→$100
Contenuto Protetto
Il seguente contenuto non è interessato dalla formattazione:
- Blocchi di codice (```)
- Codice inline (`)
- URL dei collegamenti
- Percorsi delle immagini
- Tag HTML
- Frontmatter YAML
- Punteggiatura con escape backslash (es.
\,rimane come,)
Costrutti Tecnici
Lo Scanner di Sequenze Latine di VMark rileva e protegge automaticamente i costrutti tecnici dalla conversione della punteggiatura:
| Tipo | Esempi | Protezione |
|---|---|---|
| URL | https://example.com | Tutta la punteggiatura preservata |
user@example.com | @ e . preservati | |
| Versioni | v1.2.3, 1.2.3.4 | Punti preservati |
| Decimali | 3.14, 0.5 | Punto preservato |
| Orari | 12:30, 1:30:00 | Due punti preservati |
| Migliaia | 1,000, 1,000,000 | Virgole preservate |
| Domini | example.com | Punto preservato |
Esempio:
| Prima | Dopo |
|---|---|
| 版本v1.2.3发布 | 版本 v1.2.3 发布 |
| 访问https://example.com获取 | 访问 https://example.com 获取 |
| 温度是3.14度 | 温度是 3.14 度 |
Escape Backslash
Prefissa qualsiasi punteggiatura con \ per impedirne la conversione:
| Input | Output |
|---|---|
价格\,很贵 | 价格,很贵 (la virgola rimane a mezza larghezza) |
测试\.内容 | 测试.内容 (il punto rimane a mezza larghezza) |
Configurazione
Le opzioni di formattazione CJK possono essere configurate in Impostazioni → Lingua:
- Abilita/disabilita regole specifiche
- Imposta il limite di ripetizione della punteggiatura
- Scegli lo stile delle virgolette (standard o parentesi a forcella)
Virgolette Contestuali
Quando le Virgolette Contestuali sono abilitate (predefinito):
- Virgolette intorno al contenuto CJK → virgolette curve
"" - Virgolette intorno al contenuto puramente latino → virgolette dritte
""
Questo preserva l'aspetto naturale del testo inglese formattando correttamente il contenuto CJK.
Spaziatura tra Lettere CJK
VMark include una funzione dedicata di spaziatura tra lettere per il testo CJK che migliora la leggibilità aggiungendo una spaziatura sottile tra i caratteri.
Impostazioni
Configura in Impostazioni → Editor → Tipografia → Spaziatura tra Lettere CJK:
| Opzione | Valore | Descrizione |
|---|---|---|
| Off | 0 | Nessuna spaziatura (predefinito) |
| Sottile | 0.02em | Spaziatura appena percettibile |
| Leggera | 0.03em | Spaziatura leggera |
| Normale | 0.05em | Consigliata per la maggior parte dei casi |
| Ampia | 0.08em | Spaziatura più pronunciata |
Come Funziona
- Applica il CSS letter-spacing alle sequenze di caratteri CJK
- Esclude i blocchi di codice e il codice inline
- Funziona sia in WYSIWYG che nell'HTML esportato
- Nessun effetto sul testo latino o sui numeri
Esempio
Senza spaziatura tra lettere:
这是一段中文文字，没有任何字间距。
Con spaziatura tra lettere di 0.05em:
这 是 一 段 中 文 文 字 ， 有 轻 微 的 字 间 距 。
La differenza è sottile ma migliora la leggibilità, specialmente per i passaggi più lunghi.
Stili di Virgolette Tipografiche
VMark può convertire automaticamente le virgolette dritte in virgolette tipograficamente corrette. Questa funzione funziona durante la formattazione CJK e supporta più stili di virgolette.
Stili di Virgolette
| Stile | Virgolette Doppie | Virgolette Singole |
|---|---|---|
| Curve | "testo" | 'testo' |
| Parentesi a Forcella | 「testo」 | 『testo』 |
| Guillemets | «testo» | ‹testo› |
Algoritmo di Abbinamento Basato su Stack
VMark usa un sofisticato algoritmo basato su stack per l'abbinamento delle virgolette:
- Tokenizzazione: Identifica tutti i caratteri virgoletta nel testo
- Classificazione: Determina se ogni virgoletta è di apertura o di chiusura in base al contesto
- Rilevamento Apostrofi: Riconosce le contrazioni (don't, it's) e le preserva
- Rilevamento Apici: Riconosce le misure (5'10") e le preserva
- Rilevamento Contesto CJK: Verifica se il contenuto citato coinvolge caratteri CJK
- Pulizia Virgolette Solitarie: Gestisce le virgolette senza corrispondenza con grazia
Esempi
| Prima | Dopo (Curve) |
|---|---|
| "hello" | "hello" |
| 'world' | 'world' |
| it's | it's |
| don't | don't |
| 5'10" | 5'10" |
| '90s | '90s |
Gli apostrofi nelle contrazioni (come "it's" o "don't") vengono preservati correttamente.
Attiva/Disattiva Stile Virgolette al Cursore
Puoi cambiare rapidamente lo stile delle virgolette esistenti senza riformattare l'intero documento. Posiziona il cursore all'interno di qualsiasi coppia di virgolette e premi Shift + Mod + ' per cambiare.
Modalità semplice (predefinita): Alterna tra virgolette dritte e il tuo stile preferito.
| Prima | Dopo | Dopo ancora |
|---|---|---|
| "hello" | "hello" | "hello" |
| 'world' | 'world' | 'world' |
Modalità ciclo completo: Scorre tutti e quattro gli stili.
| Passo | Doppie | Singole |
|---|---|---|
| 1 | "testo" | 'testo' |
| 2 | "testo" | 'testo' |
| 3 | 「testo」 | 『testo』 |
| 4 | «testo» | ‹testo› |
| 5 | "testo" (ritorno all'inizio) | 'testo' |
Virgolette annidate: Quando le virgolette sono annidate, il comando alterna la coppia più interna che racchiude il cursore.
Rilevamento intelligente: Gli apostrofi (don't), gli apici (5'10") e le abbreviazioni di decennio ('90s) non vengono mai trattati come coppie di virgolette.
TIP
Passa tra la modalità semplice e quella a ciclo completo in Impostazioni → Lingua → Formattazione CJK → Modalità Alternanza Virgolette.
Configurazione
Abilita la Conversione Virgolette Tipografiche in Impostazioni → Lingua → Formattazione CJK. Puoi anche selezionare il tuo stile di virgolette preferito dal menu a discesa.
Conversione Parentesi a Forcella CJK
Quando le Virgolette a Forcella CJK sono abilitate, le virgolette curve intorno al contenuto CJK vengono automaticamente convertite in parentesi a forcella.
Caratteri Supportati
La conversione delle parentesi a forcella si attiva quando il contenuto citato contiene caratteri cinesi (CJK Unified Ideographs U+4E00–U+9FFF):
| Tipo di Contenuto | Esempio | Converte? |
|---|---|---|
| Cinese | "中文" | ✓ 「中文」 |
| Giapponese con Kanji | "日本語" | ✓ 「日本語」 |
| Solo Hiragana | "ひらがな" | ✗ rimane "ひらがな" |
| Solo Katakana | "カタカナ" | ✗ rimane "カタカナ" |
| Coreano | "한글" | ✗ rimane "한글" |
| Inglese | "hello" | ✗ rimane "hello" |
Suggerimento: Per il testo giapponese con solo Kana, usa manualmente le parentesi a forcella 「」 o includi almeno un carattere Kanji.
Paragrafo di Test
Copia questo testo non formattato in VMark e premi Alt + Mod + Shift + F per formattare:
最近我在学习TypeScript和React,感觉收获很大.作为一个developer,掌握这些modern前端技术是必须的.
目前已经完成了３个projects,代码量超过１０００行.其中最复杂的是一个dashboard应用,包含了数据可视化,用户认证,还有API集成等功能.
学习过程中遇到的最大挑战是--状态管理.Redux的概念. . .说实话有点难理解.后来换成了Zustand,简单多了!
老师说"don't give up"然后继续讲"写代码要注重可读性",我觉得很有道理.
访问https://example.com/docs获取v2.0.0版本文档,价格$99.99,时间12:30开始.
项目使用的技术栈如下:
- **Frontend**--React + TypeScript
- **Backend**--Node.js + Express
- **Database**--PostgreSQL
总共花费大约$２００美元购买了学习资源,包括书籍和online courses.虽然价格不便宜,但非常值得.Risultato Atteso
Dopo la formattazione, il testo apparirà così:
最近我在学习 TypeScript 和 React，感觉收获很大。作为一个 developer，掌握这些 modern 前端技术是必须的。
目前已经完成了 3 个 projects，代码量超过 1000 行。其中最复杂的是一个 dashboard 应用，包含了数据可视化，用户认证，还有 API 集成等功能。
学习过程中遇到的最大挑战是 —— 状态管理。Redux 的概念... 说实话有点难理解。后来换成了 Zustand，简单多了！
老师说 "don't give up" 然后继续讲 "写代码要注重可读性"，我觉得很有道理。
访问 https://example.com/docs 获取 v2.0.0 版本文档，价格 $99.99，时间 12:30 开始。
项目使用的技术栈如下：
- Frontend —— React + TypeScript
- Backend —— Node.js + Express
- Database —— PostgreSQL
总共花费大约 $200 美元购买了学习资源，包括书籍和 online courses。虽然价格不便宜，但非常值得。
Modifiche applicate:
- Spaziatura CJK-Latino aggiunta (学习 TypeScript)
- Punteggiatura a larghezza intera convertita (，。！)
- Numeri a larghezza intera normalizzati (３→3, １０００→1000, ２００→200)
- Doppi trattini convertiti in em-dash (-- → ——)
- Puntini di sospensione normalizzati (. . . → ...)
- Virgolette tipografiche applicate, apostrofo preservato (don't)
- Costrutti tecnici protetti (https://example.com/docs, v2.0.0, $99.99, 12:30)