Download the PHP package whitecube/laravel-string-typography without Composer
On this page you can find all versions of the php package whitecube/laravel-string-typography. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download whitecube/laravel-string-typography
More information about whitecube/laravel-string-typography
Files in whitecube/laravel-string-typography
Package laravel-string-typography
Short Description A set of simple Str & Stringable macros helping to implement typographic rules
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-string-typography
Typography Rules for Laravel
Rendering strings provided by users can result in unexpected typographic results. For instance, in most latin languages (such as french) it is recommended to add a non-breaking space in front of, amongst others, exclamation or question marks (! and ?). Most users will probably just type a regular space, which could result in an unwanted line break just before these punctuation marks.
This simple package provides a typography macro for Laravel's Str facade and Stringable instances (created using Str::of() or str()) that will take care of these typographic details.
It is also possible to enhance this package by adding your own typographic rules.
Installation
Getting started
The package's ServiceProvider and therefore its typography macro will automatically be registered upon installation. You can start using it right away:
Using Stringable instances, you can chain typography with other helper methods:
[!NOTE]
Since the transformed strings contain HTML entities (such as ), don't forget to render them using{!! !!}instead of{{ }}in your Blade templates.
Default typographic rules
| Key | Usage | Description |
|---|---|---|
non-breaking-punctuation |
Remove unwanted line breaks in front of punctuation | Replaces !, ?, :, ; with !, ?, :, ; respectively. |
hellip |
Use the correct "horizontal ellipsis" HTML entity | Replaces …, …, ..., … with …. |
Registering & removing typographic rules
By default all the previously registered typographic rules will be applied when using the new typography method. It is possible to globally remove one of them using:
Filtering typographic rules
Call a single or a few specific rules:
Call all rules except a single or a few specific unwanted rules:
🔥 Sponsorships
If you are reliant on this package in your production applications, consider sponsoring us! It is the best way to help us keep doing what we love to do: making great open source software.
Contributing
Feel free to suggest changes, ask for new features or fix bugs yourself. We're sure there are still a lot of improvements that could be made, and we would be very happy to merge useful pull requests. Thanks!
Made with ❤️ for open source
At Whitecube we use a lot of open source software as part of our daily work. So when we have an opportunity to give something back, we're super excited!
We hope you will enjoy this small contribution from us and would love to Twitter for more updates!
