Инструменты пользователя

Инструменты сайта


Боковая панель

ru:plugin:typography

Это старая версия документа!


Typography Plugin

Функции

Плагин типографики расширяет разметку «ДокуВики» за счет возможностей набора текста. Тег разметки <typo> определяет свойства шрифта CSS, такие как вид шрифта, размер, толщина цвет текста. Параметр состоит из пар свойство-значение CSS (свойство: значение;), каждая пара должна быть разделена точкой с запятой (;), однако последняя может быть опущена. Вы можете использовать сокращенное короткое имя вместо полного имени свойства.

Некоторое конкретное короткое имя также доступно как тег разметки; <ff> (семейство шрифтов / имя), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (вес). Плагин типографики полностью заменяет: fontfamily, fontsize2 и fontcolor.

short name css property name description
fc color цвет текста
bg background-color цвет фона текста
fs font-size размер шрифта текста (большой или мелкий)
fw font-weight толщина шрифта (толстые или тонкие символы в тексте)
fv font-variant отображать текст маленьким шрифтом
ff font-family семейство шрифтов для текста, должно быть заключено в одинарные кавычки, если имя шрифта содержит пробелы и символы, отличные от ASCII.
lh line-height пространство между строками
ls letter-spacing дополнительный пробел между символами (в px, em и т. д.)
ws word-spacing дополнительный пробел между словами (в px, em и т. д.)
sp white-space указывает, как обрабатывается пробел (сохранить или свернуть)
va vertical-align устанавливает вертикальное выравнивание
- text-transform контролирует использование заглавных букв в тексте (заглавные, прописные или строчные)
- text-shadow добавляет тень к тексту
wf (web-font) укажите класс веб-шрифта с префиксом «wf-»

Иногда встроенные стили необходимы, когда вы создаете страницу вручную. Однако вам следует по возможности избегать их для «семантической разметки», улучшения ремонтопригодности и возможности повторного использования. Плагин wrap предоставит наиболее мощный и гибкий метод для определения атрибута класса.

Использование короткого синтаксиса с меню панели инструментов

Плагин типографики предоставляет синтаксис короткого имени (или отдельного свойства), который совместим с fontfamily, fontcolor и fontsize2. Если вы включили эти три плагина, короткий синтаксис обрабатывается соответствующими плагинами, а не этим плагином. Этот короткий синтаксис доступен через значки панели инструментов: .

Примеры / Использование

Пример одного параметра:

<typo font-size:large;>Large</typo>, 
<typo fs:x-large>Very large</typo>, 
<fs:xx-large>Huge</fs>, and 
<fs smaller>smaller</fs> size text

Example 1

Пример с несколькими параметрами:

<typo fs:larger; fw:bold; ff:serif>Bold serif</typo>, 
<fs:large; fv:small-caps>Small-caps</fs> text

Example 2

Синтаксис вложенности:

<ff:'Georgia', 'MS Serif', serif><fs:36px; lh:1.1>
There is nothing either good or bad, \\ but thinking makes it so.
</fs>\\
<fs:smaller;>//-- William Shakespeare, “Hamlet”, Act 2 scene 2//</fs></ff>

Example 3

Использование веб-шрифта

Для getting started with the Google Fonts API, вы можете добавить ссылку на таблицу стилей для запроса желаемого веб-шрифта (ов) в conf/meta.html файл, например:

conf/meta.html
<link rel="stylesheet"
      href="https://fonts.googleapis.com/css?family=Tangerine">
<style>
.wf-tangerine { font-family: Tangerine, serif; }
</style>

Затем вы можете использовать имя шрифта (например, Tangerine) в значении font-family:

<ff Tangerine; fs:48px>Making the Web Beautiful!</ff>
<wf:tangerine; fs:48px>Making the Web Beautiful!</wf>

Example 4


Поддержка рендерера

