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

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


ru:plugin:typography

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
Следующая версия справа и слева
ru:plugin:typography [2020-10-17 19:59]
Dr-Yukon шапочка!
ru:plugin:typography [2020-10-20 17:13] (текущий)
Dr-Yukon
Строка 1: Строка 1:
-====== Плагин Typography ======+====== Typography Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description: Обширные возможности стилизации текста с помощью таких CSS-правил, как шрифт, размер, жирность и цвет текста.+description: Обширные возможности стилизации текста с помощью таких CSS-правил, как тип шрифта, размер, толщина и цвет текста.
 author     : Pawel Piekarski, Satoshi Sahara author     : Pawel Piekarski, Satoshi Sahara
 email      : sahara.satoshi@gmail.com email      : sahara.satoshi@gmail.com
Строка 13: Строка 13:
 tags       : style, typography, fonts tags       : style, typography, fonts
  
-downloadurl: https://github.com/ssahara/dw-plugin-typography/archive/master.zip+downloadurl: https://github.com/ssahara/dw-plugin-typography/zipball/master
 bugtracker : https://github.com/ssahara/dw-plugin-typography/issues bugtracker : https://github.com/ssahara/dw-plugin-typography/issues
 sourcerepo : https://github.com/ssahara/dw-plugin-typography sourcerepo : https://github.com/ssahara/dw-plugin-typography
Строка 24: Строка 24:
 ===== Функции ===== ===== Функции =====
  
-Плагин типографики расширяет разметку «ДокуВики» за счет возможностей набора текста. Тег разметки <typo> определяет свойства шрифта CSS, такие как вид шрифта, размер, толщина цвет текста. Параметр состоит из пар свойство-значение CSS (свойство: значение;), каждая пара должна быть разделена точкой с запятой (;), однако последняя может быть опущена. Вы можете использовать сокращенное короткое имя вместо полного имени свойства.+Плагин Typography расширяет разметку «ДокуВики» за счет возможностей набора текста. Парный тег разметки <typo </typo> включает в себя в качестве параметров CSS-правила, такие как тип шрифта, размер, толщина и цвет текста. Аналогично CSS-синтаксису параметры состоят из пар "свойство:значение", отделяемых друг от друга точкой с запятой (;), однако последняя в списке может быть опущена. Между тегом и его параметрами ставится один пробел, после точки с запятой также можно в эстетических целях добавлять пробел. Вместо полного имени свойства можно использовать сокращённоеЗначения поддерживают любые CSS-единицы, включая словарные (px, em, %, x-small и пр.)
  
-Некоторое конкретное короткое имя также доступно как тег разметки; <ff> (семейство шрифтов / имя), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (вес). Плагин типографики полностью заменяет: fontfamilyfontsize2 и fontcolor.+Некоторые сокращения сами доступны как парные теги, например, <ff> (тип шрифта), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (толщина). В качестве разделителя можно использовать как двоеточие, так и пробел. За счёт полного совпадения функционала и синтаксиса плагин Typography свободно, без правок статей может заменить плагины FontFamilyFontSize2 и FontColor.
  
- +^  Короткое имя  CSS-cвойство Описание 
-^  short name  css property name description +|  ''fc''  | color             | цвет шрифта | 
-|  ''fc''  | color             | цвет текста | +|  ''bg''  | background-color  | цвет фона шрифта | 
-|  ''bg''  | background-color  | цвет фона текста | +|  ''fs''  | font-size         | размер шрифта |
-|  ''fs''  | font-size         | размер шрифта текста (большой или мелкий) |+
 |  ''fw''  | font-weight       | толщина шрифта (толстые или тонкие символы в тексте) | |  ''fw''  | font-weight       | толщина шрифта (толстые или тонкие символы в тексте) |
-|  ''fv''  | font-variant      | отображать текст маленьким шрифтом +|  ''fv''  | font-variant      | капитель (уменьшенные прописные буквы) 
-|  ''ff''  | font-family       | семейство шрифтов для текста, должно быть заключено в одинарные кавычки, если имя шрифта содержит пробелы и символы, отличные от ASCII. +|  ''ff''  | font-family       | семейство шрифтов (если содержит пробелы и символыотличные от ASCII - должно быть заключено в одинарные кавычки
-|  ''lh''  | line-height       | пространство между строками | +|  ''lh''  | line-height       | пространство между строками (интерлиньяж) 
-|  ''ls''  | letter-spacing    | дополнительный пробел между символами (в px, em и т. д.) | +|  ''ls''  | letter-spacing    | пространство между символами (апрош или интерлеттраж) | 
-|  ''ws''  | word-spacing      | дополнительный пробел между словами (в px, em и т. д.) |+|  ''ws''  | word-spacing      | пространство между словами (спейс) |
 |  ''sp''  | white-space       | указывает, как обрабатывается пробел (сохранить или свернуть) | |  ''sp''  | white-space       | указывает, как обрабатывается пробел (сохранить или свернуть) |
-|  ''va''  | vertical-align    | устанавливает вертикальное выравнивание | +|  ''va''  | vertical-align    | вертикальное выравнивание | 
-|  -       | text-transform    | контролирует использование заглавных букв в тексте (заглавные, прописные или строчные)| +|  -       | text-transform    | режим заглавных букв в тексте (заглавные, прописные или строчные)| 
-|  -       | text-shadow       добавляет тень к тексту +|  -       | text-shadow       | тень у текста 
-|  ''wf''  | (web-font)        | укажите класс веб-шрифта с префиксом "wf-" |+|  ''wf''  | (web-font)        | класс веб-шрифта (с префиксом "wf-"|
  
-Иногда встроенные стили необходимы, когда вы создаете страницу вручную. Однако вам следует по возможности избегать их для «семантической разметки», улучшения ремонтопригодности и возможности повторного использования. Плагин [[plugin: wrap | wrap]] предоставит наиболее мощный и гибкий метод для определения атрибута класса.+Иногда встроенные стили необходимы, когда вы создаете страницу вручную. Однако вам следует по возможности избегать их для «семантической разметки», улучшения ремонтопригодности и возможности повторного использования. Плагин [[plugin:wrap]] предоставляет наиболее мощный и гибкий метод для определения атрибута класса.
  
 ==== Использование короткого синтаксиса с меню панели инструментов ==== ==== Использование короткого синтаксиса с меню панели инструментов ====
  
-Плагин типографики предоставляет синтаксис короткого имени (или отдельного свойства), который совместим с [[plugin: fontfamily]], [[plugin: fontcolor]] и [[plugin: fontsize2]]. Если вы включили эти три плагина, короткий синтаксис обрабатывается соответствующими плагинами, а не этим плагином. Этот короткий синтаксис доступен через значки панели инструментов: +Плагин Typography предоставляет синтаксис короткого имени (или отдельного свойства), который совместим с [[plugin:fontfamily]], [[plugin:fontcolor]] и [[plugin:fontsize2]]. Если вы включили эти три плагина, короткий синтаксис обрабатывается соответствующими плагинами, а не этим плагином. Этот короткий синтаксис доступен через значки панели инструментов: 
-{{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontfamily/picker.png}} {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontcolor/picker.png}} {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontsize/picker.png}}.+{{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontfamily/picker.png}} 
 +{{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontcolor/picker.png}} 
 +{{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/images/fontsize/picker.png}}.
  
 ===== Примеры / Использование ===== ===== Примеры / Использование =====
  
-** Пример одного параметра: **+**Пример одного параметра:**
  
 <file txt> <file txt>
Строка 65: Строка 66:
 {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example1.png|Example 1}} {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example1.png|Example 1}}
  
-** Пример с несколькими параметрами: **+**Пример с несколькими параметрами:**
  
 <file txt> <file txt>
Строка 74: Строка 75:
 {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example2.png|Example 2}} {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example2.png|Example 2}}
  
-** Синтаксис вложенности: **+**Синтаксис вложенности:**
  
 <file txt> <file txt>
