{"id":17046608,"url":"https://github.com/sebobo/shel.neos.hyphens","last_synced_at":"2026-01-17T23:30:38.166Z","repository":{"id":34898653,"uuid":"180739398","full_name":"Sebobo/Shel.Neos.Hyphens","owner":"Sebobo","description":"CKEditor plugin to insert hyphens \u0026 non-breaking spaces in Neos CMS","archived":false,"fork":false,"pushed_at":"2024-03-12T08:55:28.000Z","size":2511,"stargazers_count":20,"open_issues_count":4,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-26T10:04:18.943Z","etag":null,"topics":["hacktoberfest","insert-hyphens","nbsp","neos-cms","soft-hyphens"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sebobo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"patreon":"shelzle","github":"sebobo"}},"created_at":"2019-04-11T07:34:20.000Z","updated_at":"2024-06-11T15:59:41.000Z","dependencies_parsed_at":"2024-03-12T10:04:15.733Z","dependency_job_id":null,"html_url":"https://github.com/Sebobo/Shel.Neos.Hyphens","commit_stats":{"total_commits":56,"total_committers":9,"mean_commits":6.222222222222222,"dds":0.3392857142857143,"last_synced_commit":"2f3f738bd1d66419ae185e34e9830e231ca112de"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sebobo%2FShel.Neos.Hyphens","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sebobo%2FShel.Neos.Hyphens/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sebobo%2FShel.Neos.Hyphens/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sebobo%2FShel.Neos.Hyphens/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sebobo","download_url":"https://codeload.github.com/Sebobo/Shel.Neos.Hyphens/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248589269,"owners_count":21129578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","insert-hyphens","nbsp","neos-cms","soft-hyphens"],"created_at":"2024-10-14T09:46:52.259Z","updated_at":"2026-01-17T23:30:38.102Z","avatar_url":"https://github.com/Sebobo.png","language":"JavaScript","funding_links":["https://patreon.com/shelzle","https://github.com/sponsors/sebobo","https://www.patreon.com/shelzle"],"categories":[],"sub_categories":[],"readme":"# Hyphens CKEditor5 plugin for Neos CMS\n\n[![Latest Stable Version](https://poser.pugx.org/shel/neos-hyphens/v/stable)](https://packagist.org/packages/shel/neos-hyphens)\n[![Total Downloads](https://poser.pugx.org/shel/neos-hyphens/downloads)](https://packagist.org/packages/shel/neos-hyphens)\n[![License](https://poser.pugx.org/shel/neos-hyphens/license)](https://packagist.org/packages/shel/neos-hyphens)\n\n## Introduction\n\nThis package provides a button to insert soft hyphens and non-breaking spaces for the inline editor in Neos CMS.\n\nMany browsers support some kind of hyphenation via CSS, but it doesn't work reliably on all systems\nand not with all languages. See the [CanIuse](https://caniuse.com/#feat=css-hyphens) table for details.\n\nTherefore this package provides a manual way to insert them. You should be careful with using the\nCSS-based hyphenation in combination with the manual hyphens as results can be unexpected.\n\nIt's compatible with Neos CMS 4.3, 5, 7 and 8 but only the active Neos LTS versions receive new bug fixes.\n\n## Example\n\nIn the backend, this plugin will add the option to add soft hyphens. They will look like this while editing:\n\n![Visible hyphens while editing](Documentation/neos-backend-hyphens.jpg)\n\nAnd in the frontend will convert this:\n\n![Unwanted hyphenation without soft hyphens](Documentation/neos-frontend-before.jpg)\n\nInto this:\n\n![Expected hyphenation](Documentation/neos-frontend-after.jpg)\n\nAnd in action:\n\n![Expected hyphenation](Documentation/example.gif)\n\n## Advantages\n\n* Your editors gain control over word breaks.\n* Stores the special character in the database with their UTF8 representation, which the browser interprets as `\u0026shy;`.\n* You don't need other characters which you replace with correct characters in the frontend.\n* Should work fine with Elasticsearch and other search engines.\n\n### Planned features\n\nSee [enhancement issue list](https://github.com/Sebobo/Shel.Neos.Hyphens/issues?utf8=✓\u0026q=is%3Aissue+label%3Aenhancement+).\n\n## Installation\n\nRun this in your site package\n\n```bash\ncomposer require --no-update shel/neos-hyphens\n```\n\nThen run `composer update` in your project directory.\n\n## How to use\n\n### Hyphen\n\nEnable it for a node with editable text like this:\n\n```yaml\n'Neos.NodeTypes:Text':\n  properties:\n    text:\n      ui:\n        inline:\n          editorOptions:\n            hyphens: true\n```\n\nThis will add a new button to insert a soft hyphen. As an alternative, you can use the shortcut `Ctrl + Shift + -` to add a new soft hyphen. To change the shortcut keys, have a look at the [Settings.yaml](Configuration/Settings.yaml#L12) file.\n\n### Non-breaking space\n\nEnable it for a node with editable text like this:\n\n```yaml\n'Neos.NodeTypes:Text':\n  properties:\n    text:\n      ui:\n        inline:\n          editorOptions:\n            nbsp: true\n```\n\nThis will add a new button to insert a non-breaking space.\n\n## Customization\n\n### Hyphen \u0026 non-breaking space styling in the backend\n\nYou can provide your own styling by referencing your own stylesheet.\nSee the file `Override.Page.fusion` on how the default styling is included.\n\nYou can either override the configuration from your own package and just use your stylesheet\nor you can add yours and use both.\n\n## Contributions\n\nContributions are very welcome!\n\nPlease create detailed issues and PRs.\n\n**If you use this package and want to support or speed up it's development, [get in touch with me](mailto:hyphens@helzle.it).**\n\nOr you can also support me directly via [patreon](https://www.patreon.com/shelzle).\n\n## License\n\nSee [License](./LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebobo%2Fshel.neos.hyphens","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsebobo%2Fshel.neos.hyphens","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebobo%2Fshel.neos.hyphens/lists"}