Home /Modules/docs/README.KR.md

README.KR.md

docs/i18n/README.KR.md · 504 line(s) · markdown

<img align="right" src="../../images/sleela/sleela-medium-profile-permanent-icon-002.jpg" width="45" height="45" alt="SLeeLa">

SLeeLa 3.0 — 대한민국 (KR)

<p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>

<p align="center"><strong>네이티브 시스템 언어, 컴파일러, 런타임 및 가상 머신 생태계.</strong></p> <p align="center"><a href="https://github.com/mearvk/SLeeLa/actions"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/mearvk/SLeeLa/test-suite.yml?branch=main&label=test%20suite"></a> <a href="../../docs/PLATFORM-SUPPORT.md"><img alt="Platform matrix" src="https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-273238"></a></p>

국가별 국제판(한국어). 이 파일은 한국어 국가별 에디션으로, README의 I~XIX 섹션을 한국어로 제공합니다. 기술 식별자, 명령, 코드, 파일명 및 링크는 원문 그대로 유지합니다.

The Now. The Ingredient. 프로그래밍 언어는 문법만으로 이루어지지 않습니다. 소프트웨어를 실제로 사용할 수 있게 하는 컴파일러, 런타임, 라이브러리, 도구 및 플랫폼 계약도 언어의 일부입니다.

SLeeLa의 활동 영역. SLeeLa는 Math, Object, Science, Reach라는 네 가지 측면을 다룹니다. Math는 계산 가능한 것, Object는 존재하는 것의 목록에 자리 잡은 확정된 대상, Science는 진리에 대한 체계적인 연구, Reach는 시스템의 기능을 다른 시스템과 사람들에게 확장하는 것을 뜻합니다. 국가적 이익은 계속 유지됩니다. 네 영역 중 어느 것도 국가적 이익을 배제하지 않습니다. 어떤 주제가 한 국가의 이익과 관련되면 그 관계를 보존하며, 예를 들어 각 클래스의 Metadata 필드인 metaOrigin 및 metaNationalSchedule에 충실하게 기록합니다.

I. 시작하기

II. 최근 추가 사항

언어, 드라이버 및 표준 라이브러리에 최근 추가된 기능:

III. 빌드 및 테스트

필수 항목: GCC 또는 Clang과 같은 C/C++ 도구체인, GNU Make, 매니페스트 및 흐름 도구용 Python 3가 필요합니다. Linux에서 디스플레이 제품을 빌드하려면 X11/Xrandr 개발 패키지도 필요합니다(각 모듈의 make deps가 필요한 의존성을 보고하거나 설치합니다). impl/ 빌드는 신뢰된 SHA-256 매니페스트를 충족하지 못하면 실패하도록 설계되어 있으며, 루트 Makefile이 해당 매니페스트를 자동으로 참조합니다.

깨끗한 체크아웃에서 가장 빠르게 시작하려면 다음을 실행합니다.

make                                  # 저장소 루트에서 전체 빌드

네이티브 핵심만 빌드하고 테스트하려면 다음을 실행합니다.

make -C impl all                      # 핵심 컴파일러/런타임만 빌드
bash ./test-suites/run-all.sh --all   # 전체 테스트 스위트 실행

저장소 루트의 make는 코어, VM, 코덱, churn, antivirus 등을 포함한 모든 제품을 빌드하고 마지막에 레지스트리를 빌드하여 기준 테이블을 생성합니다. 주요 타깃은 다음과 같습니다.

make                     # 전체 빌드(make all의 별칭이며 레지스트리는 마지막에 실행)
make all                 # 동일한 전체 빌드를 명시적으로 실행
sudo make install        # 명령 및 런타임 지원 파일 설치(§IV 참조)
make clean               # 각 빌드 시스템의 생성물 제거
make help                # 루트 Makefile의 모든 타깃 표시

그 밖의 유용한 타깃:

make registry            # 레지스트리만 빌드하고 테이블 생성
./build-registry.sh      # 동일한 작업을 스크립트로 직접 실행
make tests               # 테스트 스위트 빌드 및 실행
make ballum              # 현재 운영체제용 Ballum 디스플레이 라이브러리 빌드
bin/install-modules      # 각 모듈을 단계적으로 설치/빌드(약 10~20분)

registry 타깃은 build-registry.sh를 실행합니다. 레지스트리 코어를 빌드하고 기준 테이블을 이식 가능한 텍스트 저장소 registry/build/sleela.sleelareg에 채운 다음, sleela registry export를 통해 MySQL 테이블 스크립트 registry/build/registry.sql을 내보냅니다. sleela registry 또는 registry/build/sleela-registry review로 검토할 수 있습니다. 레지스트리 안내서와 Registry 3.0 아키텍처를 참조하세요.

