פקודת intlayer אינה מוגדרת (undefined)

סקירה כללית

ה-CLI של Intlayer מספק דרך נוחה לשלוט בתוכן ה-intlayer שלך, כולל בניית מילונים (dictionaries), דחיפת תרגומים ועוד. עם זאת, הוא אינו הכרחי כדי שהפרויקט שלך יפעל. אם אתה משתמש בתוסף הבנדלר (כמו withIntlayer() עבור Next.js או intlayer() עבור Vite), Intlayer יבנה באופן אוטומטי מילונים במהלך ה-build של האפליקציה או בעת הפעלת שרת הפיתוח. במצב פיתוח (development mode), הוא גם יאזין לשינויים ויבנה מחדש את קובצי הצהרת התוכן באופן אוטומטי.

ניתן לגשת לפקודות intlayer בדרכים שונות:

• שימוש ישיר בפקודת ה-cli‏ intlayer
• שימוש ב-הרחבת VSCode
• שימוש ב-SDK‏ @intlayer/cli

הבעיה

בעת ניסיון להשתמש בפקודה intlayer, ייתכן שתיתקל בשגיאה הבאה:

'intlayer' is not recognized as an internal or external command,
operable program or batch file.

פתרונות

נסה את הפתרונות הבאים לפי הסדר:

1. ודא שהפקודה מותקנת

npx intlayer -h

פלט צפוי:

Usage: intlayer [options] [command]

Intlayer CLI

Options:
    -V, --version            output the version number
    -h, --help               display help for command

Commands:
    dictionary|dictionaries  Dictionaries operations
    configuration|config     Configuration operations
    help [command]           display help for command

2. התקן את החבילה intlayer-cli באופן גלובלי

npm install intlayer-cli -g

פעולה זו אינה אמורה להיות נחוצה אם כבר התקנת את החבילה intlayer.

3. התקן את החבילה באופן גלובלי

npm install intlayer -g

4. הפעל מחדש את הטרמינל לעתים נדרשת הפעלה מחדש של הטרמינל כדי לזהות פקודות חדשות.

5. ניקוי והתקנה מחדש אם הפתרונות שלעיל לא פתרו את הבעיה:

rm -rf node_modules package-lock.json
npm install

6. אימות קובצי ההתקנה אם הבעיה נמשכת, ודא שהקבצים הבאים קיימים:

   • node_modules/intlayer/dist/cjs/cli.cjs
   • node_modules/intlayer/package.json (אמור להכיל שדה bin המפנה ל-./dist/cjs/cli.cjs)

7. בדוק את משתנה הסביבה PATH ודא שספריית ה-bin הגלובלית של npm נמצאת ב-PATH שלך:

# עבור מערכות מבוססות Unix (macOS/Linux)
echo $PATH
# אמור לכלול נתיב כגון /usr/local/bin או ~/.npm-global/bin

# עבור Windows
echo %PATH%
# אמור לכלול את ספריית ה-bin הגלובלית של npm

8. השתמש ב-npx עם נתיב מלא אם הפקודה עדיין לא נמצאה, נסה להשתמש ב-npx עם הנתיב המלא:

npx ./node_modules/intlayer/ dictionaries build

9. בדוק האם קיימות התקנות מתנגשות

# הצג את כל החבילות המותקנות גלובלית
npm list -g --depth=0

# הסר התקנות גלובליות שעלולות להתנגש
npm uninstall -g intlayer
npm uninstall -g intlayer-cli
# לאחר מכן התקן מחדש
npm install -g intlayer

10. אמת את גרסאות Node.js ו-npm ודא שאתה משתמש בגרסאות תואמות:

node --version
npm --version

אם אתה משתמש בגרסה ישנה, שקול לעדכן את Node.js ואת npm.

11. בדוק בעיות הרשאות אם אתה מקבל שגיאות הרשאה (permission errors):

    bash

    העתקת התוכן

    העתקת קוד

    העתקת הקוד ללוח

    # עבור מערכות מבוססות Unix
    sudo npm install -g intlayer
    
    # או שנה את ספריית ברירת המחדל של npm
    mkdir ~/.npm-global
    npm config set prefix '~/.npm-global'
    # הוסף לקובץ ה-~/.profile או ~/.bashrc שלך:
    export PATH=~/.npm-global/bin:$PATH