Skip to content
This is revision 5, saved by Aha00aAha00a. The latest is revision 6. View the latest Changes since
created by Aha00aAha00a at 2026-05-26
last modified by Aha00aAha00a at 2026-10-04
revision: 6

Dev Less

1. 빌드 구조

IntelliJ FileWatcher가 _로 시작하지 않는 .less 파일을 저장할 때 자동으로 같은 이름의 .css로 컴파일한다.

_로 시작하는 파일은 컴파일 대상이 아니며 @import로만 참조된다.

각 .less 파일 상단에 @import "_mixins"; 를 추가해 공용 변수/믹스인을 사용한다.

IntelliJ 없이 손으로 컴파일할 때는 app/assets 에서:

lessc --source-map wiki.less wiki.css

커밋돼 있는 .css·.css.map 과 바이트 단위로 같은 결과가 나온다(2026-08-19 wiki.less 로 실측). 다른 옵션을 쓰면 소스맵이 달라져 고치지 않은 파일이 diff 에 나타난다.

2. 파일 구조

2.1. 공용 믹스인 (컴파일 안 함)

  • app/assets/_mixins.less - 컴파일되는 .less 파일 열 개가 첫 줄에서 import (_paper·_wiki_table 은 wiki.less 안에서 들어오므로 직접 import 하지 않는다)
  • app/assets/_paper.less - wiki.less 가 import (인쇄용 paperContent)
  • app/assets/_wiki_table.less - wiki.less 가 import (wikiTableSimple 표)

2.2. 독립 컴파일 파일

파일

내용

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 간트차트

모든 위키 페이지 (_baseSkeleton. Admin 화면의 _baseAdmin 은 싣지 않는다)

-

edit.less

.AhaWiki .edit

edit.scala.html 에서만

blame.less

.AhaWiki .blame

blame.scala.html 에서만

diff.less

.AhaWiki .diff

diff.scala.html 에서만

템플릿은 .css 를 /public/wiki.css 같은 맨 주소가 아니라 PublicAsset.url 로 부른다. 주소에 내용 해시가 붙어서 배포한 CSS 가 브라우저에 바로 닿는다 — Dev Deploying CSS·JS 주소에는 내용 해시가 붙는다.

3. See Also

3.2. Similar Pages

Similar pages by cosine similarity. Words after page name are term frequency.

3.3. Adjacent Pages

Control
≤ 32
all
1.0x
1.0x
80
-120
ON
Metrics
Nodes(visible/total)0/0
Links(visible/total)0/0
Avg degree0.00
Depth coverage0
Queue(fetch/graph)0 / 0
Zoom(scale)1.00x
Ctrl/⌘ + Scroll: Zoom
Root 1-hop 2-hop+