nystudio107 / php-typography
KINGdesk PHP Typography 库改进了网页上的排版。
1.0.0
2017-10-15 23:49 UTC
Requires
- php: >=5.3.0
This package is auto-updated.
Last update: 2024-08-29 04:20:04 UTC
README
PhpTypography 基于 KINGdesk 的 PHP Typography 库,并扩展以支持 PSR-0 自动加载标准。
安装
使用 composer 安装 PhpTypography:
composer require debach/php-typography:dev-master
composer install
然后可以使用该类,如下所示:
$html = '...';
$typography = new Debach\PhpTypography\PhpTypography();
$prettyHtml = $typography->process($html);
PhpTypography 能做什么
PhpTypography 提升了网页上文本的排版。下表显示了处理前后的 HTML 文本示例。
更多示例,请参见 项目主页。
如何使用 PhpTypography
创建一个 Debach\PhpTypography\PhpTypography
的实例 $typography
,然后调用 $typography->process($html)
,其中 $html
是要处理的 HTML 文本。
$html = '<p>I\'m waiting for "Peter"...</p>';
$typography = new Debach\PhpTypography\PhpTypography();
$prettyHtml = $typography->process($html);
echo $prettyHtml;
以上代码将打印(软连字符未显示):
<p>I’m waiting for “Peter”…</p>
顺便说一下,如果您使用的是全栈的 Symfony 框架和 Twig,还有一个 TypographyBundle,它提供了诸如 {% typography %}
标签和 {{ text|typography }}
过滤器等小助手。
配置
有关配置的详细说明,请参见 KINGdesk 主页。
连字符取决于语言,可以使用 set_hyphenation_language($languageCode)
设置。例如,要将连字符语言设置为法语或德语,调用:
$typography->set_hyphenation_language('fr'); // set to French
$typography->set_hyphenation_language('de'); // set to German
默认语言为美式英语。请参阅 lang/
目录下的文件名以了解可用的语言概述。