Строка 85: Строка 86:
 {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example3.png|Example 3}} {{https://raw.githubusercontent.com/ssahara/dw-plugin-typography/master/example/typography-example3.png|Example 3}}
  
-** Использование веб-шрифта **+**Использование веб-шрифта**
  
-Для [[https://developers.google.com/fonts/docs/getting_started|getting started with the Google Fonts API]],  +Для [[https://developers.google.com/fonts/docs/getting_started|начала работы с Google Fonts API]], вы можете добавить ссылку на таблицу стилей для запроса желаемого веб-шрифта(ов) в файле [[template:dokuwiki#supported_include_hooks|conf/meta.html]], например:
-вы можете добавить ссылку на таблицу стилей для запроса желаемого веб-шрифта (ов) в [[template:dokuwiki#supported_include_hooks|conf/meta.html]] файл, например:+
 <file txt conf/meta.html> <file txt conf/meta.html>
 <link rel="stylesheet" <link rel="stylesheet"
Строка 110: Строка 110:
 ===== Поддержка рендерера ===== ===== Поддержка рендерера =====
  
-Начиная с выпуска 2014-10-13 этот плагин также поддерживает [[plugin: odt | ODT export]] (текстовый формат открытого документа). Слева вы видите снимок экрана, сделанный с тестовой страницы типографики, открытой в браузере, с правой стороны вы видите страницу, экспортированную в ODT:+Начиная с выпуска 2014-10-13 этот плагин также поддерживает экспорт в текстовый формат открытого документа [[plugin:odt|ODT]]. Слева вы видите снимок экрана, сделанный с тестовой страницы типографики, открытой в браузере, с правой стороны вы видите страницу, экспортированную в ODT:
  
-{{https://raw.github.com/ssahara/dw-plugin-typography/master/example/TypographyXHTMLRendering.png?300|XHTML rendering }} +{{https://raw.github.com/ssahara/dw-plugin-typography/master/example/TypographyXHTMLRendering.png?300|рендеринг XHTML}} 
-{{ https://raw.github.com/ssahara/dw-plugin-typography/master/example/TypographyODTRendering.png?300|ODT rendering }}+{{ https://raw.github.com/ssahara/dw-plugin-typography/master/example/TypographyODTRendering.png?300|рендеринг ODT}}
  
 Как видите, в настоящее время существуют некоторые ограничения на экспорт ODT: Как видите, в настоящее время существуют некоторые ограничения на экспорт ODT:
Строка 122: Строка 122:
    * параметры пробела в настоящее время не поддерживаются    * параметры пробела в настоящее время не поддерживаются
  
-Примечание. Для функции экспорта ODT плагина типографики требуется PHP 5> = 5.3.0.+Примечание. Для функции экспорта ODT плагина типографики требуется PHP 5 >= 5.3.0.
  
 ---- ----
  
-===== Развитие=====+===== Развитие =====
  
-Плагин типографики для «ДокуВики» изначально был разработан Павлом Пекарски, оригинальная версия(v0.1101 / 2011-01-18) все еще доступен из http://treecode.pl/typography.html . +Плагин Typography для «ДокуВики» изначально был разработан Павлом Пекарски, оригинальная версия (v0.1101 / 2011-01-18) всё ещё доступна в [[http://treecode.pl/typography.html]]
  
-С 28 июля 2014 года код плагина перемещен в репозиторий github, чтобы обеспечить лучшую доступность для установки и возможности дальнейшей разработки. Спасибо Paweł за вашу раннюю работу и за то, что побудили меня перенести код на github.  --- [[user>s.sahara|s.sahara]] //2014-07-28 14:57//+С 28 июля 2014 года код плагина перемещен в репозиторий github, чтобы обеспечить лучшую доступность для установки и возможности дальнейшей разработки. СпасибоPawełза вашу раннюю работу и за то, что побудили меня перенести код на github.  --- [[user>s.sahara|s.sahara]] //2014-07-28 14:57//
  
-Функция [[plugin: odt: rendersupport | ODT renderer]] - это вклад Ларса (LarsDW223).. +Функция [[plugin:odt:rendersupport|рендеринга ODT]] - это вклад Ларса (LarsDW223).. 
  
 === Журнал изменений из репозитория github === === Журнал изменений из репозитория github ===
Строка 140: Строка 140:
 === Список дел / желаний === === Список дел / желаний ===
  
-   * <del> добавить параметры '' fw: '' (font-weight) и '' sp: '' (white-space) </del>+   * <del> добавить параметры ''fw:'' (font-weight) и ''sp:'' (white-space) </del>
    * было бы неплохо иметь параметр text-align    * было бы неплохо иметь параметр text-align
  
 ===== Известные ошибки и проблемы ===== ===== Известные ошибки и проблемы =====
  
-смотрите также: https://github.com/ssahara/dw-plugin-typography/issues+Смотрите также: https://github.com/ssahara/dw-plugin-typography/issues
  
  
 ==== Не работает ==== ==== Не работает ====
  
-  * Этот плагин, кажется, не работает ** у меня вообще **. Есть ли у кого-нибудь такая же проблема?  ~~lenehey 10/31/2010 +  * Этот плагин, кажется, не работает **у меня вообще**. Есть ли у кого-нибудь такая же проблема? --- lenehey //10/31/2010// 
- * У меня из этого плагина просто фигня. dokuwiki 07.11.2010 "Муравьед". Schplurtz13.03.2011 +  * У меня из этого плагина просто фигня. dokuwiki 07.11.2010 "Муравьед"--- Schplurtz //13.03.2011// 
-     * Не могу согласиться. Первые два приведенных примера на домашней странице плагина работают должным образом. --- [[user> lupo49 | M. С.]] // 2011/03/14 18: 17 // +    * Не могу согласиться. Первые два приведенных примера на домашней странице плагина работают должным образом. --- [[user>lupo49|M. S.]] //2011/03/14 18:17// 
-     * Приведенные примеры отлично работали в моем "Муравьеде" --- antoniomch 4/4/2011 +    * Приведенные примеры отлично работали в моем "Муравьеде" --- antoniomch //4/4/2011// 
-     * Этот плагин работает. Есть только определенные условия, в которых он будет работать. Я обнаружил, что это не работает для списков, и поэтому для его применения необходимо применить код ко всем «маркерам» в списке. Не большая проблема, но использование стилизованного форматирования работает нормально. -eiri. 13.12.2013 +    * Этот плагин работает. Есть только определенные условия, в которых он будет работать. Я обнаружил, что это не работает для списков, и поэтому для его применения необходимо применить код ко всем «маркерам» в списке. Не большая проблема, но использование стилизованного форматирования работает нормально. --- eiri. //13.12.2013// 
-   * Этот плагин несовместим с плагином [[plugin: edittable | EditTable]], который больше не работает, когда активна типография. -Ronan 2014/08/04 (с использованием версии DokuWiki Binky) +  * Этот плагин не совместим с плагином [[plugin:edittable]], который больше не работает, когда активен Typography--- Ronan //2014/08/04// (с использованием версии DokuWiki Binky) 
-     * Плагин [[plugin: edittable | EditTable]] отлично работал с плагином Typography в DW "Ponder Stibbons". --- [[user> s.sahara | s.sahara]] // 2014-08-06 02:40 // +    * Плагин [[plugin:edittable]] отлично работал с плагином Typography в DW "Ponder Stibbons". --- [[user>s.sahara|s.sahara]] //2014-08-06 02:40// 
-  * Не работает вес шрифта, проверьте и приведите пример // 2015-08-07 // +  * Не работает вес шрифта, проверьте и приведите пример --- //2015-08-07// 
-     * Например, попробуйте <code> <typo fw: 900;> Heavy text </typo> </code> --- [[user> LarsDW223]] +    * Например, попробуйте <code><typo fw:900;>Heavy text</typo></code> --- [[user>LarsDW223]] 
-   * Все функции, которые я опробовал, отлично работают с dokuwiki Release 2015-08-10a "Detritus". Однако у вас должны быть эти точки с запятой. Я успешно использовал теги <typo> и <fs>. +  * Все функции, которые я опробовал, отлично работают с dokuwiki Release 2015-08-10a "Detritus". Однако у вас должны быть эти точки с запятой. Я успешно использовал теги <typo> и <fs>.
  
 ==== Значок цвета шрифта отображается неправильно ==== ==== Значок цвета шрифта отображается неправильно ====
-  * на USB Stick-версии "Эленор Цорт" палитра цветов не отображает цвета. Решил это, удалив if-case <code> // if ($ isSameHost && $ isColorSet) { 
-//} </code> 
-     * Также пробовал установить плагин цвета шрифта, все то же самое. - twdreamer 2017/04/10 
- 
-  * Начиная с версии 2016-05-16, значки выбора цвета не зависят от [[tips: phpwithgd | PHP GD library]] (gdlib) и отображаются как SVG вместо PNG, если gdlib недоступен. Надеюсь, новая версия будет работать с USB Stick-версией «ДокуВики». \\ --- [[user> s.sahara | s.sahara]] // 2017-05-16 15: 05 // 
  
 +  * на USB Stick-версии "Эленор Цорт" палитра цветов не отображает цвета. Решил это, удалив условие <code>//if ($isSameHost && $isColorSet) {
 +// }</code>
 +    * Также пробовал установить плагин цвета шрифта, все то же самое. --- twdreamer //2017/04/10//
 +  * Начиная с версии 2016-05-16, значки выбора цвета не зависят от [[tips:phpwithgd|библиотеки PHP GD]] (gdlib) и отображаются как SVG вместо PNG, если gdlib недоступен. Надеюсь, новая версия будет работать с USB Stick-версией «ДокуВики». \\ --- [[user>s.sahara|s.sahara]] //2017-05-16 15:05//
ru/plugin/typography.1602957581.txt.gz · Последнее изменение: 2020-10-17 19:59 — Dr-Yukon