위키링크는 어떻게 해석되는가
노트는 겹대괄호로 서로를 링크하고, 링크는 빌드 시점에 실제로 존재하는 노트 집합을 상대로 해석됩니다. 렌더링된 결과 — id, 별칭, 라벨, 앵커 — 는 전 요소 시연에서 라이브로 공연합니다; 이 장은 그 뒤에 선 해석 규칙 이야기입니다.
§5.1대상이 될 수 있는 것
대상이 꼭 노트의 id일 필요는 없습니다. 해석은 순서대로 시도합니다: 현재 로케일의 미러(이 페이지의 열일곱 자매판 어느 곳에서 건 링크든 대상의 같은 언어 판에 내려앉고, 미러가 없는 곳에서만 원본 노트로 물러납니다), 그다음 정확한 id, 그다음 별칭·brand·제목 — 대소문자 구분 없이. 에세이 작은 정원 가꾸는 법의 영어 원본은 tending 별칭을 선언하므로, 거기서는 [[tending]] 표기가 같은 페이지에 닿습니다(별칭은 원본 노트의 것이라, 미러는 별칭을 갖지 않습니다). 앵커와 라벨은 기대하는 대로 조합됩니다: [[garden-craft#pruning]] 표기는 곧장 섹션으로 가고, [[garden-craft|the gardening essay]] 표기는 지정한 텍스트를 렌더링합니다 — 그리고 둘은 결합됩니다.
§5.2죽은 링크는 빌드를 깨지 않습니다
존재하지 않는 노트로 가는 링크는 눈에 보이는 죽은 링크로 렌더링되고 — 이유는 툴팁에 — 빌드는 경고를 기록합니다. 정원을 위한 의도된 선택입니다: 아직 쓰이지 않은 노트는 오류가 아니라 초대장입니다. 한 번에 여러 노트와 일치하는 대상도 같은 방식으로, 모호함 표시와 함께 렌더링됩니다. 그래도 링크 부패가 있어야 할 곳은 CI입니다 — 엔진의 check-wikilinks CLI는 라이브러리 자신의 규칙으로 모든 링크를 해석하고, --strict 모드에서는 죽은 링크를 실패 종료 코드로 바꿉니다. 이 저장소가 도는 방식이 바로 그것입니다(다섯 가지 검사).
§5.3구현 하나, 소비자 넷
페이지, 편집기의 라이브 미리보기, 수신함 가져오기, 그리고 CI 린트는 같은 코드로 해석합니다 — 그래서 링크는 어디서나 같은 것을 뜻하고, 편집기는 후해질 수 있습니다: 편집 모드에서 [[ 기호를 입력하면 id·제목·별칭 위로 자동 완성이 떠오릅니다.