ברוכים הבאים לקהילת הפיתוח של TypesetOK (TOK)!
אנו מקדמים בברכה תרומות קוד, עיצוב, תיעוד, בדיקות טיפוגרפיות ומשוב ממומחי עימוד ודפוס עברי.
כל תרומת קוד למערכת מחויבת לציית לחוקי הברזל הבאים:
-
נרמול עברי לפי ת״י 6100 (SI 6100): כל טקסט עברי המוזן למערכת עובר נרמול דטרמיניסטי:
אות בסיס ← נקודת שין/שין ← דגש/מפיק ← ניקוד ← מתג ← טעמי מקרא. -
איסור מוחלט על כשידה ערבית (
Tatweel U+0640): יישור עברי נעשה אך ורק לפי מדרג 3 השלבים: רווחי מילים$\rightarrow$ מתיחת אותיות אהלתר״ם (א, ה, ל, ת, ר, ם)$\rightarrow$ מיקרו-טרקינג. - מגן שמות קדושים: חל איסור מוחלט על שבירת שורה או פיצול אותיות בשמות הוי"ה, אדנות ושמות קודש.
-
מספור עברי בגימטריה: שימוש אך ורק בגרש עברי תקני (
U+05F3, ׳) ובגרשיים עבריים תקניים (U+05F4, ״), תוך אכיפת המרות טאבו מסורתיות (15$\rightarrow$ ט״ו, 16$\rightarrow$ ט״ז, 270$\rightarrow$ ע״ר, 272$\rightarrow$ ער״ב וכו'). - דטרמיניזם מלא (Bit-for-Bit Determinism): הרצה חוזרת של העימוד על אותו קלט חייבת לייצר קובץ PDF עם חתימת SHA-256 זהה לחלוטין.
- Rust 1.85+ עם
cargo,rustfmt, ו-clippy. - Node.js 20+ ו-
npm.
לפני יצירת PR יש לוודא כי כל הבדיקות עוברות באופן נקי:
# 1. בדיקות ליבת Rust (65 בדיקות)
cargo test --workspace
# 2. בדיקת עיצוב קוד Rust
cargo fmt --check
# 3. בדיקת Clippy ללא אזהרות
cargo clippy --workspace --all-targets -- -D warnings
# 4. בדיקות מעטפת Frontend (15 בדיקות)
npm test
# 5. קומפילציית TypeScript וחבילת UI
npm run build- פתח ענף חדש מ-
main:git checkout -b feature/your-feature-name # או git checkout -b fix/your-bug-fix - בצע קומיטים בעלי הודעות ברורות לפי תקן Conventional Commits:
feat(typeset): ...fix(pdf): ...docs(readme): ...test(canvas): ...
- פתח Pull Request ב-GitHub עם פירוט השינויים, מטרתם ובדיקות האימות שבוצעו.
Thank you for your interest in contributing to TypesetOK (TOK)!
We welcome contributions from Rust developers, frontend engineers, font designers, and Hebrew DTP professionals.
All contributions must adhere to the following strict invariants:
-
SI 6100 Hebrew Unicode Normalization: Mandatory canonical order:
Base Consonant -> Shin/Sin Dot -> Dagesh/Mapiq -> Niqqud -> Meteg -> Te'amim. -
Strict Rejection of Arabic Tatweel (
U+0640): Hebrew line justification uses only the 3-Tier engine: Word Spacing$\rightarrow$ Ahalterm Letter Stretching (Alef, He, Lamed, Tav, Resh, Final Mem)$\rightarrow$ Micro-tracking. - Holy Names Protection: No hyphenation or word-breaking across divine Hebrew names.
-
Deterministic Gematria: Uses native Hebrew geresh (
U+05F3) and gershayim (U+05F4) with required traditional taboo substitutions (15$\rightarrow$ ט״ו, 16$\rightarrow$ ט״ז, etc.). - Bit-for-Bit Determinism: Output must produce identical SHA-256 hashes across identical runs.
# Rust test suite (65 passing tests)
cargo test --workspace
# Formatting & Clippy linter
cargo fmt --check
cargo clippy --workspace --all-targets -- -D warnings
# TypeScript tests & compilation (15 passing tests)
npm test
npm run build