Repositories

GEUL의 공개 저장소는 geul-org GitHub 조직에 있다. 문법 명세는 이 사이트의 GEUL 문법이 정본이다.

GEUL 문서는 16비트 WORD의 연속이다. 데이터의 단위는 TAG WORD 하나로 시작하는 레코드이고, 레코드들은 문서 하나에 담긴다. 문서는 Issuer가 내고, 버전마다 내용 해시로 고정된다. 아래 저장소들은 이 문서를 쓰고, 읽고, 옮기고, 찾고, 세는 도구와 한국어 분석기다.


라이브러리

gogeul

GEUL Go 라이브러리와 geul 명령줄 도구.

GEUL 문서(.geul)를 쓰고, 읽고, 검사하고, 공표한다. 형식 검사, Codec 규격 문서로 레코드 해석, 버전 diff, IMPORT 의존 해석, TOULMIN Codec을 패키지로 제공한다. geul CLI는 문서 편집(new, add)과 공표(publish), 조회(ls, log, show, diff, check), 브라우저 뷰어(serve, build), pack 아카이브(pack build, pack unpack)를 다룬다. pack 아카이브는 레코드를 zstd로 압축해 저장할 수 있다.

GitHubgeul-org/gogeul
언어Go
라이선스CC0

위키데이터

wikigeul

위키데이터 → GEUL 변환(옛 이름 gogeulwiki).

위키데이터 JSON 덤프를 바로 읽어 항목·속성마다 GEUL 문서 하나를 낸다. 레이블, 설명, 별칭, 한정자와 출처가 붙은 진술, 사이트링크를 모든 언어로 담는다. 모든 문서는 Issuer wikidata.geul.org(0x00000001) 아래 공표된다.

GitHubgeul-org/wikigeul
언어Go
라이선스CC0

wikipg

위키데이터 JSON 덤프 → PostgreSQL 무손실 적재. 2026-11-03부터 쓰지 않는다(deprecated). 덤프를 바로 읽는 wikigeul을 쓴다.

개체, 레이블, 설명, 별칭, 진술, 한정자, 출처, 사이트링크, Lexeme을 덤프 순서대로 저장하고, 덤프의 모든 줄을 원문 그대로 보존한다. 덤프 자체(파일, URL, 크기, 체크섬, 적재기 커밋)도 기록한다. wikipg는 GEUL에 의존하지 않는다.

GitHubgeul-org/wikipgeul
언어Go
라이선스CC0

탐색

silk

SILK — GEUL 전용 색인·탐색 엔진.

GEUL pack 아카이브의 레코드를 파티션·정렬 색인으로 만들어, 문서를 모두 디코드하지 않고 “직업(P106)이 물리학자(Q169470)라고 진술한 문서는?” 같은 질의에 답한다. 코덱북 없이 TAG WORD만으로 레코드와 필드를 가른다. 초기 개발 단계로, 탐색 알고리즘을 검증하고 있으며 첫 릴리스 전까지 형식이 바뀔 수 있다.

GitHubgeul-org/silk
언어Go
라이선스CC0

통계

statistics

GEUL pack 아카이브의 TAG 사용량을 Issuer별로 센다.

TAG WORD에서 Length만 뺀 9비트 코드(TAG ID 0x000L~0x1FFL)마다 레코드 수를 센다. 아카이브 폴더나 pack 세트 폴더를 여러 개 주면 합쳐 센다.

GitHubgeul-org/statistics
언어Go
라이선스CC0

한국어

koparse

한국어 분석기.

어절에서 명사와 조사·어미를 떼어 내는 일부터 시작해, 필요하면 형태소 분석기로 키운다. 기존 형태소 분석기·사전을 가져다 쓰지 않고 직접 만들며, 사전은 CC0 원천(위키데이터 라벨·Lexeme)과 자체 생성 자료만 쓴다. 초기 개발 단계다.

GitHubgeul-org/koparse
언어Go
라이선스CC0

코드북 (v1 이전)

아래 두 저장소는 현행 v1 문법 이전에 설계한 자료다. 현 문법과 맞지 않는 부분이 있다.

sidx

SIDX(Semantic-aligned Index) 배정 연구.

의미가 가까운 개체에 가까운 번호를 주는 의미 주소 SIDX를 위키데이터 사용 통계로 배정하려는 연구 자료다. 옛 Entity 48비트 속성 스키마, 인코더 스크립트, 코드북을 담고 있으며, 아직 SIDX 배정 결과는 없다. SIDX의 규범 정의는 문법의 GEUL-SIDX다.

GitHubgeul-org/sidx
언어Python
라이선스CC0

wordnet-verb

WordNet 3.0 기반 동사 16비트 코드북 임시판.

WordNet 3.0의 동사 synset 13,767개에 16비트 코드를 하나씩 주고, 뜻이 가까운 동사에 가까운 코드를 준다. WordNet을 쓰지 않는 코드북으로 대체할 임시판이며, 코드를 GEUL 레코드에 어떻게 담을지는 정하지 않았다.

WordNet에서 파생한 자료가 들어 있어 CC0 산출물이 아니다. WordNet 파생 부분은 WordNet 3.0 License를 따르고, 코드와 분류 같은 GEUL 프로젝트 고유 부분만 CC0다.

GitHubgeul-org/wordnet-verb
언어Python
라이선스WordNet 3.0 License(파생 부분) · CC0(고유 부분)

웹사이트

geul-org

이 웹사이트 geul.org의 소스.

Hugo 정적 사이트로 12개 언어를 지원하며, S3 + CloudFront로 배포한다.

GitHubgeul-org/geul-org
언어Hugo
라이선스CC0