Skip to content

Latest commit

 

History

History
168 lines (97 loc) · 6.53 KB

README.ru.md

File metadata and controls

168 lines (97 loc) · 6.53 KB

Типограф

Typographer

Packagist

English | Русский

В жизни каждого порядочного веб-мастера наступает момент, когда он всерьез задумывается над экранной типографикой.

С одной стороны, ему хочется, чтобы сверстанный текст хорошо смотрелся в окне браузера. А для этого нужно вместо знаков дюйма поставить нормальные кавычки («елочки» и „лапки“), поубивать лишние пробелы, в нужных местах поменять дефисы на тире, неразрывным пробелом «привязать» все короткие союзы и предлоги к следующим за ними словам и произвести кучу других операций. С другой стороны, очень не хочется расставлять все эти значки, кавычки и неразрывные пробелы вручную.

Студия Лебедева первой в интернете заявила о важности применения экранной типографики при верстке материалов. С 2000 года тексты всех создаваемых Студией Лебедева сайтов приводятся в порядок при помощи программы «Типограф». С 2002 года программа бесплатно доступна на нашем сайте.

Подробнее о принципах экранной типографики можно прочитать в § 62 «Ководства».

Вам хочется чего-то особенного от «Типографа»? Напишите нам.

Типограф: http://typograf.artlebedev.ru/

Web-сервис: http://typograf.artlebedev.ru/webservices/typograf.asmx

WSDL-описание: http://typograf.artlebedev.ru/webservices/typograf.asmx?WSDL

Установка

Установка при помощи

   composer require impeck/artlebedev-typograf

Использование и настройка

Пример использования представлен в файле example.php

   <?php

   require 'vendor/autoload.php';

   use ArtLebedevStudio\RemoteTypograf;

   $remoteTypograf = new RemoteTypograf();

Выдавать символы

Готовые символы — «а»

По умолчанию. Символы выдаются в том виде, в каком их видит в результате читатель.

   $remoteTypograf->noEntities();

Буквенными кодами &laquo;а&raquo;

Хорошо для XML, плохо для старых браузеров.

   $remoteTypograf->htmlEntities();

Числовыми кодами - &171;а&187;

Кому-то нужно. Плохо для старых браузеров.

   $remoteTypograf->xmlEntities();

Буквенными и числовыми кодами - &laquo;а&raquo; и &171;а&187;

   $remoteTypograf->mixedEntities();

Ставить переносы строк

По умолчанию false

   $remoteTypograf->br(true);

Размечать параграфы

По умолчанию false

   $remoteTypograf->p(true);

Количество тегов </br> подряд

   $remoteTypograf->nobr(3);

Кавычки первого уровня

По умолчанию « » — французские (ёлочки)

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

Кавычки второго уровня

По умолчанию „ “ — немецкие (лапки)

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

Возможные варианты кавычек

laquo raquo — французские (ёлочки) « »

bdquo ldquo — немецкие (лапки) „ “

quot quot — программистские " "

lsquo rsquo — английские одиночные ‘ ’

ldquo rdquo — английские двойные “ ”

sbquo lsquo — ‚ ‘

Авторы «Типографа»

Артемий Лебедев

всю жизнь мечтал использовать длинные тире на вебе. После нескольких лет мечтаний написал § 62 и заставил всех делать лишнюю работу. Вместе с Александром Петросяном написал версию «Типографа» на AppleScript.

Алексей Смычагин

написал свою программу, собрав все пожелания; прикрутил «Типограф» к вебу

Денис Авраамов

первый в студии поленился расставлять типографику руками и написал автоматический скрипт

Константин Жилин

помогал Авраамову

Константин Томашевич

написал свою программу, которая расставляла типографику в системе администрирования театральных сайтов

Андрей Шитов

написал XML-веб-сервис и примеры его использования на нескольких языках

Владимир Токмаков

собрал большую порцию пожеланий и переписал «Типограф» заново

Сергей Москалев

прислал коллекцию правил обработки текста после сканирования