mundschenk-at / php-typography
A PHP library for improving your web typography
Installs: 785 249
Dependents: 13
Suggesters: 0
Security: 0
Stars: 68
Watchers: 6
Forks: 6
Open Issues: 12
Requires
- php: >=7.4.0
- ext-mbstring: *
- ext-pcre: *
- masterminds/html5: ^2.5.0
Requires (Dev)
- ext-curl: *
- brain/monkey: ^2.2.0
- dealerdirect/phpcodesniffer-composer-installer: ^0.7
- mundschenk-at/phpunit-cross-version: dev-master
- phpbench/phpbench: ^0.17||^1.0@dev
- phpcompatibility/php-compatibility: ^9.0
- phpstan/extension-installer: ^1.2
- phpstan/phpstan: ^1.9
- phpstan/phpstan-mockery: ^1.1
- phpunit/phpunit: 5.*||6.*||7.*|8.*|9.*
- squizlabs/php_codesniffer: ^3
- wp-coding-standards/wpcs: ^2.0
This package is auto-updated.
Last update: 2024-09-15 19:31:40 UTC
README
A PHP library for improving your web typography:
- Hyphenation — over 50 languages supported
- Space control, including:
- widow protection
- gluing values to units
- forced internal wrapping of long URLs & email addresses
- Intelligent character replacement, including smart handling of:
- quote marks (‘single’, “double”)
- dashes ( – )
- ellipses (…)
- trademarks, copyright & service marks (™ ©)
- math symbols (5×5×5=53)
- fractions (1⁄16)
- ordinal suffixes (1st, 2nd)
- CSS hooks for styling:
- ampersands,
- uppercase words,
- numbers,
- initial quotes & guillemets.
Requirements
- PHP 7.4.0 or above
- The
mbstring
extension
Installation
The best way to use this package is through Composer:
$ composer require mundschenk-at/php-typography $ vendor/bin/update-iana.php
Basic Usage
- Create a
Settings
object and enable the fixes you want. - Create a
PHP_Typography
instance and use it to process HTML fragments (or whole documents) using your defined settings.
$settings = new \PHP_Typography\Settings(); $settings->set_hyphenation( true ); $settings->set_hyphenation_language( 'en-US' ); $typo = new \PHP_Typography\PHP_Typography(); $hyphenated_html = $typo->process( $html_snippet, $settings );
Roadmap
Please have a look at ROADMAP file for upcoming releases.
License
PHP-Typography is licensed under the GNU General Public License 2 or later - see the LICENSE file for details.