빌드 및 테스트 안내서에서 필수 조건과 플랫폼별 절차를 확인하세요. 한 구성요소의 빌드 성공이 모든 라이브러리와 플랫폼의 릴리스 준비 완료를 의미하지는 않습니다.

IV. 설치

네이티브 제품을 빌드한 후 명령과 런타임 지원 파일을 설치합니다.

sudo make install
make install PREFIX="$HOME/.local"       # sudo 없는 사용자 로컬 설치
make install DESTDIR="$PWD/package-root" # 패키지 스테이징 설치
make install-check

기본 설치 경로는 /usr/local/bin, /usr/local/lib/sleela, /usr/local/share/sleela입니다. 기존 시작 설정을 보존하고 추적되지 않는 기존 명령을 덮어쓰지 않습니다. 제거 작업은 설치 프로그램이 기록한 파일만 삭제하며 설정과 추적되지 않는 런타임 데이터는 보존합니다.

주요 패키지(sleela, sleelvac, nordshrift 실행 파일, 표준 라이브러리, 프로토콜 및 지원 모듈)만 안내에 따라 설치하려면 다음을 사용합니다.

make clean-install       # 주요 패키지만 안내형 설치

이 절차는 먼저 주요 패키지 설치 여부를 묻고, 다음으로 설치 범위를 선택하며, 성공 후에는 엄선된 확장 모듈을 선택적으로 설치할 수 있게 합니다. 대화형 배포 절차와 모든 설치 옵션은 Quick and Safe Install을 참조하세요.

V. 언어 및 런타임

공식 문법은 SLEELA.syntax에 정의되어 있습니다. 저장소가 문서화하는 현재 문법 버전은 3.0입니다. 컴파일러/도구 버전과 소스 문법 버전은 서로 다릅니다. 문법 3.0에는 pure 및 gasoline 문서 마커(§30)가 추가되었습니다. 두 마커는 문서의 지위를 각자의 정직성에 따라 나타내는 문맥 의존적 선언형 Preonem입니다. 문법 3.0은 1.0~2.9의 언어 표면을 통합하면서 각 기능별 최소 버전 조건을 유지합니다. 이전 2.9 버전에는 @mix 연속 필드(§28)가 추가되어, 같은 이름의 인스턴스 필드 여러 개를 하나의 인덱스 그룹으로 취급할 수 있습니다(기본 1,2,3,… 또는 그룹 필드 수와 일치하는 @mix(1,2,3,...)). 또한 long/int64/int128(§21)을 바탕으로 한 부호 있는 정수 계열 int32~int16777216(§24)과 부호 없는 정수 계열 uint32~uint16777216(§25), 키워드 지원 문서(§22), 그리고 Preonems가 이어집니다. Preonems에는 author/authorial(§18), material/memory(§19~§20), determine(§23), object/field(§26), pure/gasoline(§30), 시간과 공간에 걸쳐 입법부 수준의 지위를 나타내는 artifact(§35)가 포함됩니다. 전체 명칭 Preonems는 §26.1에 정의되어 있습니다. 생성자 오버로드 해석과 this(...)/기반 클래스 생성자 위임은 검증된 문법 1.8 계약의 범위 밖입니다. 기능에 의존하기 전에 문법 및 구현 참고 자료를 확인하세요. SleelaDoc의 아홉 소스 단위는 현재 #sleela 3.0을 선언하며, 공통 컴파일러 게이트는 소스 문법 1.0~3.0을 허용합니다. 새 API 빌드는 make api-docs로 생성됩니다.

저장소에는 네이티브 C/C++ 구현, SLVM 생성 참조, 표준 라이브러리 모듈, 테스트, 예제 및 플랫폼 통합이 포함되어 있습니다. 구현 및 검증 상태는 모듈마다 다릅니다. 모든 모듈이 동일하게 완전하다고 가정하지 말고 해당 사양과 현재 CI 결과를 확인하세요.

VI. 엔지니어링 원칙

VII. Antivirus 빌드 및 무결성

Sleelavirin antivirus 패키지에는 네이티브 SHA-256 스캐너, 선택적 ClamAV 어댑터, 소스/색인 무결성 매니페스트 및 플랫폼 패키지 체크섬이 포함됩니다. 저장소 루트에서 실행합니다.

make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json

