Repository navigation
Description
배경
쉬운 정보에서 그림은 장식이 아닙니다. 글을 읽기 어려운 사람은 그림을 먼저 보고
뜻을 잡습니다. 또박은 낱말을 픽토그램에 연결해 쉬운본 옆에 함께 보여줍니다.
지금 렉시콘은 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.pyassets/pictograms/·assets/README.mdTHIRD_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
[-]픽토그램 렉시콘 넓히기 (현재 33개 낱말)[/-][+]픽토그램 렉시콘 넓히기 (현재 32개 낱말)[/+]needsbuilder commentedon Aug 25, 2026
제목의 낱말 수를 33 → 32 로 고쳤습니다. 실제 값이 32 였습니다(
len(LEXICON) == 32,PR #21). 문서와 코드가 어긋나 있었습니다.
라이선스 제약이 이 이슈의 핵심입니다. 픽토그램은 CC BY-SA 세트(Mulberry·OpenMoji)를
쓰는데, Apache-2.0 코드 트리와 반드시 분리돼야 합니다:
scripts/check_assets_separation.py가 CI 에서 이걸 검사합니다 — 위반하면 빌드가 깨집니다수용 기준
ttobak/pictogram/lexicon.py에 낱말 추가 + 출처 세트 표기NOTICE의 픽토그램 귀속에 새 출처가 있으면 함께 추가python -m tooling.check_licenses --root .통과공공·행정 문서에서 자주 나오는데 지금 빠진 개념(예: 이의신청, 감면, 소득인정액)부터
채우면 실제 변환 품질에 바로 도움이 됩니다.