param shortcode

param은 front matter나 site configuration에 저장된 값을 본문 안으로 꺼내오는 shortcode입니다.
문구를 여러 페이지에 반복하지 않으려면, 이 방식이 생각보다 강력합니다.

공식 문서에 따르면 param은 먼저 front matter를 찾고, 없으면 site parameter를 찾습니다. 값이 없으면 오류를 발생시킵니다. 중첩 값도 점(.)으로 연결해 접근할 수 있습니다. citeturn534114view2

렌더링 결과

이 페이지의 제품 이름은 91-hugo-shortcode 입니다.

이 페이지의 배지는 LAB 입니다.

요약 문구는 front matter에서 끌어오는 값 입니다.

원형

이 페이지의 제품 이름은 `{{% param product.name %}}` 입니다.

이 페이지의 배지는 `{{% param product.nested.badge %}}` 입니다.

요약 문구는 `{{% param seo.summary %}}` 입니다.

해석 포인트

• front matter에서 값을 바꾸면 모든 참조가 같이 바뀝니다.
• nested param은 큰 설정 구조를 문서 안에서 재사용할 때 특히 좋습니다.
• 값이 없을 때 오류를 내므로, 키 이름을 실수로 바꾸면 바로 잡아낼 수 있습니다.

실무 팁

• 제품명, 버전, 배지, 분류명처럼 반복되는 문자열에 적합합니다.
• 문서 제목과 본문이 서로 어긋나지 않게 유지하려면 param이 유용합니다.
• 단순 치환만 할 수 있으므로, 복잡한 조건 분기는 shortcode보다 template 쪽이 낫습니다.