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

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


ru:plugin:typography

Различия

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

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

Следующая версия
Предыдущая версия
Следующая версия справа и слева
ru:plugin:typography [2020-10-17 18:03]
Xenus2020 создано
ru:plugin:typography [2020-10-20 17:13] (текущий)
Dr-Yukon
Строка 1: Строка 1:
 ====== Typography Plugin ====== ====== Typography Plugin ======
  
-===== Функции =====+---- plugin ---- 
 +description: Обширные возможности стилизации текста с помощью таких CSS-правил, как тип шрифта, размер, толщина и цвет текста. 
 +author     : Pawel Piekarski, Satoshi Sahara 
 +email      : sahara.satoshi@gmail.com 
 +type       : syntax 
 +lastupdate : 2020-07-31 
 +compatible : 2016-06-26, 2017-02-19, Greebo 2018-04-22, Hogfather 2020-07-29 
 +depends    :  
 +conflicts  :  
 +similar    : fontcolor, fontsize2, fontfamily, wrap 
 +tags       : style, typography, fonts
  
-Плагин типографики расширяет разметку «ДокуВики» за счет возможностей набора текстаТег разметки <typo> определяет свойства шрифта CSS, такие как вид шрифта, размер, жирность и цвет текстаПараметр состоит из пар свойство-значение CSS (свойствозначение;), каждая пара должна быть разделена точкой с запятой (;), однако последняя может быть опущена. Вы можете использовать сокращенное короткое имя вместо полного имени свойства.+downloadurl: https://github.com/ssahara/dw-plugin-typography/zipball/master 
 +bugtracker : https://github.com/ssahara/dw-plugin-typography/issues 
 +sourcerepo https://github.com/ssahara/dw-plugin-typography 
 +----
  
-Некоторое конкретное короткое имя также доступно как тег разметки; <ff> (семейство шрифтов / имя), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (вес). Плагин типографики полностью заменяет: fontfamily, fontsize2 и fontcolor.+===== Установка =====
  
 +Установка стандартная, поиском и скачиванием через [[plugin:extension|Extension Manager]]. Для ручной установки смотрите [[:ru:plugins]].
  
-^  short name  ^ css property name ^ description ^ +===== Функции =====
-|  ''fc''  | color             | цвет текста | +
-|  ''bg''  | background-color цвет фона текста | +
-|  ''fs''  | font-size         | размер шрифта текста (большой или мелкий) | +
-|  ''fw''  | font-weight       | weight of a font (thick or thin characters in text) | +
-|  ''fv''  | font-variant      | display text in a small-caps font | +
-|  ''ff''  | font-family       | font family for text, must be single quoted if a font name contains white-space and non-ASCII characters | +
-|  ''lh''  | line-height       | space between the lines | +
-|  ''ls''  | letter-spacing    | an extra space between characters  (in px, em, etc) | +
-|  ''ws''  | word-spacing      | an additional space between words (in px, em, etc) | +
-|  ''sp''  | white-space       | specifies how white-space is handled (preserve or collapse) | +
-|  ''va''  | vertical-align    | sets the vertical alignment | +
-|  -       | text-transform    | controls the capitalization of text (capitalize, uppercase or lowercase)| +
-|  -       | text-shadow       | adds shadow to text | +
-|  ''wf''  | (web-font)        | specify a web font class which prefixed "wf-" |+
  
-Sometimesinline styles are necessary when you are building a page by handYou should however avoid them whenever possible for "semantic markup", better maintainabilityand reusabilityThe [[plugin:wrap|wrap]] plugin will provide most powerful and flexible method for specifying a class attribute.+Плагин Typography расширяет разметку «ДокуВики» за счет возможностей набора текста. Парный тег разметки <typo …> </typo> включает в себя в качестве параметров CSS-правилатакие как тип шрифта, размер, толщина и цвет текстаАналогично CSS-синтаксису параметры состоят из пар "свойство:значение", отделяемых друг от друга точкой с запятой (;)однако последняя в списке может быть опущенаМежду тегом и его параметрами ставится один пробел, после точки с запятой также можно в эстетических целях добавлять пробел. Вместо полного имени свойства можно использовать сокращённое. Значения поддерживают любые CSS-единицы, включая словарные (px, em, %, x-small и пр.)
  
-==== Using short syntax with Toolbar menu ====+Некоторые сокращения сами доступны как парные теги, например, <ff> (тип шрифта), <fs> (размер), <fc> (цвет), <bg> (цвет фона), <fw> (толщина). В качестве разделителя можно использовать как двоеточие, так и пробел. За счёт полного совпадения функционала и синтаксиса плагин Typography свободно, без правок статей может заменить плагины FontFamily, FontSize2 и FontColor.
  
