J4.x

Setting Up Your Local Environment/he: Difference between revisions

From Joomla! Documentation

Created page with "== מדריך למתחילים ארוך יותר =="
Created page with "ג 'ומלה אינה שונה בהרבה כלי אינטרנט אחרים בימים אלה. יש לה חלק גדול PHP ויש לו יותר ויותר קוד JavaScript...."
Line 21: Line 21:


== מדריך למתחילים ארוך יותר ==
== מדריך למתחילים ארוך יותר ==
Joomla is not different to many other web tools these days. It has a large PHP part and it has more and more JavaScript code. While PHP coding doesn't need so much preparation, JavaScript needs a lot tooling around. The main reason is that nobody writes code in a way that every browser understands, so the code needs transpiling from e.g. ES6 to a compatible version of JavaScript. The same is true for CSS, for Joomla we are using SASS and this will be converted to native CSS so that any browser understands it. As downside setting up a dev environment is a bit more complicated but the tooling make coding also more convenient. Thanks to watchers and browser auto reload you can see your change in real time.  
ג 'ומלה אינה שונה בהרבה כלי אינטרנט אחרים בימים אלה. יש לה חלק גדול PHP ויש לו יותר ויותר קוד JavaScript. בעוד קוד PHP לא צריך כל כך הרבה הכנה, JavaScript צריך הרבה כלים סביבו. הסיבה העיקרית לכך היא שאף אחד לא כותב קוד בצורה שכל דפדפן מבין, כך שהקוד צריך להיות מתורגם, למשל, ES6 לגירסה תואמת של ה-JavaScript הנתמך בדפדפן. אותו הדבר נכון לגבי CSS, עבור ג 'ומלה אנו משתמשים SASS אשר ממור ל-CSS כך שכל דפדפן יוכל לתרגם את ההגדרות בצורה נכונה. לכן הגדרת סביבת הפתוח קמצת יותר מסובכת אבל לצד זה מקבלים קידוד (פתוח) נוחים יותר. הודות למערכות תצוגה וטעינה אוטומטית בדפדפנים תוכלו לראות את השינויים שלכם בצורה טובה יותרובזמן אמת.  


=== PHP ===
=== PHP ===

Revision as of 09:34, 4 August 2018

מדריך
איך להגדיר סביבה לוקלית לג'ומלה 4
Joomla! 
4.x

בג'ומלה 4 שיננו את תהליך הפיתוח, ובגירסה זאת לא ניתן לשכפל את התקנה של ג'ומלה ממאגר. בדקנו אחר שיטות העבודה המומלצות ויישמנו תהליך בנייה עבור מערכת ניהול התוכן.

מדריך להתחלה מהירה

מה שאתם צרכים לעשות כדי להגדיר את סביבת הפיתוח תלוי במערכת ההפעלה שלכם. אנחנו לא יכולים לכתוב תיעוד עבור כל מערכת הפעלה לכן אנו ממליצים לבצע חיפוש במנוע החיפוש המועדף עלכם ולמצוא את "כיצד לבצע" (HowTo).

הכלים הנדרשים

  1. PHP - בדיוק כמו בגרסאות הישנות יש צורך ב-PHP ובנוסף ב-CLI PHP (ממשק שורת הפקודה) בכדי להפעיל את אתר ג'ומלה, (ראה את הגדרת שרת LAMPP לפיתוח PHP
  2. Composer - לניהול התלויות PHP של ג'ומלה - לקבלת עזרה בהתקנת ה-Composer, קראו את התיעוד בכתובת https://getcomposer.org/doc/00-intro.md
  3. Node.js - להרכבת קבצי JavaScript ו- SASS של ג'ומלה - לעזרה בהתקנת Node.js, פעלו לפי ההנחיות הזמינות בכתובת https://nodejs.org/en/
  4. Git - לניהול גרסאות

צעדים להגדרת הסביבה המקומית

  1. לשכפל (clone) את המאגר
  2. להפעיל composer install</ tt> מספריית השורש של הריפוזיטורי (git repo). אתם יכולים להוסיף את הפרמטר של --ignore-platform-reqs אם אינכם צריכים את PHP-LDAP מותקן מקומי ולכן אין צורך בכך.
  3. הריצו npm install מספריית השורש של הריפוזיטורי (git repo).

מדריך למתחילים ארוך יותר

ג 'ומלה אינה שונה בהרבה כלי אינטרנט אחרים בימים אלה. יש לה חלק גדול PHP ויש לו יותר ויותר קוד JavaScript. בעוד קוד PHP לא צריך כל כך הרבה הכנה, JavaScript צריך הרבה כלים סביבו. הסיבה העיקרית לכך היא שאף אחד לא כותב קוד בצורה שכל דפדפן מבין, כך שהקוד צריך להיות מתורגם, למשל, ES6 לגירסה תואמת של ה-JavaScript הנתמך בדפדפן. אותו הדבר נכון לגבי CSS, עבור ג 'ומלה אנו משתמשים SASS אשר ממור ל-CSS כך שכל דפדפן יוכל לתרגם את ההגדרות בצורה נכונה. לכן הגדרת סביבת הפתוח קמצת יותר מסובכת אבל לצד זה מקבלים קידוד (פתוח) נוחים יותר. הודות למערכות תצוגה וטעינה אוטומטית בדפדפנים תוכלו לראות את השינויים שלכם בצורה טובה יותרובזמן אמת.

PHP

It should be enough to run composer install as this will install PHP dependencies saved in the composer.lock file. You can do this as many times as you like, it will only install new packages when the composer.lock file is changed. Don't run composer update as this will update all packages to newer versions and update the composer.lock file.

Note: You may need to run composer install with the --ignore-platform-reqs option to ignore platform requirements specified in Composer, i.e. if you do not have PHP's LDAP extension installed.

Node/npm scripts

Node.js comes with a package manager called NPM (in some way the same as Composer). NPM has a run command and we have prepared some scripts to make your life easier. You have to run the commands for the root of the repository.

npm run build:css

It will compile SASS files to CSS and also create the minified files.

npm run build:js

It will compile and transpile the JavaScript files to the correct format and create minified files

npm run watch:css

This is the same as the build:css command but will watch for changes and automatically build updated files.

npm run watch:js

This is the same as the build:js command but will watch for changes and automatically build updated files.

npm run lint:js

This will make a syntax check on JavaScript files.

npm run test

This will run other JavaScript testing suite.