Tips for Dokuwiki

dokuwiki를 사용하면서 습득한 유용한 정보들의 모음.

dokuwiki는 여러 곳에 작성된 css를 하나의 파일로 컴파일해서 첨부한다. 이 과정에서 less 파서를 사용하는데, 이 파서는 성능에 다소 제약이 있다. 대표적인 예시가 css calc 함수다. 예컨대 calc(100vw - 2rem)의 식을 dokuwiki 파서는 calc(98vw)로 계산한다. 이 문제를 피하려면, ~"calc(100vw - 2rem)" 또는 calc(~"100vw - 2rem")과 같은 식으로 작성해야 한다¹⁾.

기본적으로 Dokuwiki는 LESS를 통해 css에 변수를 대입하고 재사용할 수 있도록 하며, styling 플러그인에서 그 설정을 지원한다. 구체적으로는 변수명에서 앞뒤의 밑줄을 제거하고 @ini_ 를 붙여 LESS 변수로 선언하며(예: __background__ → @ini_background) 본문도 같은 방식으로 치환해 일치시킨다. 이 메커니즘상으로는 selector에 변수를 지정할 수 없는데, CSS 파일에 직접 @{ini_background} 형태로 변수명을 입력하면 selector에도 변수 사용이 가능하다.

Backlinks