DokuWiki の LESS CSS 対応
Release 2013-12-08 “Binky” 以降で利用可能です。
LESS は CSS にコンパイルする動的なスタイルシート言語です。 これは、スタイルシートを書く際に、変数・ネスト・ミックスイン・演算子・関数のような新しいメカニズムを提供します。
DokuWiki の CSS ディスパッチャは、PHP ベースの LESS パーサを含みます。 テンプレートやプラグイン のスタイルでこの動的な CSS の前処理の利点を最大限利用できることを意味します。 もちろん、完全に任意で昔ながらの CSS を書くこともできます。
LESS 文は .css
ファイルの中と .less
ファイルの中で解析されます。
LESS 言語構造
言語自体を学ぶには、公式の lesscss.org マニュアルを参照してください。 パーサーとして lessphp 使用しているため、そのライブラリの制限が適用されます (例:JavaScript 表現は使用できません)。
スタイルガイド
LESS 使用する場合、以下の点に留意してください:
- ネストは浅くする。3〜4層より深いネストは通常不要で、読み難く、セレクタの性能が悪化する可能性があります。
- ミックスインと変数に接頭辞を付ける。独自のミックスインや変数を定義する場合、他のテンプレートやプラグインと衝突する可能性のある一般的な名前は避けてください。クラスや ID を付けて下さい。
style.ini のプレースホルダーへのアクセス
style.ini のプレースホルダーは、スタイル内で LESS 変数として利用できます。
LESS 変数は @ini_
を前に付け、__
を削除します。
例:__background__
プレースホルダーは、LESS スタイルで @ini_background
になります。
警告
すべての CSS が LESS パーサーを通過しなければならないので、CSS の妥当性がより厳しくなります。 プラグインが無効な CSS を使用している場合、ただちにエラーが出力されます。 現在の既知の問題の一覧は Less CSS Errors で入手できます。