Skip to main content

romanize

문자열 전체를 로마자로 변환하는 편의 함수입니다. 기본 revised 모드는 국립국어원 국어의 로마자 표기법의 주요 규칙을 구현합니다. 어휘 사전이나 형태소 분석기를 포함하지 않으므로 모든 단어의 규정 표기를 보장하지는 않습니다. ㄴ 첨가는 지원하는 어휘와 조사 결합에 적용하며, 금요일처럼 첨가 대상이 아닌 단어에는 임의로 ㄴ을 넣지 않습니다.

Romanizer

여러 문자열을 같은 규칙으로 반복 변환할 때 쓰는 클래스입니다.

메서드

revised 모드

  • general: 일반 문자열 기준, 발음 변화를 반영한 기본 모드
  • proper: 고유 명사에서 ㄱ, ㄷ, ㅂ + ㅎ 예외를 다루는 모드
  • name: 인명처럼 내부 음운 변화를 반영하지 않고 적는 모드
  • admin: -do, -si, -gun 같은 행정 구역 단위를 붙임표와 함께 적는 모드
추가 옵션은 아래처럼 활용할 수 있습니다.
  • capitalize=True: 각 단어 첫 글자를 대문자로 변환
  • disambiguate=True: 혼동 방지용 붙임표 사용
  • name_hyphen=True: 인명 모드에서 이름 음절 사이에 붙임표 사용
  • admin_omit_suffix=True: 행정 구역 모드에서 , , 생략
생략 가능한 인수는 모두 아래처럼 동작합니다.
  • system 생략 시: revised
  • mode 생략 시: general
  • capitalize 생략 시: False
  • disambiguate 생략 시: False
  • name_hyphen 생략 시: False
  • admin_omit_suffix 생략 시: False
같은 기본값이 Romanizer(...) 생성자에도 그대로 적용됩니다.

지원 규칙

  • revised
  • mr
  • mccune
  • yale
  • academic

system별 예시와 결과

mode별 예시와 결과

옵션별 예시와 결과

예시

규정 예시와 대응

주의할 점

  • general 은 일반 문자열용입니다.
  • 인명, 행정 구역, 일부 고유 명사는 규정의 예외가 있으므로 mode 를 맞춰 쓰는 편이 정확합니다.
  • capitalize=True 를 주면 각 단어의 첫 글자를 대문자로 바꿉니다.
  • disambiguate=True 를 주면 중앙 -> jung-ang, 세운 -> se-un처럼 혼동을 줄이기 위한 붙임표를 넣을 수 있습니다.
  • name_hyphen=True 를 주면 Min Yongha 대신 Min Yong-ha처럼 적을 수 있습니다.
  • admin_omit_suffix=True 를 주면 Cheongju-si 대신 Cheongju처럼 적을 수 있습니다.

같이 보기