Merge pull request #1503 from microsoft/update-translations

🌐 Update translations via Co-op Translator

Author: softchris

translations/ar/9-chat-project/README.md

@@ -1,55 +1,18 @@
 <!--
 CO_OP_TRANSLATOR_METADATA:
 {
-  "original_hash": "a7b7f54b13f9e6683a844d173ffdd766",
-  "translation_date": "2025-08-28T15:57:13+00:00",
+  "original_hash": "cb549dcad8eea3221cb89793aeaa3bb3",
+  "translation_date": "2025-09-01T15:20:07+00:00",
   "source_file": "9-chat-project/solution/README.md",
   "language_code": "ar"
 }
 -->
-# تشغيل الكود
+# تشغيل الحل
 
-## الإعداد
-
-إنشاء بيئة افتراضية
-
-```sh
-cd backend
-python -m venv venv
-source ./venv/bin/activate
-```
-
-## تثبيت التبعيات
-
-```sh
-pip install openai flask flask-cors 
-```
-
-## تشغيل واجهة برمجة التطبيقات (API)
-
-```sh
-python api.py
-```
-
-## تشغيل الواجهة الأمامية
-
-تأكد من أنك في مجلد الواجهة الأمامية
-
-ابحث عن *app.js*، وقم بتغيير `BASE_URL` إلى عنوان URL الخاص بواجهة برمجة التطبيقات الخلفية لديك
-
-قم بتشغيله
-
-```
-npx http-server -p 8000
-```
-
-حاول كتابة رسالة في الدردشة، يجب أن ترى استجابة (بشرط أنك تقوم بتشغيل هذا في Codespace أو قمت بإعداد رمز وصول).
-
-## إعداد رمز الوصول (إذا لم تقم بتشغيل هذا في Codespace)
-
-راجع [إعداد PAT](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
+1. قم بتشغيل [الخلفية](./backend/README.md)  
+1. الآن قم بتشغيل [الواجهة الأمامية](./frontend/README.md)  
 
 ---
 
 **إخلاء المسؤولية**:  
-تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.
+تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.

translations/ar/9-chat-project/solution/README.md

@@ -0,0 +1,17 @@
+<!--
+CO_OP_TRANSLATOR_METADATA:
+{
+  "original_hash": "bcd2c2bbaae71151b1ed1b9170aa78af",
+  "translation_date": "2025-09-01T15:42:11+00:00",
+  "source_file": "9-chat-project/solution/backend/README.md",
+  "language_code": "ar"
+}
+-->
+اختر بيئة التشغيل
+
+- [Python](./python/README.md)
+
+---
+
+**إخلاء المسؤولية**:  
+تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة.

translations/ar/9-chat-project/solution/backend/README.md

@@ -0,0 +1,54 @@
+<!--
+CO_OP_TRANSLATOR_METADATA:
+{
+  "original_hash": "537f02a36d73db093cbb8b9b44867645",
+  "translation_date": "2025-09-01T15:45:49+00:00",
+  "source_file": "9-chat-project/solution/backend/python/README.md",
+  "language_code": "ar"
+}
+-->
+# تشغيل الكود
+
+## الإعداد
+
+إنشاء بيئة افتراضية
+
+```sh
+python -m venv venv
+source ./venv/bin/activate
+```
+
+## تثبيت التبعيات
+
+```sh
+pip install openai flask flask-cors 
+```
+
+## تشغيل واجهة برمجة التطبيقات (API)
+
+```sh
+python api.py
+```
+
+## تشغيل الواجهة الأمامية
+
+تأكد من أنك في مجلد الواجهة الأمامية
+
+ابحث عن *app.js*، وقم بتغيير `BASE_URL` إلى عنوان URL الخاص بالخادم الخلفي لديك
+
+قم بتشغيله
+
+```
+npx http-server -p 8000
+```
+
+حاول كتابة رسالة في الدردشة، يجب أن ترى استجابة (بشرط أن تكون تعمل في Codespace أو قد قمت بإعداد رمز الوصول).
+
+## إعداد رمز الوصول (إذا لم تكن تعمل في Codespace)
+
+راجع [إعداد PAT](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)
+
+---
+
+**إخلاء المسؤولية**:  
+تم ترجمة هذه الوثيقة باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار الوثيقة الأصلية بلغتها الأصلية المصدر الموثوق. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة تنشأ عن استخدام هذه الترجمة.

translations/ar/9-chat-project/solution/backend/python/README.md

@@ -0,0 +1,21 @@
+<!--
+CO_OP_TRANSLATOR_METADATA:
+{
+  "original_hash": "7746a470be8fc7f736eb1b43ebb710ee",
+  "translation_date": "2025-09-01T15:50:55+00:00",
+  "source_file": "9-chat-project/solution/frontend/README.md",
+  "language_code": "ar"
+}
+-->
+# تشغيل الكود
+
+```sh
+npx http-server -p 3000
+```
+
+ابحث عن `BASE_URL` في `app.js` وقم بتغييره ليطابق عنوان URL الخاص بالخادم الخلفي.
+
+---
+
+**إخلاء المسؤولية**:  
+تم ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي [Co-op Translator](https://github.com/Azure/co-op-translator). بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي. للحصول على معلومات حاسمة، يُوصى بالاستعانة بترجمة بشرية احترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسيرات خاطئة ناتجة عن استخدام هذه الترجمة.

translations/ar/9-chat-project/solution/frontend/README.md

@@ -1,8 +1,8 @@
 <!--
 CO_OP_TRANSLATOR_METADATA:
 {
-  "original_hash": "cf15ff7770c5a484349383bb27d1131f",
-  "translation_date": "2025-08-29T13:02:46+00:00",
+  "original_hash": "002304ffe0059e55b33e2ee5283788ad",
+  "translation_date": "2025-09-01T15:38:25+00:00",
   "source_file": "9-chat-project/README.md",
   "language_code": "bg"
 }
@@ -14,7 +14,7 @@ CO_OP_TRANSLATOR_METADATA:
 Ето как изглежда завършеният проект:
 
 <div>
-  <img src="./assets/screenshot.png" alt="Чат приложение" width="600">
+  <img src="./assets/screenshot.png" alt="Chat app" width="600">
 </div>
 
 Малко контекст: създаването на чат асистенти с помощта на генеративен AI е чудесен начин да започнете да учите за AI. В този урок ще научите как да интегрирате генеративен AI в уеб приложение. Да започваме.
@@ -33,6 +33,8 @@ CO_OP_TRANSLATOR_METADATA:
   <img src="./assets/playground-choice.png" alt="playground choice" with="600">
 </div>
 
+### Използване на Python
+
 В този случай избираме Python, което означава, че ще използваме този код:
 
 ```python
@@ -70,7 +72,7 @@ response = client.chat.completions.create(
 print(response.choices[0].message.content)
 ```
 
-Нека почистим този код малко, за да бъде по-удобен за повторна употреба:
+Нека почистим този код малко, за да бъде по-удобен за повторно използване:
 
 ```python
 def call_llm(prompt: str, system_message: str):
@@ -108,6 +110,8 @@ call_llm("Tell me about you", "You're Albert Einstein, you only know of things i
 
 Страхотно, завършихме AI частта, нека видим как можем да я интегрираме в Web API. За Web API избираме Flask, но всяка уеб рамка би била подходяща. Ето кода за това:
 
+### Използване на Python
+
 ```python
 # api.py
 from flask import Flask, request, jsonify
@@ -137,7 +141,7 @@ if __name__ == "__main__":
     app.run(host="0.0.0.0", port=5000)
 ```
 
-Тук създаваме Flask API и дефинираме основен маршрут "/" и "/chat". Вторият е предназначен за използване от нашия фронтенд, за да предава въпроси към него.
+Тук създаваме Flask API и дефинираме основен маршрут "/" и "/chat". Последният е предназначен за използване от нашия фронтенд, за да предава въпроси.
 
 За да интегрираме *llm.py*, ето какво трябва да направим:
 
@@ -176,9 +180,13 @@ if __name__ == "__main__":
 
 Страхотно, вече сме готови.
 
-### Конфигуриране на Cors
+## Конфигуриране на Cors
+
+Трябва да отбележим, че настройваме нещо като CORS, споделяне на ресурси между различни произходи. Това означава, че тъй като нашият бекенд и фронтенд ще работят на различни портове, трябва да позволим на фронтенда да се свързва с бекенда.
 
-Трябва да отбележим, че настройваме нещо като CORS (споделяне на ресурси между различни произходи). Това означава, че тъй като нашият бекенд и фронтенд ще работят на различни портове, трябва да позволим на фронтенда да се свързва с бекенда. Има парче код в *api.py*, което настройва това:
+### Използване на Python
+
+Има парче код в *api.py*, което настройва това:
 
 ```python
 from flask_cors import CORS
@@ -191,7 +199,11 @@ CORS(app)   # *   example.com
 
 ## Стартиране на проекта
 
-Добре, имаме *llm.py* и *api.py*, как можем да ги накараме да работят с бекенд? Ето какво трябва да направим:
+За да стартирате проекта, първо трябва да стартирате бекенда, а след това фронтенда.
+
+### Използване на Python
+
+Добре, имаме *llm.py* и *api.py*, как можем да ги направим да работят с бекенд? Ето какво трябва да направим:
 
 - Инсталирайте зависимости:
 
@@ -209,11 +221,11 @@ CORS(app)   # *   example.com
    python api.py
    ```
 
-   Ако сте в Codespaces, трябва да отидете в Ports в долната част на редактора, да кликнете с десния бутон върху него и да изберете "Port Visibility" и след това "Public".
+   Ако сте в Codespaces, трябва да отидете в Ports в долната част на редактора, да кликнете с десния бутон върху него, да изберете "Port Visibility" и да изберете "Public".
 
 ### Работа върху фронтенд
 
-Сега, когато имаме работещ API, нека създадем фронтенд за него. Минимален фронтенд, който ще подобрим постепенно. В папка *frontend* създайте следното:
+Сега, когато имаме работещ API, нека създадем фронтенд за него. Минимален фронтенд, който ще подобряваме стъпка по стъпка. В папка *frontend* създайте следното:
 
 ```text
 backend/
@@ -302,10 +314,10 @@ styles.css
 
 - 1) Тук получаваме референция към всички елементи, които ще използваме по-късно в кода.
 - 2) В тази секция създаваме функция, която използва вградения метод `fetch`, за да извика нашия бекенд.
