外掛說明
Georgian Hyphenation inserts soft hyphens (U+00AD) into Georgian text on your site, so browsers can break long Georgian words correctly at line ends — clean justified paragraphs without ragged edges or stretched spacing.
How it works
- A phonetic algorithm built on Georgian syllable structure (vowel detection, harmonic consonant clusters, gemination) finds the valid break points.
- A bundled dictionary of irregular words overrides the algorithm where Georgian orthography is unpredictable.
- Both the engine and the dictionary ship inside the plugin and are served from your own site — the plugin makes no external requests and loads nothing from CDNs.
Important: hyphenation is opt-in per container
The plugin only hyphenates text inside containers you have selected — it is an allow list, not a sweep of the whole page. Presets are included for standard WordPress content, the block editor, Elementor, Divi, Beaver Builder, WPBakery, Bricks and Oxygen.
If some text on your site is not hyphenated, that container is simply not on the list. Themes, custom widgets and third-party plugins use class names no plugin can know in advance. Right-click the text, choose Inspect, and add the containing element’s class under Custom CSS selectors. Nothing is broken — it just has not been pointed at yet.
Features
- Works with any theme — target content with CSS selectors.
- Presets for the block editor (Gutenberg), Elementor, Divi, Beaver Builder, WPBakery, Bricks and Oxygen, plus lists, quotes, tables and captions. None of them are required; a preset for a builder you do not use matches nothing.
- Heading and title hyphenation is a single toggle, off by default — some people want it, some do not.
- Watches for dynamically loaded content (AJAX, Elementor popups, infinite scroll) and hyphenates it too.
- Optional automatic justification of processed containers.
- Configurable minimum characters before/after a break.
- Compound words keep their hyphens; already-hyphenated text is sanitized before processing, so re-processing is always safe.
- Skips code blocks, forms, and editable content automatically.
The same engine is available for developers as an npm and PyPI package (georgian-hyphenation).
螢幕擷圖
安裝方式
- Upload the plugin to
/wp-content/plugins/georgian-hyphenation/, or install it through the WordPress plugins screen. - Activate the plugin.
- Open the Georgian Hyphenation menu in the admin sidebar (also reachable from the toolbar and the Settings link on the Plugins screen) and choose which containers to process. The defaults cover standard post content and the common Elementor text widgets.
常見問題集
-
Does this plugin call any external services?
-
No. The hyphenation engine and the exception dictionary are bundled with the plugin and served from your own site.
-
Does it require Elementor?
-
No. Elementor widget presets are provided for convenience, but the plugin works with any theme via CSS selectors.
-
Will it change my stored content?
-
No. Hyphenation happens in the visitor’s browser at render time. Your posts and pages in the database are never modified, and the plugin stands aside inside the Elementor editor and the Customizer.
-
Some of my text is not hyphenated. Why?
-
Because that container is not on the allow list. The plugin hyphenates only the containers selected on its settings screen, and custom or third-party widgets use class names it cannot know in advance — a common example is a widget that renders its excerpt in a
divrather than ap.Right-click the text that is not hyphenated, choose Inspect, find the element wrapping it, and add its class (for example
.my-widget-text) under Custom CSS selectors. The currently active selector list is shown on the same screen so you can confirm the result. -
Why don’t headings and titles get hyphenated?
-
Because the “Headings (h1–h6)” preset is off by default. Turn it on and titles are hyphenated everywhere, including headings sitting inside other content.
It is off by default for two reasons: hyphenated headings are a matter of taste, and headings are where sites use display fonts — the fonts most likely to draw the soft hyphen as a visible dash. Turn it on, then look at a long title on a narrow screen. If the dashes appear mid-word, that font is the problem; switch it off again or change the font.
-
I saw dashes inside words that are not at line ends. Why?
-
The active font draws the soft hyphen (U+00AD) as a visible glyph instead of hiding it — a font bug, most common in decorative display fonts. Switch off the preset covering that text (usually Headings) or change the font.
This cannot be detected automatically. Browsers strip soft hyphens during text shaping, so the character measures exactly zero width in every font whether or not the font would draw it — there is nothing for the plugin to test, which is why this is a setting rather than something automatic.
-
Why do copied texts sometimes contain invisible characters?
-
Soft hyphens (U+00AD) are invisible break hints. Some applications preserve them when text is copied from a page. The engine strips its own hyphens before re-processing, and search engines handle soft hyphens correctly.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
3.1.0
- Works with every page builder, not just Elementor. New presets for the block editor (Gutenberg), Divi, Beaver Builder, WPBakery, Bricks and Oxygen, plus one for ordinary prose elements (lists, quotes, tables, captions). Presets for builders you do not have installed match nothing, so they are all enabled by default.
- Heading hyphenation is now one clear toggle. The old “Skip headings” option has become a “Headings (h1–h6)” preset alongside the others (off by default). It now also covers headings nested inside other matched content, which the previous option did not.
- Documented clearly, on the settings screen and here, that hyphenation is an allow list: text that is not hyphenated simply has a container that is not on the list, and the fix is to add its class under Custom CSS selectors.
3.0.0
- Complete rebuild for the WordPress.org directory.
- The hyphenation engine (v2.3.0) and the exception dictionary are now bundled with the plugin — previously both loaded from an external CDN at runtime.
- New settings screen on its own top-level admin menu (Settings API, single option), a toolbar shortcut that shows the current on/off state, and a Settings link on the Plugins screen.
- Dynamically added content inside already-processed containers is now hyphenated too (per-node tracking).
- Justification applied via a CSS class instead of inline styles, so themes can override it.
- Code blocks, forms, and editable regions are skipped.
- Old settings are migrated automatically; options are removed on uninstall.
- Headings (h1–h6) are skipped by default — some display fonts draw soft hyphens as visible dashes inside heading words. A new “Skip headings” toggle controls this; the Elementor Heading preset (now off by default) overrides it.
- Engine fixes: punctuation is preserved around dictionary matches; no break is inserted next to a compound-word hyphen.
2.2.7
- Hybrid engine v2.2.7 with chainable configuration and dictionary support (CDN-based).