Skip to content

Commit

Permalink
Hebrew support and optimized for change translation (gaearon#513)
Browse files Browse the repository at this point in the history
  • Loading branch information
EranOV23 authored and gaearon committed Dec 25, 2019
1 parent aa6a071 commit a1bac20
Show file tree
Hide file tree
Showing 4 changed files with 35 additions and 4 deletions.
1 change: 1 addition & 0 deletions i18n.js
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ exports.supportedLanguages = {
'zh-hans': '简体中文',
ja: '日本語',
fr: 'Français',
he: 'עברית',
hu: 'Magyar',
vi: 'Tiếng Việt',
th: 'ไทย',
Expand Down
23 changes: 23 additions & 0 deletions src/pages/optimized-for-change/index.he.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: מאופטם לשינוי
date: '2018-12-12'
spoiler: איך לעשות API מעולה?
---

איך לעשות API מעולה?

עיצוב *טוב* של API הוא כזה שקל לזכור אותו וחד משמעי. הוא מעודד קריאות, נכונות וביצועים, ועוזר למפתחים ליפול ל״בור ההצלחה" [the pit of success](https://blog.codinghorror.com/falling-into-the-pit-of-success/)

אני קורא להיבט הזה של העיצוב "במקום הראשון" מכיוון שאלה הדברים הראשונים אליהם מפתח/ת ספרייה נוטה לשים לב. אולי תהיו צריכים להתפשר על חלקם ולשקלל יתרונות וחסרונות, אבל לפחות הם תמיד יהיו במחשבה שלכם.

למרות זאת, אלא אם כן את/ה שולח/ת חללית למאדים, הקוד שלך ככל הנראה ישתנה לאורך הזמן. וכך גם הקוד של צרכני ה API שלך.

מעצבי ה API הכי טובים שאני מכיר, לא עוצרים בהיבטים של ״במקום האשון״ כמו קריאות. הם מקדישים מאמץ באותה מידה, אם לא אף יותר, למה שאני קורא עיצוב API ״במקום השני״: **איך קוד המשתמש ב API יתפתח לאורך הזמן.**

שינוי קטן בדרישות יכול לגרום להפלה של הקוד הכי אלגנטי שיש.

*API* מעולה צופה את זה. הם צופים את זה שתרצה להזיז חלק מהקוד. להעתיק ולהדביק חלקים. לשנות שמות. לאחד מקרים מיוחדים לעזר גנרי רב פעמי. להתיר הפשטה בחזרה למקרים ספציפים. לקצץ. לאפטם צווארי בקבוק. לזרוק חלקים ולהתחיל אותם מחדש. לעשות טעויות. לתמרן בין הסיבה והתוצאה. לתקן באג. לסקור את התיקון.

APIs מעולים לא רק נותנים לך ליפול ל״בור ההצלחה״, הם גם עוזרים לך *להישאר* שם.

הם מאופטמים לשינוי.
14 changes: 10 additions & 4 deletions src/utils/global.css
Original file line number Diff line number Diff line change
Expand Up @@ -35,27 +35,33 @@ body.dark {
RTL layout
*/
body:lang(fa) article,
body:lang(ar) article {
body:lang(ar) article,
body:lang(he) article {
direction: rtl;
}

body:lang(fa) article pre,
body:lang(ar) article pre,
body:lang(he) article pre,
body:lang(fa) article .translations,
body:lang(ar) article .translations,
body:lang(he) article .translations,
body:lang(fa) .language-text,
body:lang(ar) .language-text {
body:lang(ar) .language-text,
body:lang(he) .language-text {
direction: ltr;
}

/* Fixing parentheses issue in text */
body:lang(fa) .language-text,
body:lang(ar) .language-text {
body:lang(ar) .language-text,
body:lang(he) .language-text {
display: inline-block;
}

body:lang(fa) blockquote,
body:lang(ar) blockquote {
body:lang(ar) blockquote,
body:lang(he) blockquote {
border-left: unset;
border-right: 0.32813rem solid hsla(0, 0%, 0%, 0.9);
padding-right: 1.42188rem;
Expand Down
1 change: 1 addition & 0 deletions src/utils/i18n.js
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ export const loadFontsForCode = code => {
case 'es':
case 'fi':
case 'fr':
case 'he':
case 'hu':
case 'it':
case 'nl':
Expand Down

0 comments on commit a1bac20

Please sign in to comment.