--- Dev Less
+++ Dev Less
@@ -1,29 +1,40 @@
= [Dev] Less
== 빌드 구조
IntelliJ FileWatcher가 `_`로 시작하지 않는 `.less` 파일을 저장할 때 자동으로 같은 이름의 `.css`로 컴파일한다.
-`_`로 시작하는 파일(`_mixins.less`)은 컴파일 대상이 아니며 `@import`로만 참조된다.
+`_`로 시작하는 파일은 컴파일 대상이 아니며 `@import`로만 참조된다.
각 `.less` 파일 상단에 `@import "_mixins";` 를 추가해 공용 변수/믹스인을 사용한다.
+IntelliJ 없이 손으로 컴파일할 때는 `app/assets` 에서:
+
+[[[#!Vim bash
+lessc --source-map wiki.less wiki.css
+]]]
+
+커밋돼 있는 `.css`·`.css.map` 과 바이트 단위로 같은 결과가 나온다(2026-08-19 `wiki.less` 로 실측). 다른 옵션을 쓰면 소스맵이 달라져 고치지 않은 파일이 diff 에 나타난다.
+
== 파일 구조
=== 공용 믹스인 (컴파일 안 함)
- * `app/assets/_mixins.less`
+ * `app/assets/_mixins.less` - 모든 `.less` 파일이 첫 줄에서 import
+ * `app/assets/_paper.less` - `wiki.less` 가 import (인쇄용 paperContent)
+ * `app/assets/_wiki_table.less` - `wiki.less` 가 import (wikiTableSimple 표)
=== 독립 컴파일 파일
[[[#!Table tsv 1 1
파일 내용 CSS 로딩 위치
`less.less` 테마 CSS 변수(`:root`, dark), html/body, navbar, header/footer, toast, hotkey, MacroThemes 등 코어 모든 페이지
`wiki.less` `.AhaWiki` 위키 콘텐츠, 테이블, TOC, schema, paperContent 등 모든 페이지
`search.less` `.search`, `.searchBg`, `.autocomplete-*`, `.searchResult`, `.ahaWikiLoader` 모든 페이지 (검색 오버레이가 전역 단축키로 동작)
`kanban.less` `.InterpreterKanban`, `.kanban-modal` 등 칸반 전체 모든 페이지 (위키 본문에 칸반 매크로가 올 수 있음)
`interpreter.less` `.Interpreter`, `.Macro`, `.InterpreterRenderMetaWrapper`, `.interpreterMap` 모든 페이지
`adjacent.less` `svg.graph`, `.adjacentPagesHud`, `.crawlerPreview` 등 인접 페이지 그래프 모든 페이지
+`gantt.less` `.InterpreterGantt` 간트차트 모든 페이지 (위키 본문에 간트 블록이 올 수 있음)
-
`edit.less` `.AhaWiki .edit` `edit.scala.html` 에서만
`blame.less` `.AhaWiki .blame` `blame.scala.html` 에서만
`diff.less` `.AhaWiki .diff` `diff.scala.html` 에서만
]]]