relref shortcode

relref는 대상 페이지까지의 상대 permalink를 만들어 주는 shortcode입니다.
ref와 문법은 거의 비슷하지만, 결과가 상대 경로라는 점이 다릅니다.

공식 문서는 Markdown에서 이 shortcode가 obsolete라고 설명하면서도, 경로 해석 방식과 에러 처리 옵션을 따로 안내합니다. path, lang, outputFormat을 사용할 수 있으며, 경로는 현재 페이지 기준에서 먼저 해석됩니다. citeturn660511view1

렌더링 결과

상대 링크로 가는 문서

원형

[상대 링크로 가는 문서]({{% relref "/blog/lab/91-hugo-shortcode/relref-target" %}})

해석 포인트

  • relref는 결과가 상대 URL이어서 이동 가능한 문서 묶음에서 유리합니다.
  • 동일한 도메인 안에서 경로가 덜 딱딱해집니다.
  • ref보다 외형상 덜 장황할 수 있지만, 대규모 문서에서는 경로 기준을 일관되게 유지해야 합니다.

실무 팁

  • 섹션 내부 이동이 많을수록 relref의 장점이 커집니다.
  • 리팩터링 시 상대 경로가 깨질 수 있으므로 대상 페이지의 위치를 함께 관리해야 합니다.