Начиная с выпуска 2014-10-13 этот плагин также поддерживает ODT export (текстовый формат открытого документа). Слева вы видите снимок экрана, сделанный с тестовой страницы типографики, открытой в браузере, с правой стороны вы видите страницу, экспортированную в ODT:

XHTML rendering ODT rendering

Как видите, в настоящее время существуют некоторые ограничения на экспорт ODT:

  • изменение размера текста в настоящее время не поддерживается Изменение размера текста поддерживается с выпуска 2015-04-02.
  • после закрытия тега типографики высотой строки начинается новый абзац. ODT поддерживает только установку высоты строки для каждого абзаца. Средство визуализации XHTML остается в той же строке после закрытия тега.
  • межсловный интервал не поддерживается форматом ODT
  • параметры пробела в настоящее время не поддерживаются

Примечание. Для функции экспорта ODT плагина типографики требуется PHP 5> = 5.3.0.


Развитие

Плагин типографики для «ДокуВики» изначально был разработан Павлом Пекарски, оригинальная версия. (v0.1101 / 2011-01-18) все еще доступен из http://treecode.pl/typography.html .

С 28 июля 2014 года код плагина перемещен в репозиторий github, чтобы обеспечить лучшую доступность для установки и возможности дальнейшей разработки. Спасибо Paweł за вашу раннюю работу и за то, что побудили меня перенести код на github. — s.sahara 2014-07-28 14:57

Функция ODT renderer - это вклад Ларса (LarsDW223)..

Журнал изменений из репозитория github

Список дел / желаний

  • добавить параметры fw: (font-weight) и sp: (white-space)
  • было бы неплохо иметь параметр text-align

Известные ошибки и проблемы

Не работает

  • Этот плагин, кажется, не работает у меня вообще . Есть ли у кого-нибудь такая же проблема? ~~lenehey 10/31/2010

* У меня из этого плагина просто фигня. dokuwiki 07.11.2010 «Муравьед». Schplurtz. 13.03.2011

  • Не могу согласиться. Первые два приведенных примера на домашней странице плагина работают должным образом. — M. С. 2011/03/14 18: 17
  • Приведенные примеры отлично работали в моем «Муравьеде» — antoniomch 4/4/2011
  • Этот плагин работает. Есть только определенные условия, в которых он будет работать. Я обнаружил, что это не работает для списков, и поэтому для его применения необходимо применить код ко всем «маркерам» в списке. Не большая проблема, но использование стилизованного форматирования работает нормально. -eiri. 13.12.2013
  • Этот плагин несовместим с плагином EditTable, который больше не работает, когда активна типография. -Ronan 2014/08/04 (с использованием версии DokuWiki Binky)
  • Плагин EditTable отлично работал с плагином Typography в DW «Ponder Stibbons». — s.sahara 2014-08-06 02:40
  • Не работает вес шрифта, проверьте и приведите пример 2015-08-07
  • Например, попробуйте
     <typo fw: 900;> Heavy text </typo> 

    LarsDW223

  • Все функции, которые я опробовал, отлично работают с dokuwiki Release 2015-08-10a «Detritus». Однако у вас должны быть эти точки с запятой. Я успешно использовал теги <typo> и <fs>.

Значок цвета шрифта отображается неправильно

  • на USB Stick-версии «Эленор Цорт» палитра цветов не отображает цвета. Решил это, удалив if-case
     // if ($ isSameHost && $ isColorSet) {
    //} 
    • Также пробовал установить плагин цвета шрифта, все то же самое. - twdreamer 2017/04/10
  • Начиная с версии 2016-05-16, значки выбора цвета не зависят от PHP GD library (gdlib) и отображаются как SVG вместо PNG, если gdlib недоступен. Надеюсь, новая версия будет работать с USB Stick-версией «ДокуВики».
    s.sahara 2017-05-16 15: 05
ru/plugin/typography.1602957291.txt.gz · Последнее изменение: 2020-10-17 19:54 — Xenus2020