-Typography plugin provides short name (or single propertysyntax those are compatible with [[plugin:fontfamily]][[plugin:fontcolor]], and [[plugin:fontsize2]]. If you have enabled these three pluginthe short syntax are treated by relevant plugins instead of this plugin. These short syntax are available through toolbar icons: {{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}}.+^  Короткое имя  ^ CSS-cвойство ^ Описание ^ 
 +|  ''fc''  | color             | цвет шрифта | 
 +|  ''bg''  | background-color  | цвет фона шрифта | 
 +|  ''fs''  | font-size         | размер шрифта | 
 +|  ''fw''  | font-weight       | толщина шрифта (толстые или тонкие символы в тексте
 +|  ''fv''  | font-variant      | капитель (уменьшенные прописные буквы) | 
 +|  ''ff''  | font-family       | семейство шрифтов (если содержит пробелы и символыотличные от ASCII - должно быть заключено в одинарные кавычки) | 
 +|  ''lh''  | line-height       | пространство между строками (интерлиньяж) | 
 +|  ''ls''  | letter-spacing    | пространство между символами (апрош или интерлеттраж) | 
 +|  ''ws''  | word-spacing      | пространство между словами (спейс) | 
 +|  ''sp''  | white-space       | указываеткак обрабатывается пробел (сохранить или свернуть) | 
 +|  ''va''  | vertical-align    | вертикальное выравнивание | 
 +|        | text-transform    | режим заглавных букв в тексте (заглавные, прописные или строчные)| 
 +|        | text-shadow       | тень у текста | 
 +|  ''wf''  | (web-font)        | класс веб-шрифта (с префиксом "wf-") |
  
-===== Examples/Usage =====+Иногда встроенные стили необходимы, когда вы создаете страницу вручную. Однако вам следует по возможности избегать их для «семантической разметки», улучшения ремонтопригодности и возможности повторного использования. Плагин [[plugin:wrap]] предоставляет наиболее мощный и гибкий метод для определения атрибута класса.
  
-** Single parameter example: **+==== Использование короткого синтаксиса с меню панели инструментов ==== 
 + 
 +Плагин 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}}. 
 + 
 +===== Примеры / Использование ===== 
 + 
 +**Пример одного параметра:**
  
 <file txt> <file txt>
Строка 43: Строка 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}}
  
-** Multiple parameter example: **+**Пример с несколькими параметрами:**
  
 <file txt> <file txt>
Строка 52: Строка 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}}
  
-** Nesting syntax: **+**Синтаксис вложенности:**
  
 <file txt> <file txt>
Строка 63: Строка 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}}
  
-** Using Web font **+**Использование веб-шрифта**
  