-- 3) `appendMessage` помага да добавим отговори, както и това, което въвеждате като потребител.
+- 3) `appendMessage` помага да добавим отговори, както и съобщенията, които потребителят въвежда.
 - 4) Тук слушаме събитието за изпращане и четем полето за въвеждане, поставяме съобщението на потребителя в текстовото поле, извикваме API и показваме отговора в текстовото поле.
 
-Нека разгледаме стилизирането, тук можете да бъдете креативни и да го направите както искате, но ето някои предложения:
+Нека разгледаме стилизирането, ето къде можете да бъдете креативни и да го направите както искате, но ето някои предложения:
 
 **styles.css**
 
@@ -330,7 +342,7 @@ styles.css
 
 ### Промяна на Base Url
 
-Има едно нещо, което не зададохме, и това е `BASE_URL`. Това не е известно, докато вашият бекенд не бъде стартиран. За да го зададете:
+Има едно нещо, което не зададохме, и това е `BASE_URL`. Това не е известно, докато бекендът не бъде стартиран. За да го зададете:
 
 - Ако стартирате API локално, трябва да бъде зададено на нещо като `http://localhost:5000`.
 - Ако го стартирате в Codespaces, трябва да изглежда нещо като "[name]app.github.dev".
@@ -346,29 +358,34 @@ project/
     app.js
     styles.css
   backend/
