• 한국어 (한글)
    • Rust
    JSR

      HTML 처리

      HTML 문서나 단편을 변환하려면 -f text/html을 넘기거나 .html/.htm 확장자를 사용합니다. Gukhanmun은 HTML을 해석하여 텍스트 노드와 속성 속의 한자를 변환하고, 모든 태그와 속성을 보존하면서 결과를 다시 HTML로 직렬화합니다.

      항상 보존되는 요소

      Gukhanmun은 다른 어떤 설정과도 무관하게 다음 요소 안의 내용을 결코 수정하지 않습니다:

      • <code>, <kbd>, <pre>, <samp>: 코드와 미리 정형된 텍스트
      • <script>, <style>: 스크립트와 스타일시트
      • <textarea>: 사용자 입력 영역
      • translate="no"를 가진 요소: 명시적 제외

      <ruby> 주석 안의 내용도 그대로 둡니다.

      CSS 클래스로 추가 요소 보존

      특정 클래스를 가진 요소 안의 변환을 건너뛰려면 --html-preserve-class를 사용합니다. 이 플래그는 반복할 수 있습니다:

      gukhanmun -f text/html \
  --html-preserve-class math \
  --html-preserve-class no-translate \
  input.html

      그 클래스 중 하나를 가진 요소(와 그 모든 후손)는 변경 없이 통과됩니다.

      속성으로 요소 보존

      속성 이름 하나만으로, 또는 attribute=value 쌍으로 변환을 건너뛰려면 --html-preserve-attr을 사용합니다. 이 플래그는 반복할 수 있습니다:

      gukhanmun -f text/html \
  --html-preserve-attr data-no-hanja \
  --html-preserve-attr lang=en \
  input.html

      첫 번째 형태는 그 속성을 가진 임의의 요소를(값과 무관하게) 일치시킵니다. 두 번째 형태는 속성이 주어진 값과 같은 요소만 일치시킵니다.

      루비 마크업

      변환을 <ruby> 요소로 감싸려면 -f text/html을 --rendering ruby-on-hangul이나 --rendering ruby-on-hanja와 결합합니다:

      echo "<p>漢字</p>" | gukhanmun -f text/html --rendering ruby-on-hangul
# → <p><ruby>한자<rp>(</rp><rt>漢字</rt><rp>)</rp></ruby></p>

      주석은 <rp>(ruby parenthesis) 요소로 감싸집니다. <ruby>를 이해하는 브라우저는 <rp> 내용을 숨기고 독음을 기저 위에 쌓아 렌더링합니다; <ruby>를 지원하지 않는 브라우저는 괄호로 묶인 병기를 인라인으로(한자(漢字)) 보이는 것으로 퇴화하여, 출력이 어디서나 읽을 수 있게 유지됩니다.