-For [[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]], например:
-you may add a stylesheet link to request the desired web font(sin [[template:dokuwiki#supported_include_hooks|conf/meta.html]] filefor example:+
 <file txt conf/meta.html> <file txt conf/meta.html>
 <link rel="stylesheet" <link rel="stylesheet"
Строка 76: Строка 98:
 </file> </file>
  
-Then you can use the font name (eg. Tangerine) in the font-family value:+Затем вы можете использовать имя шрифта (например, Tangerine) в значении font-family:
 <file> <file>
 <ff Tangerine; fs:48px>Making the Web Beautiful!</ff> <ff Tangerine; fs:48px>Making the Web Beautiful!</ff>
Строка 86: Строка 108:
 ---- ----
  
-===== Renderer support =====+===== Поддержка рендерера =====
  
-Starting with release 2014-10-13 this plugin also supports [[plugin:odt|ODT export]] (Open Document Text format)On the left side you see a screenshot taken from a typography test page opened in a browseron the right side you see the page exported to 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}}
  
-As you might see there are currently some limitations regarding the ODT export:+Как видите, в настоящее время существуют некоторые ограничения на экспорт ODT:
  
-  * <del>altering the text size is currently not supported</del> Altering the text size is supported since release 2015-04-02. +   * <del> изменение размера текста в настоящее время не поддерживается </del> Изменение размера текста поддерживается с выпуска 2015-04-02. 
-  after a line-height typography tag is closed, a new paragraph begins. ODT only supports setting the line-height per paragraphThe XHTML renderer stays in the same line after the tag is closed+   после закрытия тега типографики высотой строки начинается новый абзац. ODT поддерживает только установку высоты строки для каждого абзацаСредство визуализации XHTML остается в той же строке после закрытия тега
-  word spacing is not supported by the ODT format +   межсловный интервал не поддерживается форматом ODT 
-  the white space options are currently not supported+   параметры пробела в настоящее время не поддерживаются
  
-Note: The ODT export feature of typography plugin requires PHP 5 >= 5.3.0+Примечание. Для функции экспорта ODT плагина типографики требуется PHP 5 >= 5.3.0.
  
 ---- ----
  
-===== Development =====+===== Развитие =====
  
-Typography plugin for DokuWiki was initially developed by Paweł Piekarskioriginal version (v0.1101 / 2011-01-18) is still available from http://treecode.pl/typography.html . +Плагин Typography для «ДокуВики» изначально был разработан Павлом Пекарскиоригинальная версия (v0.1101 / 2011-01-18) всё ещё доступна в [[http://treecode.pl/typography.html]]
  
-Since 2014-07-28, the plugin code has moved to github repository to provide better accessibility for install and further development opportunityThanks Paweł for your early work and encouraging me to move the code to 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//
  
-The [[plugin:odt:rendersupport|ODT renderer]] feature is contribution from Lars (LarsDW223). +Функция [[plugin:odt:rendersupport|рендеринга ODT]] - это вклад Ларса (LarsDW223).
  
-=== Change Log from github repository ===+=== Журнал изменений из репозитория github ===
  
 {{rss>https://github.com/ssahara/dw-plugin-typography/commits/master.atom date 5}} {{rss>https://github.com/ssahara/dw-plugin-typography/commits/master.atom date 5}}
  
-=== ToDo/Wish List ===+=== Список дел желаний ===
  
-  * <del>add ''fw:'' (font-weight) and ''sp:'' (white-space) parameters</del> +   * <del> добавить параметры ''fw:'' (font-weight) и ''sp:'' (white-space) </del> 
-  it would be nice to have the text-align parameter+   было бы неплохо иметь параметр text-align
  
-===== Known Bugs and Issues =====+===== Известные ошибки и проблемы =====
  
-see also: https://github.com/ssahara/dw-plugin-typography/issues+Смотрите также: https://github.com/ssahara/dw-plugin-typography/issues
  
  
-==== Not working ====+==== Не работает ====
  
-  * This plugin doesn't seem to be working **at all** for me Is anyone else having the same problem ~~lenehey 10/31/2010 +  * Этот плагин, кажется, не работает **у меня вообще**. Есть ли у кого-нибудь такая же проблема--- lenehey //10/31/2010// 
-  * I get just garbage out of this plugin. dokuwiki 2010-11-07a "Anteater". Schplurtz. 13/03/2011 +  * У меня из этого плагина просто фигня. dokuwiki 07.11.2010 "Муравьед"--- Schplurtz //13.03.2011// 
-    * Can't second itThe first two given examples on the plugin homepage are working as they should --- [[user>lupo49|M. S.]] //2011/03/14 18:17// +    * Не могу согласитьсяПервые два приведенных примера на домашней странице плагина работают должным образом. --- [[user>lupo49|M. S.]] //2011/03/14 18:17// 
-    * The examples given worked fine in my "Anteater" --- antoniomch 4/4/2011 +    * Приведенные примеры отлично работали в моем "Муравьеде" --- antoniomch //4/4/2011// 
-    * This plugin worksThere are only certain conditions in which it will workI find that it does not work for listsand thus need to apply the code to every single "bullet" in the list for it to applyNot a huge issuebut using styled formatting works fine. -eiri. 12/13/2013 +    * Этот плагин работаетЕсть только определенные условия, в которых он будет работатьЯ обнаружилчто это не работает для списков, и поэтому для его применения необходимо применить код ко всем «маркерам» в спискеНе большая проблемано использование стилизованного форматирования работает нормально--- eiri. //13.12.2013// 
-  * This plugin is incompatible with the [[plugin:edittable|EditTable]] plugin which is not working anymore when Typography is active. -Ronan 2014/08/04 (using DokuWiki Binky version+  * Этот плагин не совместим с плагином [[plugin:edittable]], который больше не работает, когда активен Typography. --- Ronan //2014/08/04// (с использованием версии DokuWiki Binky) 
-    * The [[plugin:edittable|EditTable]] plugin worked fine with the Typography plugin on the 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// 
-  * The font weight does not workplease check and give an example //2015-08-07// +  * Не работает вес шрифтапроверьте и приведите пример --- //2015-08-07// 
-    *  For example try <code><typo fw:900;>Heavy text</typo></code> --- [[user>LarsDW223]] +    * Например, попробуйте <code><typo fw:900;>Heavy text</typo></code> --- [[user>LarsDW223]] 
-  * All the features I've tried work fine with dokuwiki Release 2015-08-10a "Detritus" You have to have those semi-colons though I've used the <typo> and <fs> tags with great success.+  * Все функции, которые я опробовал, отлично работают с dokuwiki Release 2015-08-10a "Detritus"Однако у вас должны быть эти точки с запятойЯ успешно использовал теги <typo> и <fs>.
  
 +==== Значок цвета шрифта отображается неправильно ====
  
-==== The font color icon doesn't show up correctly ==== +  на USB Stick-версии "Эленор Цортпалитра цветов не отображает цветаРешил это, удалив условие <code>//if ($isSameHost && $isColorSet) {
-  on USB Stick-Version of "Elenor Of Tsortthe color picker doesn't show colorsDid solve it by removing the if-case <code>//if ($isSameHost && $isColorSet) {+
 // }</code> // }</code>
-    * Also tried to install font color plug instill the same. - twdreamer 2017/04/10 +    * Также пробовал установить плагин цвета шрифтавсе то же самое--- 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//
-  * Since 2016-05-16 versionno dependent of [[tips:phpwithgd|PHP GD library]] (gdlib) and color picker icons are rendered as SVG instead of PNG if gdlib is not availableI hope new version will work on USB Stick-Version of DokuWiki.\\  --- [[user>s.sahara|s.sahara]] //2017-05-16 15:05// +
ru/plugin/typography.1602950631.txt.gz · Последнее изменение: 2020-10-17 18:03 — Xenus2020