무결성 매니페스트는 antivirus/build/에 생성되며 추적되는 소스와 문서, 보호된 서명 색인 파일을 포함합니다. 생성된 출력물과 변경 가능한 ClamAV 캐시는 제외합니다. ClamAV 데이터베이스 스냅샷에는 별도 매니페스트가 있습니다. 릴리스 ZIP에는 INTEGRITY-MANIFEST.json, SHA256SUMS, .sha256 사이드카 파일이 포함됩니다. 다운로드한 아카이브의 해시는 독립적으로 확보한 신뢰 가능한 값과 대조해야 합니다. 아카이브와 함께 저장된 체크섬은 게시자 서명이 아닙니다. 자세한 내용은 Sleelavirin 안내서, 보안 체크리스트, antivirus 빌드 워크플로를 참조하세요. 해당 CI 작업이 정확한 릴리스 커밋에서 통과하고 결과 아티팩트가 검사되기 전에는 릴리스를 검증된 것으로 간주하지 않습니다.

VIII. SLeeLa 편집기 테마 — Vim 및 Emacs

SLeeLa에는 Vim과 Emacs용으로 조정된 전문 다크 테마와 네이티브 C/C++ 팔레트 유틸리티가 포함됩니다. 기본 테마는 American Professional입니다. 문화적·제도적 디자인에서 영감을 얻은 보조 팔레트 10종도 제공되지만, 어떤 국가·문화·법원·기관의 공식 표현도 아닙니다.

11개 스킴과 색상