-    api.py
-    llm.py
+    ...
 ```
 
-Копирайте съдържанието от инструкциите по-горе, но не се колебайте да го персонализирате според вашите предпочитания.
+Копирайте съдържанието от инструкциите по-горе, но се чувствайте свободни да го персонализирате според вашите предпочитания.
 
 ## Решение
 
 [Решение](./solution/README.md)
 
 ## Бонус
 
-Опитайте да промените личността на AI асистента. Когато извиквате `call_llm` в *api.py*, можете да промените втория аргумент на каквото искате, например:
+Опитайте да промените личността на AI асистента.
+
+### За Python
+
+Когато извиквате `call_llm` в *api.py*, можете да промените втория аргумент на каквото искате, например:
 
 ```python
 call_llm(message, "You are Captain Picard")
 ```
 
-Променете също CSS и текста според вашите предпочитания, направете промени в *index.html* и *styles.css*.
+### Фронтенд
+
+Променете също CSS и текста според вашите предпочитания, като направите промени в *index.html* и *styles.css*.
 
 ## Обобщение
 
-Страхотно, научихте от нулата как да създадете личен асистент, използвайки AI. Направихме това с помощта на GitHub Models, бекенд на Python и фронтенд на HTML, CSS и JavaScript.
+Страхотно, научихте от нулата как да създадете личен асистент с помощта на AI. Направихме това, използвайки GitHub Models, бекенд на Python и фронтенд на HTML, CSS и JavaScript.
 
 ## Настройка с Codespaces
 
@@ -386,4 +403,4 @@ call_llm(message, "You are Captain Picard")
 ---
 
 **Отказ от отговорност**:  
-Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматичните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия изходен език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален превод от човек. Не носим отговорност за каквито и да е недоразумения или погрешни интерпретации, произтичащи от използването на този превод.
+Този документ е преведен с помощта на AI услуга за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да било недоразумения или погрешни интерпретации, произтичащи от използването на този превод.