Следующая версия | Предыдущая версия |
wiki:devel:table_css [2023/08/19 01:15] – создано vladpolskiy | wiki:devel:table_css [2024/08/26 09:04] (текущий) – [Таблицы стилей CSS] vladpolskiy |
---|
====== Таблицы стилей CSS ====== | ====== Таблицы стилей CSS ====== |
| |
Многое в отображении <<[[..:dokuwiki|ДокуВики]]>> контролируется через таблицы стилей CSS. <<ДокуВики>> сама по себе определяет очень ограниченный набор стилей. Остальные описания CSS берутся из используемых [[..:template|шаблонов]] и [[..:plugins|плагинов]]. | Многое в отображении <<[[..:dokuwiki|ДокуВики]]>> контролируется через таблицы стилей CSS. <<ДокуВики>> сама по себе определяет очень ограниченный набор стилей. Остальные описания CSS берутся из используемых [[wiki:devel:template|шаблонов]] и [[..:plugins|плагинов]]. |
| |
Все файлы CSS предоставляются через единый диспетчер в ''lib/exe/css.php'', который, кроме того, управляет кэшированием, заменами по маске и оптимизацией. Загрузка таблиц стилей производится (наряду с другими вещами) функцией ''tpl_metaheaders()'', так что не забывайте включить её в свой шаблон. | Все файлы CSS предоставляются через единый диспетчер в ''lib/exe/css.php'', который, кроме того, управляет кэшированием, заменами по маске и оптимизацией. Загрузка таблиц стилей производится (наряду с другими вещами) функцией ''tpl_metaheaders()'', так что не забывайте включить её в свой шаблон. |
* **all** --- применяется во всех режимах отображения; | * **all** --- применяется во всех режимах отображения; |
* **print** --- определения отсюда будут использоваться при печати страницы; | * **print** --- определения отсюда будут использоваться при печати страницы; |
* **rtl** --- определения из файлов ''rtl'' будут загружены дополнительно, когда используется [[ru:localization|язык]] с написанием справа-налево; | * **rtl** --- определения из файлов ''rtl'' будут загружены дополнительно, когда используется [[wiki:localization|язык]] с написанием справа-налево; |
* **feed** --- применяется для отображения [[ru:syndication|новостной ленты]]. | * **feed** --- применяется для отображения [[wiki:syndication|новостной ленты]]. |
| |
===== Таблицы стилей «ДокуВики» ===== | ===== Таблицы стилей «ДокуВики» ===== |
Чтобы лучше сочетаться с цветовой схемой любого шаблона, авторы плагинов должны использовать [[#гарантированные цветовые подстановки]]. | Чтобы лучше сочетаться с цветовой схемой любого шаблона, авторы плагинов должны использовать [[#гарантированные цветовые подстановки]]. |
| |
:!: Таблицы стилей плагина загружаются, даже если сам плагин не используется (но не если он [[ru:config:disableactions|выключен]]). | :!: Таблицы стилей плагина загружаются, даже если сам плагин не используется (но не если он [[wiki:config:disableactions|выключен]]). |
| |
:!: Определённые здесь стили должны позаботиться о возможных конфликтах. Поэтому будьте осторожны при написании плагинов. Если возможно, добавляейте префиксы к названиям ваших стилей для избежания конфликтов. | :!: Определённые здесь стили должны позаботиться о возможных конфликтах. Поэтому будьте осторожны при написании плагинов. Если возможно, добавляейте префиксы к названиям ваших стилей для избежания конфликтов. |
Независимо от используемого шаблона, администратором вики могут быть определены дополнительные стили с помощью следующих файлов CSS в директории ''conf/'': | Независимо от используемого шаблона, администратором вики могут быть определены дополнительные стили с помощью следующих файлов CSS в директории ''conf/'': |
| |
^ Файл CSS в «[[ru:changes#релиз_2010-11-07a_муравьед|Муравьеде]]» ^ Файл CSS после и до «Муравьеда»((changed back on 2011-02-26)) ^ Когда используется ^ | ^ Файл CSS в «[[wiki:changes#релиз_2010-11-07a_муравьед|Муравьеде]]» ^ Файл CSS после и до «Муравьеда»((changed back on 2011-02-26)) ^ Когда используется ^ |
| ''conf/userstyle.css'' | ''conf/userstyle.css'' | Применяется во всех режимах отображения | | | ''conf/userstyle.css'' | ''conf/userstyle.css'' | Применяется во всех режимах отображения | |
| ''conf/printstyle.css'' | ''conf/userprint.css'' | Применяется при отправке на печать | | | ''conf/printstyle.css'' | ''conf/userprint.css'' | Применяется при отправке на печать | |
===== Использование ID ===== | ===== Использование ID ===== |
| |
Когда вы используете произвольный ID в вашем шаблоне для назначения стиля, убедитесь, что этот ID не конфликтует с уже имеющимися. В частности, убедитесь, что нет конфликта с автоматически назначаемыми ID для заголовков разделов. Простейший путь добиться этого --- использовать два смежных символа подчерка (%%__%%) в вашем ID. Поскольку ID разделов всегда представляют собой допустимое [[ru:pagenames|имя статьи]], они никогда не будут содержать смежных подчерков. | Когда вы используете произвольный ID в вашем шаблоне для назначения стиля, убедитесь, что этот ID не конфликтует с уже имеющимися. В частности, убедитесь, что нет конфликта с автоматически назначаемыми ID для заголовков разделов. Простейший путь добиться этого --- использовать два смежных символа подчерка (%%__%%) в вашем ID. Поскольку ID разделов всегда представляют собой допустимое [[wiki:pagenames|имя статьи]], они никогда не будут содержать смежных подчерков. |
| |
===== style.ini ===== | ===== style.ini ===== |