스킴배경전경키워드타입문자열주석
American Professional<span style="display:inline-block;width:1em;height:1em;background:#101820;border:1px solid #888"></span> #101820<span style="display:inline-block;width:1em;height:1em;background:#F4F7FA;border:1px solid #888"></span> #F4F7FA<span style="display:inline-block;width:1em;height:1em;background:#7FB3FF;border:1px solid #888"></span> #7FB3FF<span style="display:inline-block;width:1em;height:1em;background:#73DACA;border:1px solid #888"></span> #73DACA<span style="display:inline-block;width:1em;height:1em;background:#F2C078;border:1px solid #888"></span> #F2C078<span style="display:inline-block;width:1em;height:1em;background:#8A96A3;border:1px solid #888"></span> #8A96A3
Pan-Eurasian<span style="display:inline-block;width:1em;height:1em;background:#111827;border:1px solid #888"></span> #111827<span style="display:inline-block;width:1em;height:1em;background:#F0F2F5;border:1px solid #888"></span> #F0F2F5<span style="display:inline-block;width:1em;height:1em;background:#7AA7E8;border:1px solid #888"></span> #7AA7E8<span style="display:inline-block;width:1em;height:1em;background:#69C9B3;border:1px solid #888"></span> #69C9B3<span style="display:inline-block;width:1em;height:1em;background:#D7B56D;border:1px solid #888"></span> #D7B56D<span style="display:inline-block;width:1em;height:1em;background:#8995A5;border:1px solid #888"></span> #8995A5
Russian and Slavic — Medium<span style="display:inline-block;width:1em;height:1em;background:#202733;border:1px solid #888"></span> #202733<span style="display:inline-block;width:1em;height:1em;background:#E8EAF0;border:1px solid #888"></span> #E8EAF0<span style="display:inline-block;width:1em;height:1em;background:#A9C0DD;border:1px solid #888"></span> #A9C0DD<span style="display:inline-block;width:1em;height:1em;background:#8FC4B2;border:1px solid #888"></span> #8FC4B2<span style="display:inline-block;width:1em;height:1em;background:#D6BD8B;border:1px solid #888"></span> #D6BD8B<span style="display:inline-block;width:1em;height:1em;background:#9AA3AF;border:1px solid #888"></span> #9AA3AF
Central Asian / Silk Road<span style="display:inline-block;width:1em;height:1em;background:#1C2529;border:1px solid #888"></span> #1C2529<span style="display:inline-block;width:1em;height:1em;background:#F5F0E5;border:1px solid #888"></span> #F5F0E5<span style="display:inline-block;width:1em;height:1em;background:#7FADE0;border:1px solid #888"></span> #7FADE0<span style="display:inline-block;width:1em;height:1em;background:#45C6C2;border:1px solid #888"></span> #45C6C2<span style="display:inline-block;width:1em;height:1em;background:#D9B56D;border:1px solid #888"></span> #D9B56D<span style="display:inline-block;width:1em;height:1em;background:#92A3A0;border:1px solid #888"></span> #92A3A0
East Asian<span style="display:inline-block;width:1em;height:1em;background:#171A1C;border:1px solid #888"></span> #171A1C<span style="display:inline-block;width:1em;height:1em;background:#F2EFE7;border:1px solid #888"></span> #F2EFE7<span style="display:inline-block;width:1em;height:1em;background:#D97878;border:1px solid #888"></span> #D97878<span style="display:inline-block;width:1em;height:1em;background:#72C7A5;border:1px solid #888"></span> #72C7A5<span style="display:inline-block;width:1em;height:1em;background:#D8B76A;border:1px solid #888"></span> #D8B76A<span style="display:inline-block;width:1em;height:1em;background:#969F9B;border:1px solid #888"></span> #969F9B
ICC — International Criminal Court<span style="display:inline-block;width:1em;height:1em;background:#0E1A2B;border:1px solid #888"></span> #0E1A2B<span style="display:inline-block;width:1em;height:1em;background:#EAF0F7;border:1px solid #888"></span> #EAF0F7<span style="display:inline-block;width:1em;height:1em;background:#5B8FD6;border:1px solid #888"></span> #5B8FD6<span style="display:inline-block;width:1em;height:1em;background:#7FB7C9;border:1px solid #888"></span> #7FB7C9<span style="display:inline-block;width:1em;height:1em;background:#D9B25A;border:1px solid #888"></span> #D9B25A<span style="display:inline-block;width:1em;height:1em;background:#7E8CA0;border:1px solid #888"></span> #7E8CA0
SCOTUS — U.S. Supreme Court<span style="display:inline-block;width:1em;height:1em;background:#1A1416;border:1px solid #888"></span> #1A1416<span style="display:inline-block;width:1em;height:1em;background:#F3EEE6;border:1px solid #888"></span> #F3EEE6<span style="display:inline-block;width:1em;height:1em;background:#9E2B35;border:1px solid #888"></span> #9E2B35<span style="display:inline-block;width:1em;height:1em;background:#8FA9B8;border:1px solid #888"></span> #8FA9B8<span style="display:inline-block;width:1em;height:1em;background:#C9A24B;border:1px solid #888"></span> #C9A24B<span style="display:inline-block;width:1em;height:1em;background:#8C8178;border:1px solid #888"></span> #8C8178
Greek (Hellenic)<span style="display:inline-block;width:1em;height:1em;background:#0A1A30;border:1px solid #888"></span> #0A1A30<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#2E7BD6;border:1px solid #888"></span> #2E7BD6<span style="display:inline-block;width:1em;height:1em;background:#5E9FE0;border:1px solid #888"></span> #5E9FE0<span style="display:inline-block;width:1em;height:1em;background:#9FC3EC;border:1px solid #888"></span> #9FC3EC<span style="display:inline-block;width:1em;height:1em;background:#6E86A6;border:1px solid #888"></span> #6E86A6
Turkish (Al Bayrak)<span style="display:inline-block;width:1em;height:1em;background:#2A0609;border:1px solid #888"></span> #2A0609<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#F23D48;border:1px solid #888"></span> #F23D48<span style="display:inline-block;width:1em;height:1em;background:#F0A9AE;border:1px solid #888"></span> #F0A9AE<span style="display:inline-block;width:1em;height:1em;background:#F0C9A9;border:1px solid #888"></span> #F0C9A9<span style="display:inline-block;width:1em;height:1em;background:#A8767A;border:1px solid #888"></span> #A8767A
Kiro<span style="display:inline-block;width:1em;height:1em;background:#0B0B12;border:1px solid #888"></span> #0B0B12<span style="display:inline-block;width:1em;height:1em;background:#F5F5FA;border:1px solid #888"></span> #F5F5FA<span style="display:inline-block;width:1em;height:1em;background:#A98EDA;border:1px solid #888"></span> #A98EDA<span style="display:inline-block;width:1em;height:1em;background:#6E8BE0;border:1px solid #888"></span> #6E8BE0<span style="display:inline-block;width:1em;height:1em;background:#E8C547;border:1px solid #888"></span> #E8C547<span style="display:inline-block;width:1em;height:1em;background:#6A6482;border:1px solid #888"></span> #6A6482
SLeeLa<span style="display:inline-block;width:1em;height:1em;background:#08080E;border:1px solid #888"></span> #08080E<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#B07CFF;border:1px solid #888"></span> #B07CFF<span style="display:inline-block;width:1em;height:1em;background:#5A7CFF;border:1px solid #888"></span> #5A7CFF<span style="display:inline-block;width:1em;height:1em;background:#FFD21E;border:1px solid #888"></span> #FFD21E<span style="display:inline-block;width:1em;height:1em;background:#6E5F9E;border:1px solid #888"></span> #6E5F9E

국가 국기 색상(기준 팔레트)

Greek 및 Turkish 스킴은 두 나라의 공식 국기 색상에서 유래했으며, 공표된 정확한 16진수 값과 함께 표시합니다. 위 스킴의 배경/강조색은 이 원래 색상을 어둡게 하여 편집기에 맞게 해석한 것이며, 아래 표는 "국가적으로 공표된 색상" 참조입니다.

