impeck/artlebedev-typograf

PHP client for the ArtLebedevStudio.RemoteTypograf (typograf.artlebedev.ru)

2.0.1 2023-07-21 11:24 UTC

Requires

• php: >=7.4 || >=8.0
• ext-soap: *

MIT

• Andrew Shitov
• Ilya Rozhkov

README

English | Русский

There comes a time in the life of every decent webmaster when he seriously thinks about screen typography.

On the one hand, he wants the typed text to look good in the browser window. And to do this, instead of signs of the inch to put a normal quote ("herringbone" and "feet"), to kill the extra space, in the right places to change the hyphens into hyphens, unbroken space "tied" all the short conjunctions and prepositions to follow them to words and make a bunch of other operations. On the other hand, do not really want to put all these icons, quotation marks and non-breaking spaces by hand.

Lebedev Studio was the first on the Internet to declare the importance of using on-screen typography in the layout of materials. Since 2000, the texts of all websites created by Lebedev Studio are put in order with the help of "Typographer". Since 2002 the program has been available on our site for free.

You can read more about the principles of screen typography in § 62 "Guidelines".

Do you want something special from Typographer? Email us.

Typograf homepage: http://typograf.artlebedev.ru/

Web-service address: http://typograf.artlebedev.ru/webservices/typograf.asmx

WSDL-description: http://typograf.artlebedev.ru/webservices/typograf.asmx?WSDL

Installation

Installation by using

   composer require impeck/artlebedev-typograf

Usage and customization

A sample use case is given in example.php

   <?php

   require 'vendor/autoload.php';

   use ArtLebedevStudio\RemoteTypograf;

   $remoteTypograf = new RemoteTypograf();

Output characters

Ready characters — «а»

Default. The characters are output as the reader sees them as a result.

   $remoteTypograf->noEntities();

Alphabetic codes — «a»

Good for XML, bad for old browsers.

   $remoteTypograf->htmlEntities();

Numeric codes — &171;a&187;

Somebody needs. Bad for older browsers.

   $remoteTypograf->xmlEntities();

Alphabetic and numeric codes — «a» and &171;a&187;

   $remoteTypograf->mixedEntities();

Put line breaks

Default false

   $remoteTypograf->br(true);

Paragraph marking

Default false

   $remoteTypograf->p(true);

Number of tags </br> in a row

   $remoteTypograf->nobr(3);

First level quotation marks

Default « » — French

   $remoteTypograf->quotA('laquo raquo');

Second level quotation marks

Default „ “ — German

   $remoteTypograf->quotB('bdquo ldquo'); 

Possible quote options

laquo raquo — French « »

bdquo ldquo — German „ “

quot quot — Programmers " "

lsquo rsquo — English singles ‘ ’

ldquo rdquo — English double “ ”

sbquo lsquo — ' '

The authors of "Typograph"

Artemy Lebedev

all his life dreamed of using long dashes on the web. After several years of dreaming, he wrote § 62 and made everyone do the extra work. Together with Alexander Petrosyan, he wrote an AppleScript version of Typograph.

Alexey Smychagin

wrote his own program; he collected all the wishes and added the "Typograph" to the web

Denis Avrahamov

was the first guy in the studio who was too lazy to do all the typography by hand and wrote an automatic script

Konstantin Zhilin

helped Avrahamov

Konstantin Tomashevich

wrote his own program that put the typography into the theatrical web administration system

Andrei Shitov

wrote XML web-service and examples of its use in several languages

Vladimir Tokmakov

collected a lot of suggestions and rewrote "Typograph" from scratch

Sergei Moskalev

sent a collection of text processing rules after scanning