예제
KO

validate

콘텐츠 파일의 프론트 매터 완결성, 접근성, 구조 정합성을 검증합니다.

# 모든 콘텐츠 파일 검증
hwaro tool validate

# 특정 콘텐츠 디렉터리 검증
hwaro tool validate -c posts

# 경고도 CI 실패로 처리하거나, 허용 경고 수 상한 지정
hwaro tool validate --strict
hwaro tool validate --max-warnings 5

# JSON으로 출력
hwaro tool validate --json

옵션

플래그 설명
-c, --content-dir DIR 콘텐츠 디렉터리 (기본값: content)
--strict 종료 코드 계산 시 경고를 오류로 취급
--max-warnings N 경고 수가 N을 넘으면 0이 아닌 코드로 종료 (기본값: 무제한)
-j, --json 결과를 JSON으로 출력
-h, --help 도움말 표시

검사 항목

출력 예시

hwaro: validate content

content/blog/draft.md:
      [warn] Missing description in frontmatter
      [info] File is marked as draft

content/about.md:
      [warn] Image missing alt text: ![](photo.jpg)
      [info] Tag has mixed case: "Crystal" (consider lowercase)

checked: 0 errors, 2 warnings, 2 info

색상 터미널에서는 발견 항목이 hwaro validate 헤딩 아래 ⚠/✗/ℹ 기호로 표시되고, 마지막 줄은 심각도별 색이 입혀진 ✦ checked 결과입니다. 오류 수준 문제가 발견되면 0이 아닌 종료 코드를 반환하므로 CI 게이트로 쓸 수 있습니다.

종료 코드는 hwaro doctor와 같은 규칙을 따릅니다. 오류 수준 발견은 콘텐츠 오류 코드(5)로, --strict/--max-warnings로 인한 경고 기반 실패는 일반 코드(1)로 종료되어 파일 자체의 문제와 게이트 강화로 인한 실패를 구분할 수 있습니다. 두 플래그는 --json 실행에도 동일하게 적용됩니다.

규칙 ID

ID 수준 설명
content-title-missing warning title이 없거나 "Untitled"임
content-description-missing warning description 누락
content-alt-text-missing warning 대체 텍스트가 없는 이미지
content-internal-link-broken warning 깨진 @/ 내부 링크
content-date-invalid warning 인식할 수 없는 날짜 형식
content-frontmatter-toml-error error TOML 프론트 매터 파싱 오류
content-frontmatter-yaml-error error YAML 프론트 매터 파싱 오류
content-frontmatter-json-error error JSON 프론트 매터 파싱 오류
content-read-error error 콘텐츠 파일 읽기 실패
content-tag-mixed-case info 대소문자가 섞인 태그
content-draft info 초안으로 표시된 파일

JSON 출력

{
  "findings": [
    {
      "file": "content/blog/draft.md",
      "line": null,
      "rule": "content-description-missing",
      "severity": "warning",
      "message": "Missing description in frontmatter"
    }
  ]
}