국가색상16진수근거 및 의미
그리스Blue<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAF국기의 파랑(법률 851/1978). 하늘과 바다를 뜻하며 문장학상 azure로 기술됩니다.
그리스White<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF국기의 흰색. 독립 투쟁의 순수함을 뜻하고 십자가는 동방 정교회를 나타냅니다.
TürkiyeRed(al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17국기의 빨강(터키 국기법). 바탕색이며 전통적으로 순교자의 피와 오스만 주권을 뜻합니다.
TürkiyeWhite<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF국기의 흰색. 초승달과 별은 평화, 순수함, 튀르크/이슬람 유산의 상징입니다.

각 스킴은 편집기 전경색을 국가의 흰색에, 키워드·커서·선택 영역·상태 표시줄을 정확한 국가 파랑(#0D5EAF) 또는 빨강(#E30A17)에 고정하므로, 중요한 색상은 말 그대로 국가의 색입니다. 이는 해석에 따른 디자인 팔레트이며, 국기 색상 참조는 출처를 밝히기 위해 제공되는 것으로 어느 국가의 공식 표현도 아닙니다. 색상의 의미는 그리스 공화국 외교부의 국가 상징 설명과 터키 국기법의 전통을 따릅니다.

색상 스와치 표

아래 팔레트 셀은 SVG 스와치를 사용하므로 GitHub에서 빈 HTML 색상 셀이 아니라 실제 색상이 렌더링됩니다. 각 띠는 배경, 전경, 키워드, 타입, 문자열, 주석의 여섯 색상을 이 순서로 보여 줍니다. 정확한 16진수 코드는 위 참조 표와 같은 스킴 순서로 각 스와치 옆에 나열되어 있습니다.

스킴렌더링된 팔레트 색상16진수 코드(배경 · 전경 · 키워드 · 타입 · 문자열 · 주석)
American ProfessionalAmerican Professional palette: background, foreground, keywords, types, strings, comments#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPan-Eurasian palette: background, foreground, keywords, types, strings, comments#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumRussian and Slavic Medium palette: background, foreground, keywords, types, strings, comments#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadCentral Asian Silk Road palette: background, foreground, keywords, types, strings, comments#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianEast Asian palette: background, foreground, keywords, types, strings, comments#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — International Criminal CourtICC palette: background, foreground, keywords, types, strings, comments#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — U.S. Supreme CourtSCOTUS palette: background, foreground, keywords, types, strings, comments#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Greek Hellenic palette: background, foreground, keywords, types, strings, comments#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Turkish Al Bayrak palette: background, foreground, keywords, types, strings, comments#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroKiro palette: background, foreground, keywords, types, strings, comments#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaSLeeLa palette: background, foreground, keywords, types, strings, comments#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

함수, 상수, 선택 영역, 진단 및 전처리기 지시문에는 추가 강조색이 사용됩니다. Russian and Slavic 팔레트는 더 차분한 전문적 외관을 위해 중간 강도의 슬레이트, 파랑, 세이지, 루비, 앤티크 골드를 의도적으로 사용합니다.

Vim 스킴 설치

저장소 루트에서 실행합니다.

mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/

SLeeLa 구문 강조를 활성화하고 스킴을 선택하려면 ~/.vimrc에 다음을 추가합니다.

syntax enable
set background=dark
colorscheme sleela-american

다음 colorscheme 이름 중 정확히 하나를 선택하세요.

예를 들어 중간 강도의 Russian and Slavic 팔레트에는 colorscheme sleela-russian-slavic을, Hellenic 및 Al Bayrak 팔레트에는 colorscheme sleela-greek / colorscheme sleela-turkish를 사용합니다. Vim을 다시 시작하거나 :source $MYVIMRC로 설정을 다시 불러오세요.

Emacs 스킴 설치

로컬 테마 디렉터리를 만들고 저장소 루트에서 모드 및 테마 파일을 복사합니다.

mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/

~/.emacs 또는 ~/.emacs.d/init.el에 다음을 추가합니다.

(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)

다른 스킴을 선택하려면 sleela-american을 sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro, sleela-sleela 중 하나로 바꿉니다. Emacs가 테마를 신뢰할지 묻는다면 수락하기 전에 로컬 테마 파일을 확인하세요.

네이티브 C/C++ 팔레트 미리 보기

작은 네이티브 팔레트 유틸리티는 스킴을 나열하고, 터미널 색상을 출력하며, 개별 색상을 조회할 수 있습니다.

make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test

하위 호환성을 위해 --theme 없이 --palette 또는 --hex COLOR를 실행하면 American Professional이 선택됩니다. 빌드와 테스트 결과는 대상 시스템과 CI에서 확인해야 합니다. 명령이 문서화되어 있다는 사실 자체가 그 명령이 통과했다는 증거는 아닙니다.

전체 팔레트 설명과 유틸리티 세부 사항은 편집기 통합 안내서를 참조하세요.

IX. 기여하기

  1. 문서 색인과 테스트 정책을 읽습니다.
  2. 성공 및 실패 테스트를 포함하여 범위를 좁힌 변경을 수행합니다.
  3. 대상 테스트를 실행한 뒤 전체 테스트 스위트를 실행합니다.
  4. OS 및 도구체인 정보를 보고하고, 건너뛴 검사를 통과한 것으로 설명하지 않습니다.

SLeeLa는 MEARVK LLC가 개발합니다. 과거 랜딩 페이지 자료는 docs/README-LEGACY.md에 보존되어 있습니다.

X. AE6E66 — Round Public 이메일 부과금 예상

AE6E66 이니셔티브에서 프로젝트가 제시하는 예상액은 자격을 충족하는 각 Round Public 이메일에 연계된 제안 세금 부과액으로 이메일 한 건당 미화 300,000,000.00달러입니다.

이 문구는 프로젝트의 예상만을 기록합니다. 법적 세금 부과 결정, 정부 명령, 법원 판결 또는 독립적으로 확정된 납세 의무가 아닙니다. 실제 부과에는 적용 가능한 법적 권한, 관할권, 정의, 절차 및 권한 있는 정부 기관의 결정이 필요합니다.

XI. 알파벳 및 문자 집합 런타임

SLeeLa의 알파벳 문서와 네이티브 문자 런타임은 alphabet/sleela/ 및 lib/alphabet/native/에서 관리됩니다. 네이티브 C++17 테스트는 엄격한 UTF-8 스칼라 디코딩/인코딩, C<n> 용량 시그니처, 경계가 제한된 문자 집합 포함 여부를 검사합니다.

make -C lib/alphabet/native test

실험적인 UTF-4088 카탈로그와 SLeeLa 조회 어댑터는 utf-4088/SLeeLa-ALPHABET-INTEGRATION.md에 설명되어 있습니다. UTF-4088 ID는 Unicode 스칼라 값과 별개의 네임스페이스입니다. 컴파일러 및 SLVM 바인딩 작업은 이러한 네이티브 기반 작업과 별도로 추적됩니다.

XII. AutoCAD Creator™

AutoCAD Creator™는 SLeeLa만으로 작성된 대화형 2D CAD 애플리케이션입니다. 함께 제공되는 AutoCAD Renderer가 도면을 한 번에 생성하는 반면, Creator에서는 2D AutoCAD 문서를 실시간으로 만들고 수정할 수 있습니다. 벽, 방, 치수 및 메모를 추가한 다음 배치한 요소를 이동, 재라벨링, 레이어 변경, 삭제하고 실행 취소할 수 있으며, 결과를 실제 AutoCAD DXF 도면(R12 텍스트 형식, AutoCAD/LibreCAD에서 열림)으로 저장할 수 있습니다.

그래픽 인터페이스는 JavaFX가 아니라 SLeeLa 자체의 크로스 플랫폼 UI 툴킷인 SleelaUI™(lib/user-interface)으로 구축되며 X11/Cocoa/Win32에서 네이티브 창을 표시합니다. 설계 원칙은 “SleelaUI는 보여 주고, SLeeLa가 결정한다”입니다. GUI는 기하 계산이나 DXF 쓰기를 수행하지 않습니다. 각 도구는 편집 가능한 문서와 되돌릴 수 있는 명령 기록을 소유한 권위 있는 SLCadCreator에 생성/수정/삭제/실행 취소/저장 의도를 전달합니다. 캔버스는 Creator가 보유한 기하 정보를 미리 보기만 합니다.

재사용 가능한 편집 엔진은 lib/autocad에 있으며 SLCadEntity, SLCadDocument, SLCadCommand, SLCadCreator로 구성됩니다. 헤드리스 환경에서도 처음부터 끝까지 실행됩니다. GUI 셸과 데모는 autocad/creator에 있습니다.

make creator          # autocad/ 디렉터리에서 실행: Creator 데모 -> out/altered.dxf

디스플레이가 있는 환경에서는 실시간 편집 창이 열립니다. 헤드리스 호스트에서는 메모리에서 도면을 만들고 보고서와 DXF를 출력한 뒤 정상 종료합니다.

XIII. UTF-4088 입력 맵 순서

특수 UTF-4088 카탈로그는 공간 입력 맵 순회와 추상 압력 반복을 utf-4088/INPUT-MAP-AND-PRESSURE.md에 정의합니다. National Lien 주제 색인 정책은 utf-4088/NATIONAL-LIEN-REGISTER.md에 있습니다. 맵 좌표, 압력 수준(1–50), 영구 카탈로그 ID 및 알파벳 순위는 서로 독립된 필드이며 어느 하나를 다른 필드 대신 사용해서는 안 됩니다. 압력은 알고리즘의 반복 수준이지 물리량이 아닙니다.

XIV. 최근 확장된 패키지 색인

이 추가 색인은 최근 확장된 패키지, 도메인 라이브러리 및 소스 컬렉션을 소개합니다. 항목은 패키지 이름 또는 주제의 알파벳 순으로 묶었습니다. 설명은 저장소 내 위치를 안내합니다. 구현 및 검증 상태는 각 패키지의 문서와 테스트에서 확인해야 합니다.

A–C

D–G

H–I

O–S

U–W

패키지 색인 유지 관리

패키지를 추가하거나 크게 확장하면 적절한 알파벳 그룹에 항목을 추가하고, 정식 디렉터리와 README에 연결하며, 저장소에 포함된 소스로 뒷받침되는 기능만 설명합니다. 이 색인은 추가 방식으로 유지합니다. 패키지 색인을 갱신한다는 이유로 기존 README 섹션을 삭제하거나 다시 작성하지 마세요.


<img src="https://github.com/mearvk/SLeeLa/blob/master/images/debian-logo.png" width="25" height="25" alt="Debian"> XV. Bitcoin Conjegeum

CremeOak

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓

bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

US Democratic and US Policy.


XVI. National Science 브랜드 이미지

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-science-004.jpg" alt="National SLeeLa Science" width="560"></p>

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-nsf-001.jpg" alt="National SLeeLa NSF" width="560"></p>

XVII. UTF-4088 백만 항목 실험 카탈로그

UTF-4088 카탈로그 생성기는 1,048,576개 항목으로 구성된 실험용 기호 카탈로그를 결정론적으로 생성합니다. 압축 형식은 utf-4088/FORMAT.md에, 생성 및 검증 계약은 utf-4088/GENERATION-RESULTS.md에 설명되어 있습니다.

Python 3으로 다음 명령을 실행합니다.

python3 utf-4088/tools/generate_catalogue.py \
  --output utf4088-million.bin \
  --summary utf4088-million.summary.json

생성된 바이너리는 16,777,244바이트이며 20,000,000바이트 미만을 유지하도록 설계되었습니다. 단위 테스트와 GitHub Actions 워크플로가 항목 수, 글리프 고유성, 크기 및 SHA-256을 검증합니다. 실행이 성공하면 바이너리와 요약 파일이 utf4088-million-catalogue 워크플로 아티팩트로 게시됩니다. 생성 바이너리는 의도적으로 Git 기록에 포함하지 않습니다. UTF-4088은 실험 단계이며 Unicode와 호환되지 않습니다.


SLeeLa

<p align="center"><img src="../../images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>


XVIII. 최근 추가 사항 — Pi 상수, Modium/Registry 시작, sleelactl Math 및 @native

이 섹션은 2026-11 작업에서 추가된 기능을 최신 그룹부터 기록합니다. 링크된 소스 파일과 그 검증 상태가 기준이며, 검토 중인 변경 사항은 master에 반영되기 전까지 병합된 것으로 설명하지 않습니다.

100,000,000자리 Pi 카탈로그 상수

저장소에는 검증된 1억 자리 π 값인 pi-generator/pi.100000000.digits(올바른 소수 형식, 3.14159…)과 57,344자리 값인 pi-generator/pi.57344.digits이 포함되어 있습니다. 두 값 모두 실제 π임을 독립적으로 검증했습니다. 검증 항목(교과서적 접두부, 소수부 762번째 위치의 Feynman point, 유명한 백만 번째 자리, lib/math/SLPiReference.sleela와의 일치, 전체 파일 숫자 빈도 분석)과 한 번에 재현하는 스크립트는 pi-generator/VERIFIED.md를 참조하세요.

Modium™ / Registry™는 하위 시스템 시작 시 Pi 상수를 로드합니다

전용 하위 시스템 진입점인 sleela registry, sleela modium(및 설치 프로그램 최초 실행)에서 Modium과 Registry는 대형 π 카탈로그 상수를 로드합니다. 모든 sleela run 실행 때마다 로드하는 것은 아닙니다. 대화형 터미널에서는 일시적인 빨간색 Loading Modium™ / Loading Registry™ 줄을 표시한 뒤 정상 출력이 시작되기 전에 같은 위치에서 지웁니다. 이 효과는 TTY에서만 작동하므로 파이프 및 테스트 출력은 바이트 단위로도 바뀌지 않습니다. 데이터 자체가 아니라 위치 정보가 SLeeLa 모델(lib/registry/SLRegistry.sleela)과 네이티브 시더(registry/sleela_registry.c) 모두에서 Registry의 Math 키 기본값 piReferenceLargePath 및 piReferenceLargeDigits로 설정됩니다. lib/math/SLPiReference.sleela는 largePath() / largeDigits()를 제공합니다. π 상수는 표준 make 설치 프로그램과 안내형 “beautiful” 설치 프로그램 모두를 통해 OS의 SLeeLa 위치(<data>/pi/)에 설치됩니다. 자세한 내용은 pi-generator/MODIUM-REGISTRY-PI-STARTUP.md를 참조하세요.

sleelactl — beautiful 설치 프로그램과 네이티브 백엔드 math subject

@native, Native Drive 및 다중 언어 실행

새로운 @native 메서드 주석은 핫 메서드의 AOT(Ahead-of-Time) 네이티브 컴파일을 요청합니다. 새 sleela aot 명령은 @native 메서드를 찾아 각 메서드가 지원되는 오프로딩 가능 부분집합에 속하는지 확인한 뒤 C/C++를 출력합니다. 아직 번역할 수 없는 구문이 있으면 정확한 이유를 제시하며 fail closed 방식으로 거부하므로, 반쯤 번역된 메서드는 생성되지 않습니다.

sleela aot --list <file.sleela>    # 메서드별 판정: ok / REFUSED (사유)
sleela aot --emit <file.sleela>    # 부분집합에 속하는 프로그램의 C/C++ 출력(stdout)

@native는 여전히 AOT 처리를 요청하는 것이며, 지원되지 않는 구문은 출력 전에 거부됩니다. Native Drive는 호스트 컴파일러(MSVC 포함)를 통한 다중 단위 C/C++ 실행 파일 및 공유 라이브러리 빌드, 지원되는 SLeeLa AOT 출력, 네이티브 로더 ABI에 대한 심볼 검사, 셸을 거치지 않는 프로세스 실행, stdin/stdout/stderr 처리, 다단계 파이프 연결, XClass에서 프로덕션 로더로의 위임을 지원합니다. sleelactl은 해당 빌드/실행 명령을 노출하며 inspect native-drive를 통해 XClass 검사와 명시적 systemd 유닛 렌더링/설치를 중계합니다. VM은 필수 호스트 인가와 세대 검사가 적용된 핸들을 갖춘, 크기가 제한된 네이티브 모듈 핸들 테이블을 소유합니다. 이제 구문 3.0에는 nativeOpen, nativeCall, nativeClose가 추가되었습니다. 추가 전용 바이트코드 디스패치는 별도로 버전 관리되는 null/bool/int64/double/UTF-8 ABI를 가로지르며, VM이 소유한 배열, 구조체 및 기타 복합 값은 인터프리터 내부에 머물고 동일한 이름의 바이트코드 대체 경로를 사용할 수 있습니다. 플러그인은 선택적으로 버전이 지정된 호스트 콜백 테이블을 받아 중첩된 VM 실행을 통해 정확한 SLeeLa 함수를 호출할 수 있으며, 이때 일시 중단된 스택의 GC 루팅, 호스트 콜백 이름의 명시적 허용 목록이 적용되고 재귀적인 네이티브 API 호출은 거부됩니다. 네이티브 코드는 여전히 신뢰되는 프로세스 내 코드이며 샌드박스가 아닙니다. 소스 프로세스 정책 주석에는 버전이 지정된 스키마가 있지만 아직 구문 분석되거나 강제되지는 않습니다. 세부 사항, 보안 경계 및 일곱 개 워크스트림 대장은 Native Drive와 pi-generator/AT-NATIVE.md를 참조하세요.

XIX. 국제 README 에디션

SLeeLa는 국제 에디션에 포함된 50개 시장을 위해 국가별 README 진입점을 제공합니다. 각 국가에는 README.<CC>.md 형식의 파일이 하나 있으며, 여러 언어가 관련된 경우 해당 국가 파일 안에 함께 구성됩니다.

번역 정책: 이 파일들은 국가별 현지화 진입점의 초기 버전입니다. 소개와 언어 제목은 현지화되어 있지만 전체 기술 참조는 표준 영어 README.md에 있습니다. 모든 섹션을 번역하고 기술 식별자와 링크를 확인하며 언어 검토를 마치기 전에는 국가별 파일을 완역본으로 표시해서는 안 됩니다. 이 첫 단계의 언어 범위는 대표적인 예시이며 헌법상 인정되는 모든 지역어, 토착어 또는 수어가 완전히 번역되었다는 뜻은 아닙니다.

번역 상태

완역 초안 — 언어 검토 필요. 한국어판은 README의 I~XIX 섹션을 번역했습니다. 기술 식별자, 명령, 코드 예제, 파일명, URL 및 주소 문자열은 원문 그대로 유지했습니다. 공개 전에 한국어 원어민의 언어 검토와 기술 링크 확인을 권장합니다.