اختلافات

عرض الاختلافات بين النسخة المختارة و النسخة الحالية من الصفحة.

--- arabic-support-on-linux-terminal [2023/01/23 10:10] – mhsabbagh
+++ arabic-support-on-linux-terminal [2023/12/20 17:08] (حالي) – تحرير خارجي 127.0.0.1
@@ سطر 11: / سطر 11: @@
 لحسن الحظّ يمكنك حل كلتا المشكلتين، ونعمل نحن في [[:taqweem-team|فريق تقويم على جعل هذه الحلول دائمة وافتراضية]] على توزيعات لينكس ولكننا لم نصل إلى هناك بعد. وسنشرح في هذه الصفحة كيف يمكنك حلها من طرفك مؤقتًا إلى أن يكتمل الإصلاح الرسمي.
-يمكنك إن شاء الله الحصول على الشكل التالي بعد تطبيق التعليمات في هذه الصفحة:
-[[https://linux-2-day.com/lib/exe/fetch.php?tok=7609c0&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/after.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/after.png?direct&846x562  }}]]
 ===== تغيير الخط الافتراضي للطرفيّة =====
@@ سطر 22: / سطر 18: @@
 [[https://linux-2-day.com/lib/exe/fetch.php?tok=b3c2d7&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-22_23-39.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-22_23-39.png?direct&1656x850  }}]]
-بعدها ابحث عن خط اسمه Monospace من القائمة، واختر الحجم 11 كما في الصورة واضغط "اختر":
+بعدها ابحث عن خط اسمه <wrap hi>Monospace</wrap> من القائمة، واختر الحجم <wrap hi>11</wrap> كما في الصورة واضغط "اختر":
 [[https://linux-2-day.com/lib/exe/fetch.php?tok=b1d056&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-22_23-40.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-22_23-40.png?direct&838x695  }}]]
@@ سطر 30: / سطر 26: @@
 ===== تفعيل التقاط الاتجاه التلقائي (Auto-detection) للنص في الطرفية =====
-المشكلة الثانية التي تعاني منها الطرفية هي مشكلة الاتجاه. يجب أن تكون النصوص العربية تُعرض من اليمين إلى اليسار (RTL) وليس من اليسار إلى اليمين (LTR)، ولكن هذا لا يحصل افتراضيًا في الطرفية مما يؤدي إلى المشكلة التي رأيتها في الصورة الأولى في هذه الصفحة.
+المشكلة الثانية التي تعاني منها الطرفية هي مشكلة الاتجاه. يجب أن تُعرض النصوص العربية من اليمين إلى اليسار (RTL) وليس من اليسار إلى اليمين (LTR)، ولكن هذا لا يحصل افتراضيًا في الطرفية مما يؤدي إلى المشكلة التي رأيتها في الصورة الأولى في هذه الصفحة.
 في البداية عليك أن تفهم أن الكثير من برامج الطرفية (Terminal) مثل GNOME Terminal وXfce4-Terminal وغيرها تستعمل مكتبة برمجية اسمها VTE هي المسؤولة عن عرض الطرفية. أي أن هذه البرامج في الواقع هي مجرد نوافذ وقوائم، بينما محتوى الطرفية الحقيقي (الشاشة السوداء التي تكتب فيها الأوامر) هي قادمة من مكتبة VTE. وبالتالي المسؤول عن عرض النصوص داخل الطرفية هو هذه المكتبة وليس برامج الطرفية.
-وبالتالي أيضًا فإن إصلاح مشاكل اللغة العربية داخل الطرفية يكون في هذه المكتبة ولا يكون من التطبيق نفسها.
+وبالتالي أيضًا فإن إصلاح مشاكل اللغة العربية داخل الطرفية يكون في هذه المكتبة ولا يكون من التطبيق نفسه.
 لحسن الحظ وبعد بحثٍ وتنقيب اكتشفنا أن [[https://terminal-wg.pages.freedesktop.org/bidi/|مكتبة VTE تدعم اتجاه RTL منذ 2019م]]، لكنه غير مفعّل افتراضيًا بسبب عدم وجود الاختبارات الكافية لجودة هذا الدعم بالإضافة لبعض المشاكل الصغيرة، ونعمل على حلها في [[:taqweem-team|فريق تقويم]] لجعل هذا الخيار افتراضيًا لمستخدمي لينكس العرب ولكن الأمر لم يكتمل بعد. ومع ذلك فيمكنك أنت أن تفعّل هذا الخيار على نظامك بحيث تعرض لك النصوص باتجاه RTL.
@@ سطر 47: / سطر 43: @@
 </code>
-{{  https://linux-2-day.comhttps://linux-2-day.com//lib/plugins/ckgedit/fckeditor/userfiles/image/after.png?nolink&  }}يمكنك إضافة الأمر المذكور إلى نهاية ملف <wrap hi>.bashrc</wrap> (ملف مخفي في مجلد المنزل الخاص بك)، مما يؤدي إلى تطبيق هذا الأمر تلقائيًا في كل طرفية تفتحها دون الحاجة لتكتب الأمر أنت بنفسك كل مرّة. فقط من سطر الأوامر حرر الملف:
+وستلاحظ أن الطرفية صارت تدعم عرض النصوص العربية من اليمين إلى اليسار الآن:
+[[https://linux-2-day.com/lib/exe/fetch.php?tok=7609c0&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/after.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/after.png?direct&846x562  }}]]
+يمكنك إضافة الأمر المذكور إلى نهاية ملف <wrap hi>.bashrc</wrap> (ملف مخفي في مجلد المنزل الخاص بك، يُنفّذ عند كل مرة تُفتح الطرفية فيها تلقائيًا)، مما يؤدي إلى تطبيق هذا الأمر تلقائيًا في كل طرفية تفتحها دون الحاجة لتكتب الأمر أنت بنفسك كل مرّة. فقط من سطر الأوامر حرر الملف:
 <code>
 nano ~/.bashrc
 </code>
-وانزل إلى نهاية الملف واكتب الأمر السابق.
+وانزل إلى نهاية الملف واكتب الأمر السابق، ثم اخرج عبر الضغط على <wrap hi>Ctrl + X</wrap>، أو إن شئت فيمكنك تحرير الملف بأي طريقة تريدها.
 ===== فرض اتجاه RTL في طرفية لينكس =====
+هناك ميزة أخرى في طرفية VTE أكثر تطرفًا وهي إجبار جميع النصوص - بغض النظر عن كونها أجنبية أو عربية - على أن تكون من اليمين إلى اليسار. هذا الخيار ليس جيدًا ليكون هو الخيار الافتراضي لطرفية لينكس لأن معظم الأوامر والنصوص المعروضة في الطرفية تكون باللغات الأجنبية، وبالتالي لن تُعرض بشكل جيد إن أُجبرت على أن تكون باتجاه RTL، لكنه قد يكون خيارًا جيدًا إن كنت تريد تطوير تطبيقات سطر أوامر عربية 100%. حينها يمكنك أنت التحكّم بجميع النصوص ولا يهمّك المستخدمون الأجانب فالبرنامج عربي وموجّه للعرب، وبالتالي يمكنك إجبار عرض النصوص كـRTL في تطبيقك.
+لفعل ذلك، أضف السطر التالي إلى نهاية ملف <wrap hi>.bashrc</wrap> الخاص بك:
+<code>
+printf "\e[2 k"
+</code>
+وافتح الطرفية من جديد، وستجد بعدها أن جميع النصوص صارت مجبورة على العرض كـRTL، مما قد يظهر لك بعض العلل المُضحكة في الطرفية:
+[[https://linux-2-day.com/lib/exe/fetch.php?tok=696c86&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-15_12-10.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/2023-01-15_12-10.png?direct&773x533  }}]]
+تابع المثال التالي لرؤية كيفية تطوير تطبيق سطر أوامر عربي 100% باتجاه RTL.
 ===== مثال برمجي على تطبيق طرفية عربي على لينكس =====
+إذا كان لديك تطبيق سطر أوامر مكتوب ببايثون (أو أي لغة أخرى) فأنت بحاجة إلى تفعيل هذه الميزات على طرفيّة المستخدم قبل أن تشغّل برنامجك. لكن بالطبع لا تريد أن تنشر هذه التعليمات لكل مستخدم وتطلب منه أن يفعل كذا وكذا لتفعيل هذه الميزات، بل تريد أن تكون افتراضية في برنامجك لأريحيّة المستخدم وسهولة الاستخدام.
+الحل لفعل ذلك هو أن تكتب ملف سكربت (Shell Script)، يفعّل هذه الميزة في طرفية خارجية ثم بنفس الوقت يقوم بتشغيل برنامجك في تلك الطرفية التي تفرض اتجاه RTL.
+سترى هنا مثالًا لبرنامج سطر أوامر مكتوب بمكتبة <wrap hi>curses</wrap> لبايثون. يقوم هذا البرنامج بتشكيل أي جملة عربية تدخلها عبر [[https://github.com/linuxscout/mishkal|مكتبة مِشكَال من تطوير د. طه زروقي]].
+اعمل ملفًا جديدًا اسمه <wrap hi>run.sh</wrap> وضع هذه المحتويات داخله:
+<file bash run.sh>
+terms=(x-terminal-emulator gnome-terminal konsole xfce4-terminal xterm uxterm)
+for t in ${terms[*]}
+do
+    if [ $(command -v $t) ]
+    then
+        detected_term=$t
+        break
+    fi
+done
+$detected_term -e "printf '\e[2 k' && python3 main.py"
+</file>
+واعمل ملفًا جديدًا اسمه <wrap hi>main.py</wrap> وضع هذه المحتويات داخله:
+<file python main.py>
+#!/usr/bin/python3
+import curses, time
+import mishkal.tashkeel
+# Curses interface.
+stdscr = curses.initscr()
+# Tashkeel library.
+vocalizer = mishkal.tashkeel.TashkeelClass()
+stdscr.clear()
+curses.cbreak()
+curses.echo()
+stdscr.keypad(True)
+stdscr.addstr("السلام عليكم، أهلًا بك إلى هذا البرنامج لتشكيل النصوص.")
+stdscr.addstr("\n\n\n")
+stdscr.addstr("من تأليف فريق تقويم واعتمادًا على مكتبات خارجية. \n")
+stdscr.addstr("جميع الحقوق غير محفوظة، 2023م، ولا يوجد حقوق أصلًا :)\n")
+stdscr.addstr("---------------------------------------\n")
+stdscr.addstr("أخبرنا، ما هو النص الذي تريد تشكيله؟ اكتبه بالأسفل:\n \n")
+input_string = stdscr.getstr()
+stdscr.addstr("\n")
+stdscr.addstr("النتيجة:\n")
+stdscr.refresh()
+x = input_string.decode("utf-8")
+output_string = vocalizer.tashkeel(x)[1:]
+stdscr.addstr(output_string)
+stdscr.addstr("\n\n")
+stdscr.addstr("سيُغلق البرنامج تلقائيًا بعد خمس ثوان!")
+stdscr.refresh()
+time.sleep(5)
+curses.endwin()
+</file>
+ثبّت هذه المكتبات التي نحتاجها ببايثون عبر الأمر <wrap hi>pip</wrap> أو <wrap hi>pip3</wrap>:
+<code>
+git clone https://github.com/linuxscout/mishkal.git
+pip3 install -r miskal/requirements.txt
+</code>
+لدينا كل ما نحتاجه الآن.
+الفكرة هي أن المستخدم لن يشغّل البرنامج مباشرةً عبر أمر مثل <wrap hi>python3 main.py</wrap>، بل سيشغّل الشل سكربت وسيقوم هذا الشل سكربت بدوره بالتعرّف على برامج الطرفية المثبّتة على النظام، ثم يختار واحدًا منها، ثم يفتحه ويطبّق الأمر المطلوب لتفعيل ميزة فرض اتجاه RTL فيها، ثم يقوم بتشغيل ملف البايثون داخل تلك الطرفية التي صارت تدعم اتجاه RTL.
+ميزة هذه الطريقة هي أنك لا تتدخل بإعدادات المستخدم؛ ستبقى طرفية المستخدم على إعداداتها الأساسية حسبما يحدد المستخدم في ملف <wrap hi>.bashrc</wrap> الخاص به (أو على الإعدادات الافتراضية التي هي LTR)، وفي نفس الوقت تضمن أن تطبيقك سيُعرض للمستخدم باتجاه RTL بالكامل، مما يوفر تجربة استخدام جميلة جدًا للغة العربية في الطرفية.
+فقط اكتب الأمر التالي لتشغيل السكربت:
+<code>
+bash run.sh
+</code>
+وستجد أن البرنامج يطلب منك إدخال الجملة باللغة العربية ويشكّلها لك فورًا، ثم ستُغلق النافذة تلقائيًا بعد 5 ثوانٍ:
+[[https://linux-2-day.com/lib/exe/fetch.php?tok=250388&media=https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/command-line-arabic-program-rtl.png|{{  https://linux-2-day.com/lib/plugins/ckgedit/fckeditor/userfiles/image/command-line-arabic-program-rtl.png?direct&942x621  }}]]
+بالطبع يمكنك تغيير البرنامج وتخصيصه حسب حاجتك، ولكن هذا مجرّد مثال ليريك طريقة عمل البرامج العربية من سطر أوامر لينكس.
+<WRAP center round important 90%>
+قد تكون هناك مشاكل بسيطة أثناء محاولة كتابة جملة طويلة في برنامج المثال الذي وفّرناه. لذلك لا تحاول مسح حرف بعد أن تكتبه (عبر زرّ Return مثلًا أو Delete) بل حاول أن تكتب جملة بسيطة فقط واضغط Enter للمتابعة.
+</WRAP>
+يمكنك الآن تطوير تطبيقات سطر أوامر عربية بمكتبة [[https://docs.python.org/3/howto/curses.html|curses]] أو أي مكتبة برمجية أخرى تريدها، فكل ما تحتاجه أن تكون الطرفية تدعم اتجاه RTL كما شرحنا.