Skip to content

픽토그램 렉시콘 넓히기 (현재 32개 낱말) #9

Open

Description

@needsbuilder

배경

쉬운 정보에서 그림은 장식이 아닙니다. 글을 읽기 어려운 사람은 그림을 먼저 보고
뜻을 잡습니다. 또박은 낱말을 픽토그램에 연결해 쉬운본 옆에 함께 보여줍니다.

지금 렉시콘은 33개뿐입니다 (ttobak/pictogram/lexicon.py). 공공·행정 문서에
자주 나오는데 아직 없는 낱말이 많습니다.

할 일

_RAW 사전에 항목을 추가합니다. 형식은 이렇습니다.

"신청": ("openmoji", "openmoji/apply.svg", "신청"),
#  낱말    세트 이름    글리프 경로              쉬운 말 설명

없어 보이는 낱말 예시 (이 목록에 매일 필요는 없습니다):
교육 · 상담 · 지원금 · 신분증 · 우편 · 대상자 · 자격 · 취소 · 변경 · 확인 ·
장애인 · 노인 · 어린이 · 통장 · 버스 · 지하철

규칙 — 라이선스가 걸려 있습니다

이 저장소는 세 라이선스를 절대 섞지 않습니다. 픽토그램은 CC BY-SA 이고
코드는 Apache-2.0 입니다.

  • 글리프 파일은 반드시 assets/pictograms/<세트>/ 아래에만 둡니다
  • 코드에는 경로 참조만 씁니다. base64 로 그림을 코드나 데이터에 박아 넣으면
    CI(scripts/check_assets_separation.py)가 빌드를 깨뜨립니다
  • 새 세트를 들여오면 THIRD_PARTY_LICENSES.md 와 NOTICE 도 갱신해야 합니다
    (tests/tooling/test_notice_coverage.py 가 검사합니다)

쓰는 세트는 두 가지입니다. Mulberry Symbols 는 일상적·구체적 개념에 강하고,
추상적인 행정 개념(세금·보험·기한 같은)은 대체로 없습니다. 그런 낱말은
OpenMoji 를 씁니다. 자세한 판단 근거는 lexicon.py 상단 주석과
assets/pictograms/openmoji/ATTRIBUTION.md 에 적어 뒀습니다.

한 가지 더 — 그림은 서로 구별되어야 합니다

과거에 돈·계좌·은행 이 전부 같은 은행 건물 그림으로 렌더된 적이 있습니다.
캡션은 달랐지만 그림이 같아서, 그림에 의존하는 사람에게는 셋이 구분되지 않았습니다.
비슷한 낱말을 추가할 때는 글리프가 실제로 달라 보이는지 확인해 주세요.

테스트

python -m pytest tests/pictogram -q
python -m tooling.check_licenses --root .   # 라이선스·자산 분리 게이트

관련 파일

  • ttobak/pictogram/lexicon.py
  • assets/pictograms/ · assets/README.md
  • THIRD_PARTY_LICENSES.md · NOTICE

EN — The pictogram lexicon covers only 33 words. Add more high-frequency
Korean public/admin concepts. Glyphs must stay under assets/pictograms/ (CC BY-SA)
and be referenced by path only — inlining base64 into code or data breaks the CI
license gate. Prefer OpenMoji for abstract admin concepts; Mulberry lacks them.
Make sure related words don't collapse to visually identical glyphs.

Activity

  1. changed the title [-]픽토그램 렉시콘 넓히기 (현재 33개 낱말)[/-] [+]픽토그램 렉시콘 넓히기 (현재 32개 낱말)[/+] on Aug 25, 2026
  2. needsbuilder commented on Aug 25, 2026

    @needsbuilder
    OwnerAuthor

    제목의 낱말 수를 33 → 32 로 고쳤습니다. 실제 값이 32 였습니다(len(LEXICON) == 32,
    PR #21). 문서와 코드가 어긋나 있었습니다.

    라이선스 제약이 이 이슈의 핵심입니다. 픽토그램은 CC BY-SA 세트(Mulberry·OpenMoji)를
    쓰는데, Apache-2.0 코드 트리와 반드시 분리돼야 합니다:

    • 렌더러는 픽토그램을 파일 경로·URL 참조로만 씁니다
    • 수정된 글리프를 inline 이나 base64 로 코드·데이터 출력에 박으면 안 됩니다
    • scripts/check_assets_separation.py 가 CI 에서 이걸 검사합니다 — 위반하면 빌드가 깨집니다
    • ARASAAC·KAAC 는 NC(비상업) 라 받을 수 없습니다

    수용 기준

    • ttobak/pictogram/lexicon.py 에 낱말 추가 + 출처 세트 표기
    • NOTICE 의 픽토그램 귀속에 새 출처가 있으면 함께 추가
    • python -m tooling.check_licenses --root . 통과

    공공·행정 문서에서 자주 나오는데 지금 빠진 개념(예: 이의신청, 감면, 소득인정액)부터
    채우면 실제 변환 품질에 바로 도움이 됩니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions