nystudio107/php-typography

KINGdesk PHP Typography 库改进了网页上的排版。

资助包维护!
khalwat

1.0.0 2017-10-15 23:49 UTC

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/ 目录下的文件名以了解可用的语言概述。