DokuWiki

It's better when it's simple

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

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

Вы посетили:
ru:plugin:typography

Различия

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

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

Следующая версия		Предыдущая версия
ru:plugin:typography [2020-10-17 18:03] – создано Xenus2020ru: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-" |+
  
-Sometimes, inline styles are necessary when you are building a page by hand. You should however avoid them whenever possible for "semantic markup", better maintainability, and reusability. The [[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 property) syntax those are compatible with [[plugin:fontfamily]], [[plugin:fontcolor]], and [[plugin:fontsize2]]. If you have enabled these three plugin, the 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(s) in [[template:dokuwiki#supported_include_hooks|conf/meta.html]] file, for 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 browser, on 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 paragraph. The 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ł Piekarski, original 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 opportunity. Thanks 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 it. The 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 works. There are only certain conditions in which it will work. I find that it does not work for lists, and thus need to apply the code to every single "bullet" in the list for it to apply. Not a huge issue, but 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 work, please 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 Tsort" the color picker doesn't show colors. Did solve it by removing the if-case <code>//if ($isSameHost && $isColorSet) {+
 // }</code> // }</code>
-    * Also tried to install font color plug in, still 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 version, no dependent of [[tips:phpwithgd|PHP GD library]] (gdlib) and color picker icons are rendered as SVG instead of PNG if gdlib is not available. I 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
Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

Global DokuWiki Links