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