الاسم¶

JOE - محرر جو الخاص

بناء الجملة¶

joe [global-options] [ [local-options] filename ]...
jstar [global-options] [ [local-options] filename ]...
jmacs [global-options] [ [local-options] filename ]...
rjoe [global-options] [ [local-options] filename ]...
jpico [global-options] [ [local-options] filename ]...

الوصف¶

إنّ JOE محرر شاشة صدفة قوي. يمتلك واجهة مستخدم "عديمة الأطوار" تشبه العديد من محررات الحاسوب الشخصي سهلة الاستخدام. سيشعر مستخدمو لغات Micro-Pro´s WordStar أو Borland´s "Turbo" وكأنهم في منزلهم. مع ذلك، فإنّ JOE محرر شاشة يونكس كامل المزايا، ويوفر العديد من الخصائص لتحرير البرامج والنصوص.

يُحاكي JOE أيضاً عدة محررات أخرى. JSTAR هو تقليد قريب لـ WordStar مع العديد من امتدادات "JOE". أما JPICO فهو تقليد قريب لمحرر PICO الخاص بنظام بريد Pine، ولكن مع العديد من الامتدادات والتحسينات. JMACS هو تقليد لـ GNU-EMACS. وRJOE هي نسخة مقيدة من JOE، تسمح لك بتحرير الملفات المحددة في سطر الأوامر فقط.

على الرغم من أن JOE هو في الواقع خمسة محررات مختلفة، إلا أنه لا يتطلب سوى ملف تنفيذي واحد، ولكن بخمسة أسماء مختلفة. اسم المحرر متبوعاً بـ "rc" يعطي اسم ملف تهيئة JOE، والذي يحدد سمات المحرر.

إنّ JOE برمجية حرة؛ يمكنك توزيعها و/أو تعديلها بموجب شروط رخصة جنو العمومية كما نشرتها مؤسسة البرمجيات الحرة. يتوفر JOE عبر الإنترنت على http://www.sourceforge.net/projects/joe-editor.

الاستخدام¶

لبدء المحرر، اكتب joe متبوعاً بصفر أو أكثر من أسماء الملفات التي تريد تحريرها. يمكن أن يسبق كل اسم ملف إعداد خيار محلي (انظر جدول الخيارات المحلية أدناه). كما يمكن وضع خيارات شاملة أخرى، تنطبق على المحرر ككل، في سطر الأوامر (انظر جدول الخيارات الشاملة أدناه). إذا كنت تحرر ملفاً جديداً، يمكنك إما إعطاء اسم الملف الجديد عند استدعاء المحرر، أو داخل المحرر عند حفظ الملف الجديد. يتم توفير بناء جملة معدل لأسماء الملفات للسماح لك بتحرير مخرجات البرنامج، أو الإدخال/الإخراج القياسي، أو أجزاء من الملفات أو الأجهزة. انظر قسم أسماء الملفات أدناه للحصول على التفاصيل.

بمجرد دخولك إلى المحرر، يمكنك كتابة النص واستخدام تسلسلات محارف التحكم الخاصة لأداء مهام التحرير الأخرى. لمعرفة ماهية تسلسلات محارف التحكم، اقرأ بقية صفحة الدليل هذه أو اكتب ^K H للحصول على المساعدة داخل المحرر.

والآن لبعض المعلومات الحاسوبية الغامضة:

تعني العلامة ^ أن تضغط باستمرار على مفتاح Control أثناء الضغط على المفتاح التالي (بنفس الطريقة التي يعمل بها مفتاح Shift للحروف الكبيرة). يتم تكرار عدد من تسلسلات مفاتيح التحكم على مفاتيح أخرى، بحيث لا تحتاج إلى الضغط على مفتاح التحكم: سيعمل Esc بدلاً من ^[، وسيعمل Del بدلاً من ^?، وسيعمل Backspace بدلاً من ^H، وسيعمل Tab بدلاً من ^I، وسيعمل Return أو Enter بدلاً من ^M، وسيعمل Linefeed بدلاً من ^J. قد تسبب لك بعض لوحات المفاتيح مشكلة مع بعض مفاتيح التحكم. يمكن عادةً إدخال ^_ و ^^ و ^@ دون الضغط على مفتاح العالي (أي جرب ^- و ^6 و ^2). قد تعيد لوحات المفاتيح الأخرى تعيين هذه المفاتيح إلى مفاتيح أخرى. جرب: ^. و ^, و ^/. يمكن عادةً استخدام ^Space بدلاً من ^@. يتم تفسير ^\ و ^] بواسطة العديد من برامج الاتصال، بما في ذلك telnet و kermit. عادةً ما تضغط فقط على المفتاح مرتين لجعله يمر عبر برنامج الاتصال.

في بعض لوحات المفاتيح، الضغط باستمرار على مفتاح Alt أثناء الضغط على مفتاح آخر هو نفسه كتابة Esc قبل كتابة المفتاح الآخر.

بمجرد كتابة ^K H، تظهر نافذة المساعدة الأولى في أعلى الشاشة. يمكنك الاستمرار في إدخال النص وتحريره بينما نافذة المساعدة مفتوحة. للتصفح عبر مواضيع أخرى، اضغط على Esc , و Esc . (أي Esc , و Esc .). استخدم ^K H لإغلاق نافذة المساعدة.

يمكنك تخصيص تخطيط لوحة المفاتيح، وشاشات المساعدة، وعدد من السلوكيات المبدئية عن طريق نسخ ملف تهيئة JOE (عادةً /etc/joe/joerc) إلى .joerc في دليلك الرئيسي ثم تعديله. انظر قسم joerc أدناه.

لاستخدام JOE كمحررك المبدئي للبريد الإلكتروني والأخبار، تحتاج إلى ضبط متغيرات البيئة EDITOR و VISUAL في ملف تهيئة الصدفة الخاص بك (.cshrc أو .profile) للإشارة إلى JOE (يوجد JOE عادةً في /usr/bin/joe).

هناك عدد من معاملات الاستدعاء الغامضة الأخرى التي قد يلزم ضبطها، خاصةً إذا كانت شاشة الطرفية لا تُحدث كما تظن. انظر قسم متغيرات البيئة أدناه.

خيارات سطر الأوامر¶

يمكن أيضاً تحديد هذه الخيارات في ملف joerc. يمكن ضبط الخيارات المحلية بناءً على امتداد اسم الملف. البرامج (الامتدادات .c أو .h أو .p) عادةً ما يكون الإزاحة التلقائية مفعلة فيها. ولف الكلمات مفعل في الملفات الأخرى، ولكن ملفات rc يكون معطلاً فيها.

يُفعل الخيار عندما يُعطى بهذا الشكل:

-wordwrap

يُعطل الخيار عندما يُعطى بهذا الشكل:

--wordwrap

تأخذ بعض الخيارات وسائط. تُعطى الوسائط بهذا الشكل:

-lmargin 5

يمكن تحديد الخيارات الشاملة التالية في سطر الأوامر:

• asis
  ستُرسل المحارف التي تزيد رموزها عن 127 إلى الطرفية كما هي، بدلاً من إرسالها كعكس للمحرف المقابل الأقل من 128. إذا لم ينجح ذلك، فافحص خادم الطرفية الخاص بك. ليس لهذا الخيار أي تأثير في حال استُخدم ترميز UTF-8.

• assume_256color
  افترض أن محاكي الطرفية الشبيه بـ ANSI يدعم 256 لوناً حتى لو ذكر مدخل termcap أنه لا يدعمها.

• assume_color
  افترض أن محاكي الطرفية الشبيه بـ ANSI يدعم الألوان حتى لو ذكر مدخل termcap أنه لا يدعمها.

• text_color color
  اضبط لون النص.

• status_color color
  اضبط لون شريط الحالة.

• help_color color
  اضبط لون المساعدة.

• menu_color color
  اضبط لون القوائم.

• prompt_color color
  اضبط لون المحثات.

• msg_color color
  اضبط لون الرسائل.

• autoswap
  بادل آلياً بين ^K B و ^K K إذا لزم الأمر لتمييز كتلة صالحة أثناء أوامر نسخ/نقل الكتل.

• backpath path
  يضبط المسار إلى دليل حيث ستُخزن جميع ملفات النسخ الاحتياطي. إذا لم يُضبط هذا (الوضع المبدئي)، ستُخزن ملفات النسخ الاحتياطي في الدليل الذي يحتوي على الملف.

• baud nnn
  اضبط معدل البود لأغراض تحسين شاشة الطرفية (يتجاوز القيمة التي أبلغ عنها stty). يُدرج JOE تأخيرات لمعدلات البود الأقل من 19200، مما يتجاوز تخزين tty المؤقت بحيث يقطع الإدخال المسبق مخرجات الشاشة. لن تُستخدم أوامر التمرير لمعدل 38400 بود فما فوق. هذا مفيد لـ X-terms وأجهزة tty للصدفة الأخرى التي لا تمر فعلياً عبر خط تسلسلي.

• beep
  مكّن التنبيهات الصوتية عندما ترجع أوامر التحرير أخطاءً، على سبيل المثال عندما يتجاوز المؤشر الحدود القصوى.

• break_links
  عند تمكينه، يحذف JOE الملف أولاً قبل كتابته من أجل كسر الروابط الصلبة والروابط الرمزية.

• break_hardlinks
  عند تمكينه، وإذا لم يكن الملف رابطاً رمزياً، يحذف JOE الملف أولاً قبل كتابته من أجل كسر الروابط الصلبة.

• brpaste
  عندما يبدأ JOE، يُرسل أمراً إلى محاكي الطرفية يمكن "وضع اللصق المجمع" (ولكن فقط إذا بدت الطرفية تدعم مجموعة أوامر ANSI). في هذا الوضع، يتم تجميع النص الملصق في النافذة بين ESC [ 2 0 0 ~ و ESC [ 2 0 1 ~.

• columns nnn
  اضبط عدد الأعمدة في محاكي الطرفية (في حال كان مدخل termcap خاطئاً). هذا مفيد فقط في الأنظمة القديمة التي لا تحتوي على ioctl "get window size".

• csmode
  مكّن وضع البحث المستمر: تكرر ضغطات ^K F المتعاقبة البحث الحالي بدلاً من المطالبة ببحث جديد.

• dopadding
  مكّن JOE من إرسال محارف NUL للحشو إلى الطرفية (للطرفيات القديمة جداً).

• exask
  عند ضبطه، يطالب ^K X باسم جديد قبل حفظ الملف.

• floatmouse
  عند ضبطه، يمكن لنقرات الفأرة وضع المؤشر بعد نهايات السطور.

• guess_crlf
  عند ضبطه، يحاول JOE تخمين تنسيق الملف سواء كان MS-DOS أو UNIX.

• guess_indent
  عند ضبطه، يحاول JOE تخمين محرف الإزاحة وخطوة الإزاحة بناءً على محتويات الملف. الخوارزمية هي العثور على القاسم المشترك الأكبر للإزاحات الثلاث الأكثر شيوعاً الموجودة في الملف.

• guess_non_utf8
  عند ضبطه، مكن تخمين الملفات التي ليست بترميز UTF-8 في المحليات التي تستخدم UTF-8.

• guess_utf8
  عند ضبطه، مكن تخمين ملفات UTF-8 في المحليات التي لا تستخدم UTF-8.

• guess_utf16
  عند ضبطه، مكن تخمين ملفات UTF-16. إذا اكتُشف ملف UTF-16BE أو UTF-16LE، فسيُحول إلى UTF-8 أثناء التحميل، ويُحول مرة أخرى إلى UTF-16 أثناء الحفظ.

• helpon
  عند ضبطه، ابدأ والمساعدة الفورية مفعلة.

• help_is_utf8
  عند ضبطه، يُفترض أن نص المساعدة في ملف joerc هو بترميز UTF-8.

• icase
  عند ضبطه، يكون البحث غير حساس لحالة الأحرف بشكل مبدئي.

• joe_state
  مكن قراءة وكتابة ملف ~/.joe_state

• joexterm
  اضبط هذا إذا ضُبط xterm بخيار --paste64 لدعم أفضل للفأرة.

• keepup
  يُحدث رقم العمود في شريط الحالة باستمرار عند ضبط هذا الخيار، وإلا فإنه يُحدث مرة واحدة في الثانية فقط.

• language language
  يضبط لغة aspell.

• lightoff
  أوقف تمييز ^K B و ^K K آلياً بعد إجراء عملية على الكتلة.

• lines nnn
  اضبط عدد السطور في محاكي الطرفية (في حال كان مدخل termcap خاطئاً). هذا مفيد فقط في الأنظمة القديمة التي لا تحتوي على ioctl "get window size".

• marking
  مكّن وضع العلامات: يميز ما بين ^K B والمؤشر.

• menu_above
  ضع القوائم فوق المحث بدلاً من تحتها.

• menu_explorer
  ابق في القائمة عند اختيار دليل (وإلا سيُضاف الدليل إلى المسار ويقفز المؤشر عائداً إلى المحث).

• menu_jump
  اقفز إلى قائمة اختيار الملفات عند ضغط Tab Tab.

• mid
  إذا ضُبط هذا الخيار وتحرك المؤشر خارج النافذة، فسيتم تمرير النافذة بحيث يصبح المؤشر في المركز. يُفرض هذا الخيار في الطرفيات البطيئة التي لا تمتلك أوامر تمرير.

• left nn
  يضبط هذا عدد الأعمدة التي تمررها الشاشة إلى اليسار عندما يتجاوز المؤشر الحافة اليسرى أو عند إصدار أمر crawll. إذا كان nn سالباً، فإنه يمثل كسر الشاشة المراد تمريره. على سبيل المثال، -2 يعني تمرير 1/2 الشاشة.

• right nn
  يضبط هذا عدد الأعمدة التي تمررها الشاشة إلى اليمين عندما يتجاوز المؤشر الحافة اليمنى أو عند إصدار أمر crawlr. إذا كان nn سالباً، فإنه يمثل كسر الشاشة المراد تمريره. على سبيل المثال، -3 يعني تمرير 1/3 الشاشة.

• mouse
  مكّن دعم فأرة xterm.

• nobackups
  عطل ملفات النسخ الاحتياطي.

• nocurdir
  عطل بادئة الدليل الحالي في المحثات.

• noexmsg
  عطل رسالة الخروج ("لم يتغير الملف لذا لا يلزم التحديث")

• nolinefeeds
  عطل إرسال تغذية السطور للحفاظ على تأريخ الشاشة في مخزن التمرير الخلفي لمحاكي الطرفية (ذو صلة فقط عند تمكين وضع notite).

• nolocks
  عطل أقفال الملفات المتوافقة مع EMACS.

• nomodcheck
  عطل الفحص الدوري لتعديل الملف.

• nonotice
  يمنع هذا الخيار عرض إشعار حقوق النشر عند بدء المحرر.

• nosta
  يزيل هذا الخيار شريط الحالة العلوي. إنه جيد عندما تريد فقط رؤية نصك على الشاشة أو إذا كنت تستخدم vt52.

• notagsmenu
  عطل قائمة الاختيار للبحث عن الوسوم ذات النتائج المتعددة.

• notite
  عطل تسلسلات ti و te في termcap والتي تُضبط عادةً لحفظ واستعادة محتويات شاشة الطرفية عند بدء وخروج JOE.

• pastehack
  إذا ورد مدخل لوحة المفاتيح ككتلة واحدة، فافترض أنه لصق بالفأرة وعطل الإزاحة التلقائية ولف الكلمات.

• noxon
  عطل التحكم في التدفق ^S و ^Q، مما قد يسمح باستخدام ^S و ^Q كمفاتيح للمحرر.

• orphan
  اجعل الملفات الإضافية المعطاة في سطر الأوامر يتيمة بدلاً من إنشاء نوافذ لها (تُحمل الملفات، ولكنك تحتاج إلى استخدام أوامر تبديل المخزن المؤقت للوصول إليها).

• pg nnn
  اضبط عدد السطور المراد الاحتفاظ بها أثناء التمرير لأعلى ولأسفل (استخدم -1 لنصف حجم النافذة).

• regex
  استخدم بناء جملة التعبيرات النمطية القياسي بشكل مبدئي، بدلاً من بناء جملة JOE (حيث يكون للمحارف الخاصة معناها فقط عندما تسبقها شرطة مائلة عكسية).

• استعد
  اضبط لاستعادة مواضع المؤشر إلى آخر مواضع في الملفات المحررة سابقاً.

• rtbutton
  بادل بين زري الفأرة الأيسر والأيمن.

• search_prompting
  أظهر سلسلة البحث السابقة في أمر البحث (كما في PICO).

• skiptop nnn
  عند ضبطه على N، لا يستخدم JOE أول N من السطور في شاشة الطرفية وتُترك بدلاً من ذلك بمحتوياتها الأصلية. هذا مفيد للبرامج التي تستدعي JOE لترك رسالة للمستخدم.

• square
  فعل وضع الكتلة المستطيلة.

• transpose
  اقلب الصفوف مع الأعمدة في جميع القوائم.

• عنوان
  اعرض السياق (العناوين) في سطر الحالة. عند التفعيل، يظهر هذا السطر الأول من الدالة التي يتواجد فيها المؤشر في سطر الحالة. يحدد ملف بناء الجملة context.jsf السطور التي تعد سطور عناوين.

• نوع
  اختر نوع الملف، متجاوزاً النوع المحدد آلياً. تُعرف أنواع الملفات في ملف ftyperc.

• undo_keep nnn
  يحدد عدد سجلات التراجع التي يجب الاحتفاظ بها (0 يعني غير محدود).

• usetabs
  اضبط للسماح لعمليات الكتلة المستطيلة باستخدام علامات الجدولة.

• wrap
  فعل التفاف البحث إلى بداية الملف.

الخيارات المحلية التالية يمكن تحديدها في سطر الأوامر:

• +nnn
  يبدأ المؤشر عند السطر المحدد.

• إزاحة آلية
  فعل وضع الإزاحة الآلية. عندما تضغط على Enter في سطر مُزاح، تُكرر الإزاحة في السطر الجديد.

• c_comment
  فعل تجاوز ^G لتعليقات لغة C من النمط /.../

• cpara محارف
  يحدد قائمة المحارف التي يمكنها إزاحة الفقرات.

• cnotpara محارف
  يحدد قائمة المحارف التي تبدأ بها السطور التي لا تعد قطعاً جزءاً من الفقرات.

• cpp_comment
  فعل تجاوز ^G لتعليقات لغة ++C من النمط // ...

• crlf
  يستخدم JOE تسلسل CR-LF كنهاية للسطر بدلاً من مجرد LF. هذا مخصص لتحرير ملفات MS-DOS أو VMS.

• encoding الترميز
  اضبط ترميز الملف (مثل utf-8 أو 8859-1).

• flowed
  اضبط لفرض مسافة إضافية بعد كل سطر من فقرة باستثناء الأخير.

• force
  عند ضبطه، يُلحق سطر جديد في نهاية الملف إذا لم يكن موجوداً عند حفظ الملف.

• french
  عند ضبطه، تُدرج مسافة واحدة فقط بعد النقاط عند إعادة تنسيق الفقرات بدلاً من مسافتين.

• hex
  فعل وضع التفريغ الست عشري.

• إبراز
  فعل إبراز بناء الجملة.

• highlighter_context
  فعل استخدام ملف بناء الجملة لتحديد التعليقات والسلاسل النصية التي يجب تجاوزها أثناء مطابقة ^G.

• indentc nnn
  يحدد محرف الإزاحة للإزاحة يساراً ويميناً (^K , و ^K .). استخدم 32 للمسافة Space، و 9 لعلامة الجدولة Tab.

• indentfirst
  عند ضبطه، يقفز مفتاح Home الذكي إلى نقطة الإزاحة أولاً، وإلا فإنه يقفز إلى العمود 1 أولاً.

• istep nnn
  يحدد خطوة الإزاحة.

• linums
  فعل عرض أرقام السطور.

• lmargin
  اضبط الهامش الأيسر.

• lmsg
  حدد رسالة شريط الحالة في الجانب الأيسر.

• overwrite
  فعل وضع الكتابة الفوقية. الكتابة تمحو المحارف الموجودة بدلاً من الإدراج قبلها.

• صورة
  فعل وضع "الصورة"- يسمح للمؤشر بتجاوز نهايات السطور.

• pound_comment
  يتجاهل ^G تعليقات # ...

• purify
  أصلح الإزاحة إذا لزم الأمر قبل الإزاحة أو المسافة الخلفية الذكية. على سبيل المثال، إذا كانت الإزاحة تستخدم مزيجاً من علامات الجدولة والمسافات، وكان indentc هو المسافة، فستُحول الإزاحة إلى مسافات بالكامل قبل عملية الإزاحة.

• rdonly
  اضبط وضع القراءة فقط.

• rmargin nnn
  اضبط الهامش الأيمن.

• rmsg سلسلة
  حدد رسالة شريط الحالة في الجانب الأيمن.

• semi_comment
  يتجاهل ^G تعليقات ; ...

• single_quoted
  يتجاهل ^G السلاسل ´...´

• smartbacks
  فعل المسافة الخلفية وعلامة الجدولة الذكية. عند ضبط هذا الوضع، تقوم المسافة الخلفية وعلامة الجدولة بالإزاحة أو إلغاء الإزاحة بناءً على قيم خياري istep و indentc.

• smarthome
  مفتاح Home يحرك المؤشر أولاً إلى بداية السطر، ثم إذا ضُغط عليه مجدداً، إلى أول محرف غير فارغ.

• smsg سلسلة
  حدد تنسيق أمر الحالة عندما يكون المؤشر على محرف.

• مسافات
  أدرج مسافات عند الضغط على مفتاح Tab.

• syntax بناء_الجملة
  اضبط بناء الجملة لإبراز بناء الجملة.

• tab nnn
  اضبط عرض وقفة علامة الجدولة.

• text_delimiters قائمة محددات الكلمات
  أعطِ قائمة بمحددات الكلمات التي سيتنقل خلالها ^G.

على سبيل المثال، "begin=end:if=elif=else=endif" يعني أن ^G سيقفز بين if و elif و else و endif المتطابقة.

• vhdl_comment
  يتجاهل ^G تعليقات -- ...

• wordwrap
  يقوم JOE بلف الكلمة السابقة عندما تكتب متجاوزاً الهامش الأيمن.

• zmsg سلسلة
  حدد تنسيق أمر الحالة عندما يكون المؤشر في نهاية الملف.

• xmsg سلسلة
  حدد رسالة بدء التشغيل (عادة ما تكون إشعار حقوق النشر).

• aborthint سلسلة
  أعطِ تسلسل المفاتيح ليظهر في المحثات للإجهاض (عادة ^C).

• helphint سلسلة
  أعطِ تسلسل المفاتيح ليظهر في المحثات للمساعدة (عادة ^K H).

التحرير الأساسي¶

عندما تكتب المحارف في المحرر، فإنها تُدرج عادةً في الملف الجاري تحريره (أو تُلحق بالملف إذا كان المؤشر في نهايته). هذا هو وضع التشغيل العادي للمحرر. إذا كنت تريد استبدال نص موجود، فعليك حذف النص القديم قبل أو بعد كتابة النص البديل. يمكن استخدام مفتاح Backspace لحذف النص: حرك المؤشر إلى يمين النص الذي تريد حذفه واضغط Backspace عدداً من المرات.

اضغط على مفتاح Enter أو Return لإدراج فاصل أسطر. على سبيل المثال، إذا كان المؤشر في منتصف سطر وضغطت على Enter، فسيُقسم السطر إلى سطرين مع ظهور المؤشر في بداية السطر الثاني. اضغط Backspace في بداية السطر للتخلص من فاصل الأسطر.

استخدم مفاتيح الأسهم للتنقل في الملف. إذا كانت لوحة المفاتيح لا تحتوي على مفاتيح أسهم (أو إذا كانت لا تعمل لسبب ما)، فاستخدم ^F للتحرك للأمام (يميناً)، و ^B للتحرك للخلف (يساراً)، و ^P للتحرك إلى السطر السابق (لأعلى)، و ^N للتحرك إلى السطر التالي (لأسفل). مفاتيح الأسهم اليمنى واليسرى تتحرك ببساطة للأمام أو للخلف محرفاً واحداً في كل مرة عبر النص: إذا كنت في بداية سطر وضغطت على السهم الأيسر، فستنتهي في نهاية السطر السابق. مفاتيح الأسهم للأعلى والأسفل تتحرك للأمام وللخلف بعدد كافٍ من المحارف بحيث يظهر المؤشر في نفس العمود الذي كان فيه في السطر الأصلي.

إذا كنت تريد إزاحة النص الذي تدخله، يمكنك استخدام مفتاح Tab. يقوم هذا بإدراج محرف تحكم خاص يجعل المحارف التي تتبعه تبدأ عند وقفة علامة الجدولة التالية. تحدث وقفات علامات الجدولة عادةً كل 8 أعمدة، ولكن يمكن تغيير ذلك باستخدام أمر ^T D. غالباً ما يضبط مبرمجو PASCAL و C وقفات علامات الجدولة عند كل 4 أعمدة.

إذا اختلت شاشة الطرفية لسبب ما (على سبيل المثال، إذا تلقيت إشعار بريد من biff)، يمكنك جعل المحرر يُحدث الشاشة عن طريق الضغط على ^R.

هناك العديد من المفاتيح الأخرى لحذف النص والتنقل في الملف. على سبيل المثال، اضغط على ^D لحذف المحرف الذي يقف عليه المؤشر بدلاً من الحذف للخلف مثل Backspace. كما سيحذف ^D فاصل الأسطر إذا كان المؤشر في نهاية السطر. اكتب ^Y لحذف السطر بأكمله الذي يتواجد فيه المؤشر أو ^J لحذف النص من موضع المؤشر إلى نهاية السطر فقط.

اضغط ^A لتحريك المؤشر إلى بداية السطر الذي يتواجد فيه. اضغط ^E لتحريك المؤشر إلى نهاية السطر. اضغط ^U أو ^V لتمرير المؤشر للأعلى أو للأسفل بمقدار نصف شاشة.
"التمرير" يعني أن النص الموجود على الشاشة يتحرك، لكن المؤشر يبقى في نفس المكان بالنسبة للشاشة. اضغط ^K U أو ^K V لتحريك المؤشر إلى بداية أو نهاية الملف. انظر إلى شاشات المساعدة في المحرر لتجد المزيد من أوامر الحذف والتحريك.

إذا ارتكبت خطأً، يمكنك الضغط على ^_ للتراجع عنه. في معظم لوحات المفاتيح تضغط فقط على ^- للحصول على ^_، ولكن في بعضها قد تضطر إلى الضغط على مفتاحي Shift و Control معاً في نفس الوقت للحصول عليه. إذا تراجعت أكثر من اللازم، يمكنك إعادة التغييرات للوجود بالضغط على ^^ (اكتب هذا باستخدام ^6 فقط في معظم لوحات المفاتيح).

مجموعات المحارف و UTF-8¶

يتعامل جو (JOE) أصلياً مع فئتين من مجموعات المحارف: UTF-8 والمشفرة بالبايت (مثل ISO-8859-1). بالنسبة لمجموعات المحارف هذه، يُحمل الملف كما هو في الذاكرة، ويُحفظ تماماً أثناء الحفظ، حتى لو كان يحتوي على أخطاء في ترميز UTF-8.

لا يمكنه بعد التعامل أصلياً مع الفئات الرئيسية الأخرى مثل UTF-16 أو GB2312. هناك قيود أخرى: يجب أن تستخدم مجموعات المحارف LF (0x0A) أو CR-LF (0x0D - 0x0A) كمنهيات للأسطر، ويجب أن تكون المسافة 0x20 وعلامة التبويب (tab) 0x09. أساساً، يجب أن تكون الملفات ملفات نصية متوافقة مع UNIX أو MS-DOS.

هذا يعني أن EBCDIC لن يعمل بشكل صحيح (ولكنك ستحتاج إلى التعامل مع أسطر بطول سجل ثابت على أي حال) ومجموعات المحارف التي تستخدم أسطراً تنتهي بـ CR (MACs) لن تعمل بعد.

يدعم جو (JOE) الآن UTF-16 (كلا من الطرفية الكبيرة والطرفية الصغيرة). يدعم UTF-16 عن طريق التحويل إلى UTF-8 أثناء التحميل، والتحويل مرة أخرى إلى UTF-16 أثناء الحفظ.

يمكن أن يكون للطرفية والملف ترميزات مختلفة. سيقوم جو (JOE) بالترجمة بينهما. حالياً، يجب أن يكون أحدهما UTF-8 لكي تعمل الترجمة.

تُحدد مجموعة المحارف للطرفية ومجموعة المحارف المبدئية المفترضة للملفات بواسطة متغير البيئة ´LC_ALL´ (وإذا لم يكن مضبوطاً، يُفحص أيضاً LC_CTYPE و LANG).

على سبيل المثال، إذا ضُبط LC_ALL على:

de_DE

فستكون مجموعة المحارف ISO-8859-1.

إذا ضُبط LC_ALL على:

de_DE.UTF-8

ستكون مجموعة المحارف UTF-8.

اضغط ^T E لتغيير ترميز الملف. اضغط Tab Tab عند هذا المحث للحصول على قائمة بالترميزات المتاحة. هناك عدد من مجموعات المحارف المضمنة، بالإضافة إلى أنه يمكنك تثبيت مجموعات محارف في الدليلين ~/.joe/charmaps و /usr/share/joe/charmaps.

افحص: /usr/share/i18n/charmaps للحصول على أمثلة لملفات مجموعات المحارف. ستعمل مجموعات المحارف الموجهة بالبايت فقط. أيضاً، لا ينبغي أن يكون الملف مضغوطاً بـ gzipped (جميع ملفات خرائط المحارف في /usr/share/i18n/charmaps على حاسوبي كانت مضغوطة). المحلل سيئ للغاية، لذا أساساً يجب أن يبدو الملف تماماً مثل الملف المثال في /usr/share/joe/charmaps.

يمكنك الضغط على ^K Space لرؤية مجموعة المحارف الحالية.

يمكنك الضغط على ^Q x لإدخال محرف يونيكود (Unicode) إذا كان ترميز الملف هو UTF-8.

المحثات¶

تسجل معظم المحثات تاريخاً للاستجابات التي تقدمها لها. يمكنك الضغط على السهم لأعلى ولأسفل للتنقل عبر هذه التواريخ.

المحثات هي في الواقع نوافذ ذات سطر واحد بدون سطر حالة، لذا يمكنك استخدام أي أمر تحرير تستخدمه عادةً على النص داخل المحثات. تاريخ المحث هو في الواقع مجرد أسطر أخرى من نفس "ملف المحث". وبالتالي يمكنك البحث للخلف عبر تاريخ المحث باستخدام أمر ^K F العادي إذا أردت.

بما أن المحثات عبارة عن نوافذ، يمكنك أيضاً التبديل للخروج منها باستخدام ^K P و ^K N.

أين أنا؟¶

اضغط ^K Space ليقوم جو (JOE) بالإبلاغ عن رقم السطر، ورقم العمود، ورقم البايت في السطر الأخير من الشاشة. يُعرض أيضاً الرقم المرتبط بالمحرف الذي يقف عليه المؤشر (كود ASCII الخاص به). يمكنك جعل رقم السطر و/أو رقم العمود معروضين دائماً على سطر الحالة عن طريق وضع تسلسلات الهروب المناسبة في سلاسل إعداد سطر الحالة. حرر ملف joerc للحصول على التفاصيل.

ماذا لو ضغطت <strong>^K</strong> بالخطأ؟¶

اضغط على مفتاح المسافة. يؤدي هذا إلى تشغيل أمر غير ضار (يعرض رقم السطر على شريط الحالة).

تعليق المحرر مؤقتاً¶

إذا كنت بحاجة إلى إيقاف المحرر مؤقتاً والعودة إلى الصدفة، فاضغط ^K Z. قد ترغب في فعل ذلك لإيقاف أي شيء تحرره و الرد على رسالة بريد إلكتروني أو قراءة صفحة الدليل هذه، على سبيل المثال. سيتعين عليك كتابة fg أو exit (سيُخبرك أيهما عند الضغط على ^K Z) للعودة إلى المحرر.

البحث عن نص¶

اضغط ^K F ليقوم المحرر بالبحث للأمام أو للخلف عن قطعة نصية (سلسلة نصية) لك. سيُطلب منك إدخال النص الذي تريد البحث عنه. بعد الضغط على Enter، سيُطلب منك إدخال الخيارات.
يمكنك فقط الضغط على Enter مرة أخرى ليقوم المحرر بالبحث فوراً للأمام عن النص، أو يمكنك إدخال واحد أو أكثر من هذه الخيارات:

•

b

البحث للخلف بدلاً من الأمام.

•

i

معاملة الحروف الكبيرة والصغيرة كأنها متماثلة عند البحث. عادةً تعتبر الحروف الكبيرة والصغيرة مختلفة.

•

nnn

(حيث nnn هو رقم) إذا أدخلت رقماً، سيبحث جو (JOE) عن التكرار رقم N للنص. هذا مفيد للانتقال إلى أماكن محددة في ملفات مرتبة بطريقة منتظمة ما.

•

r

استبدال النص. إذا أدخلت الخيار r، فسيُطلب منك بعد ذلك نص الاستبدال. في كل مرة يجد فيها المحرر نص البحث، سيُطلب منك ما إذا كنت تريد استبدال نص البحث الموجود بنص الاستبدال. تضغط: y لاستبدال النص ثم العثور على التكرار التالي، n لعدم استبدال هذا النص ولكن العثور على التكرار التالي، r لاستبدال جميع التكرارات المتبقية لنص البحث في بقية الملف دون طلب تأكيد (يخضع ذلك لخيار nnn أعلاه)، أو ^C لإيقاف البحث والاستبدال.

يمكنك أيضاً الضغط على B أو Backspace للرجوع إلى النص الذي عُثر عليه سابقاً (إذا كان قد استُبدل، فسيُتراجع عن الاستبدال).

•

a

يغطي البحث جميع المخازن المؤقتة المحملة. لذا لاستبدال جميع مثيلات "foo" بـ "bar" في جميع ملفات .c في الدليل الحالي:

joe *.c


   ^K F


       foo <Enter>


       ra <Enter>


       bar <Enter>

•

e

يغطي البحث جميع الملفات في قائمة أخطاء grep أو make. يمكنك استخدام أمر UNIX لإنشاء قائمة بالملفات والبحث والاستبدال عبر القائمة. لذا لاستبدال جميع مثيلات "foo" بـ "bar" في جميع ملفات .c التي تبدأ بـ f. يمكنك أيضاً استخدام "ls" و "find" بدلاً من grep لإنشاء قائمة الملفات.

Esc G


  grep -n foo f*.c <Enter>
^K F


       foo <Enter>


   re <Enter>


   bar <Enter>

•

x

سيستخدم جو (JOE) الصيغة القياسية للتعبيرات النمطية إذا أُعطي هذا الخيار. في الصيغة القياسية، يكون لهذه المحارف معانيها الخاصة مباشرة، ولا يلزم الهروب منها بشرطة مائلة عكسية: ., *, +, ?, {, }, (, ), |, ^, $ و [.

•

y

سيستخدم جو (JOE) صيغة JOE للتعبيرات النمطية بدلاً من الصيغة القياسية. هذا يتجاوز خيار "-regex".

•

v

سيرسل جو (JOE) معلومات تنقيح حول التعبير النمطي إلى سجل بدء التشغيل. يمكن عرض السجل باستخدام أمر showlog.

يمكنك الضغط على ^L لتكرار البحث السابق.

يمكنك الضغط على ^K H عند محث خيارات البحث والاستبدال لإظهار قائمة بجميع خيارات البحث والاستبدال.

بحث تزايدي¶

استخدم Esc S لبدء بحث تزايدي للأمام، أو Esc R لبدء بحث تزايدي للخلف. بينما تكتب سلسلة البحث، سيقفز المؤشر إلى أول نص يطابق التعبير النمطي الذي أدخلته حتى الآن.

اضغط على Esc S أو Esc R مجددًا للعثور على التكرار التالي للنص أو لتبديل اتجاه البحث.

^S و ^\ و ^L لها نفس تأثير Esc S. ولـ ^R نفس تأثير Esc R. هذه المفاتيح مخصصة لدعم JMACS.

اضغط على Backspace للتراجع عن إجراء البحث التزايدي الأخير. قد يكون الإجراء الأخير تكرارًا لبحث سابق أو إدخال محرف جديد.

استخدم ^Q لإدراج محارف تحكم في نص البحث. سابقًا، كان يمكن استخدام ` لهذا الغرض أيضًا.

اضغط على أي مفتاح آخر للخروج من البحث التزايدي.

الانتقال إلى المحدد المطابق¶

اضغط ^G للقفز بين المحددات المتطابقة. يعمل هذا على كل من محددات المحارف (مثل ´(´ و ´)´) ومحددات الكلمات للغات مثل Pascal و Verilog التي تستخدم "begin" و "end" لتحديد الكتل. كما يعمل أيضًا لمطابقة وسوم البداية والنهاية في XML. إذا كانت الكلمة غير معروفة، سيبدأ ^G بحثًا مع نقل الكلمة إلى حث البحث.

لكي يعمل ^G على محددات الكلمات، يجب وضع المؤشر على الحرف الأول من الكلمة. لذا في XML، إذا كان المؤشر على < في <foo>، فسيقفز إلى >. ولكن إذا كان على ´f´، فسيقفز إلى </foo> المطابق. وبالمثل، في لغة C، سيقفز ^G بين #if و #else و #endif، ولكن عليك وضع المؤشر على الحرف، وليس على ´#´.

^G ذكي بما يكفي لتجاوز المحددات الموجودة في نصوص مقتبسة أو ضمن تعليقات. تحتاج لإخبار JOE كيف تشير لغتك إلى ذلك: راجع ملف ftyperc للحصول على أمثلة حول كيفية القيام بذلك.

هناك عدد من الخيارات التي تتحكم في سلوك ^G. تتحكم هذه الخيارات في أنواع التعليقات التي يمكن لـ ^G تجاوزها:

• c_comment
• cpp_comment
• pount_comment
• semi_comment
• vhdl_comment

تحدد هذه الخيارات أنواع السلاسل التي يمكن لـ ^G تجاوزها:

• single_quoted
• double_quoted

يسمح هذا الخيار لملف بناء جملة مشروح بتحديد النص الذي يمكن اعتباره تعليقات أو سلاسل يمكن لـ ^G تجاوزها:

•

highlighter_context

يفعّل هذا الخيار استخدام ملفات بناء الجملة لتحديد التعليقات والسلاسل التي يجب تجاوزها أثناء مطابقة ^G. يجب شرح حالات ملف بناء الجملة بالكلمات المفتاحية string و comment ليعمل هذا.

•

text_delimiters

يوفر هذا الخيار قائمة بمحددات الكلمات للمطابقة. على سبيل المثال، "begin=end:if=elif=else=endif" تعني أن ^G سيقفز بين if و elif و else و endif المتطابقة. كما سيقفز أيضًا بين begin و end.

يحتوي ^G على جدول مدمج لمطابقة محددات المحارف - فهو يعرف أن ( تتوافق مع ).

يحتوي ^G على محلل مدمج للتعامل مع مطابقة وسوم البداية والنهاية لـ XML.

المناطق¶

إذا كنت تريد نقل قسم معين من النص أو نسخه أو حفظه أو حذفه، يمكنك القيام بذلك باستخدام الكتل المظللة. أولاً، حرك المؤشر إلى بداية قسم النص الذي تريد العمل عليه، واضغط ^K B. ثم حرك المؤشر إلى المحرف الذي يلي نهاية النص الذي تريد التأثير عليه واضغط ^K K. سيُظلل النص بين ^K B و ^K K. يمكنك الآن تحريك المؤشر إلى مكان آخر في مستندك والضغط على ^K M لنقل النص المظلل إلى هناك.
يمكنك الضغط على ^K C لعمل نسخة من النص المظلل وإدراجها حيث يوضع المؤشر. و ^K Y لحذف النص المظلل. و ^K W لكتابة النص المظلل في ملف.

أمر مفيد للغاية هو ^K /، الذي يمرر كتلة من النص عبر أمر UNIX. على سبيل المثال، إذا اخترت قائمة كلمات باستخدام ^K B و ^K K، ثم كتبت ^K / sort، فستُفرز قائمة الكلمات. أمر UNIX مفيد آخر لـ ^K / هو tr. إذا كتبت ^K / tr a-z A-Z، فستُحول جميع الحروف في الكتلة المظللة إلى أحرف كبيرة.

إزاحة كتل البرامج¶

يُبدل وضع الإزاحة الآلية باستخدام أمر ^T I. عادةً ما يُضبط ملف joerc بحيث يكون وضع الإزاحة الآلية مفعلاً للملفات التي تنتهي أسماؤها بـ .p أو .c أو .h. عند تفعيل وضع الإزاحة الآلية والضغط على Enter، سيوضع المؤشر في نفس العمود الذي كان عليه أول محرف غير فارغ في السطر الأصلي.

يمكنك استخدام الأمرين ^K , و ^K . لإزاحة كتلة نصية إلى اليسار أو اليمين. إذا لم يكن هناك تظليل محدد عند إعطاء هذه الأوامر، فستُختار كتلة البرنامج (كما تشير الإزاحة) التي يقع فيها المؤشر، وستُنقل بواسطة أوامر ^K , و ^K . اللاحقة.

يمكن ضبط عدد الأعمدة التي تزاح بها هذه الأوامر والمحرف المستخدم للإزاحة من خلال خياري istep و indentc. هذه الخيارات متاحة في قائمة ^T. أيضًا، يمكن استخدام ^T = للاختيار السريع من بين عدد من القيم الشائعة لخطوة الإزاحة ومحرفها.

يحتوي JOE على عدد من الخيارات الإضافية المتعلقة بإزاحة البرامج:

• smartbacks
  تفعيل مسافة الرجوع وعلامة التبويب الذكية. عند ضبط هذا الوضع، يقوم Backspace و Tab بالإزاحة للداخل أو للخارج بناءً على قيم خياري istep و indentc.

• smarthome
  مفتاحا Home و ^A يحركان المؤشر أولاً إلى بداية السطر، ثم إذا ضُغط عليهما مرة أخرى، إلى أول محرف غير فارغ.

• indentfirst
  مفتاح البداية الذكي يذهب إلى أول محرف غير فارغ أولاً، بدلاً من الذهاب إلى بداية السطر أولاً.

• purify
  أصلح الإزاحة إذا لزم الأمر قبل الإزاحة أو المسافة الخلفية الذكية. على سبيل المثال، إذا كانت الإزاحة تستخدم مزيجاً من علامات الجدولة والمسافات، وكان indentc هو المسافة، فستُحول الإزاحة إلى مسافات بالكامل قبل عملية الإزاحة.

• guess_indent
  عند ضبطه، يحاول JOE تخمين محرف الإزاحة وخطوة الإزاحة بناءً على محتويات الملف. الخوارزمية هي العثور على القاسم المشترك الأكبر للإزاحات الثلاث الأكثر شيوعاً الموجودة في الملف.

وضع المستطيل¶

اكتب ^T X لجعل ^K B و ^K K يختاران كتل مستطيلة بدلاً من كتل تدفق النص. يُعرف هذا أيضًا بالوضع العمودي. هذا الوضع مفيد لنقل أعمدة النص أو نسخها أو حذفها أو حفظها. يمكنك أيضًا تصفية أعمدة النص باستخدام أمر ^K / - إذا كنت تريد فرز عمود، على سبيل المثال. يتأثر أمر إدراج الملف، ^K R، أيضًا.

عند اختيار وضع المستطيل، يكون وضع الكتابة الفوقية مفيدًا أيضًا (^T T). عند اختيار وضع الكتابة الفوقية، ستحل المستطيلات محل النص الموجود بدلاً من إدراجها قبله. كما أن أمر حذف الكتلة (^K Y) سيقوم بمسح المستطيل المختار باستخدام المسافات وعلامات التبويب بدلاً من حذفه. وضع الكتابة الفوقية مفيد بشكل خاص لأمر تصفية الكتلة (^K /)، لأنه سيحافظ على العرض الأصلي للعمود المختار.

وضع الصورة¶

استخدم ^T P للدخول إلى وضع الصورة أو الخروج منه. يساعد وضع الصورة في رسومات ASCII.

يتحكم وضع الصورة في كيفية تعامل JOE مع الحالة التي يكون فيها المؤشر متجاوزًا نهايات الأسطر. يحدث هذا عند استخدام مفاتيح السهم للأعلى أو للأسفل لتحريك المؤشر من نهاية سطر طويل إلى سطر قصير.

إذا حاولت كتابة محرف في هذه الحالة:

إذا كان وضع الصورة مغلقًا، فسيقفز المؤشر إلى نهاية السطر ويدرجه هناك.

إذا كان وضع الصورة مفعلًا، فسيملأ السطر بالمسافات بحيث يمكن إدراج المحرف في موضع المؤشر.

Windows¶

يمكنك تحرير أكثر من ملف واحد في نفس الوقت أو تحرير مكانين مختلفين أو أكثر لنفس الملف. للقيام بذلك، اضغط ^K O لتقسيم الشاشة إلى نافذتين. استخدم ^K P أو ^K N لتحريك المؤشر إلى النافذة العلوية أو النافذة السفلية. استخدم ^K E لتحرير ملف جديد في إحدى النوافذ. ستختفي النافذة عند حفظ الملف باستخدام ^K X أو إنهاء الملف باستخدام ^C. إذا أنهيت ملفًا موجودًا في نافذتين، فستختفي إحدى النوافذ، وليس الملف.

يمكنك الضغط على ^K O داخل نافذة لإنشاء المزيد من النوافذ. إذا كان لديك عدد كبير جدًا من النوافذ على الشاشة، ولكنك لا تريد إزالتها، يمكنك الضغط على ^K I. سيؤدي هذا إلى إظهار النافذة التي يوجد بها المؤشر فقط، أو إذا لم يكن هناك سوى نافذة واحدة على الشاشة في البداية، فسيحاول احتواء جميع النوافذ المخفية على الشاشة. إذا كان هناك عدد من النوافذ أكثر مما يمكن أن يتسع له على الشاشة، يمكنك الضغط على ^K N في النافذة السفلية أو ^K P في النافذة العلوية للوصول إليها.

إذا أعطيت أكثر من اسم ملف لـ JOE في سطر الأوامر، فسيُوضع كل ملف في نافذة مختلفة.

يمكنك تغيير ارتفاع النوافذ باستخدام أَمري ^K G و ^K T.

مخازن مؤقتة مسودة¶

مخازن المسودة المؤقتة هي مخازن لا يهتم JOE بمحاولة الحفاظ عليها. لن يطلب JOE حفظ مخازن المسودة المعدلة. نوافذ الصدفة المنبثقة، وسجل بدء التشغيل، ونوافذ رسائل التجميع و grep هي مخازن مسودة مؤقتة. يمكنك إنشاء مخزن مسودة خاص بك باستخدام أمر scratch.

تقوم الأوامر التالية بتحميل مخازن مسودة مؤقتة:

• showlog عرض سجل بدء التشغيل
• mwind عرض نافذة الرسائل (رسائل التجميع / grep من أَمري Esc C و Esc G).

ماكروهات لوحة المفاتيح¶

تسمح لك الماكروهات بتسجيل سلسلة من ضغطات المفاتيح وإعادة تشغيلها بضغط مفتاحين. هذا مفيد لأتمتة المهام المتكررة. لبدء تسجيل ماكرو، اضغط ^K [ متبوعًا برقم من 0 إلى 9. سيعرض سطر الحالة (جاري تسجيل الماكرو n...). الآن، اكتب سلسلة ضغطات المفاتيح التي تريد تكرارها. الأوامر التي تكتبها سيكون لها تأثيراتها المعتادة. اضغط ^K ] لإيقاف تسجيل الماكرو. اضغط ^K متبوعًا بالرقم الذي سجلت فيه الماكرو لتنفيذ تكرار واحد لضغطات المفاتيح.

على سبيل المثال، إذا كنت تريد وضع "**" أمام عدد من الأسطر، يمكنك كتابة:

^K [ 0 ^A **سهم للأسفل\ ^K ]

والذي يبدأ تسجيل الماكرو، ويحرك المؤشر إلى بداية السطر، ويدرج "**"، ويحرك المؤشر لأسفل بمقدار سطر واحد، ثم ينهي التسجيل. وبما أننا قمنا بتضمين ضغطات المفاتيح اللازمة لوضع المؤشر على السطر التالي، فيمكننا استخدام هذا الماكرو بشكل متكرر دون الحاجة إلى تحريك المؤشر بأنفسنا، وهو أمر يجب عليك وضعه في الاعتبار دائمًا عند تسجيل الماكرو.

الماكروهات والأوامر¶

الماكرو هو قائمة من الأوامر مفصولة بفاصلة. عند تنفيذ الماكرو، يتم تنفيذ كل أمر حتى يتم الوصول إما إلى نهاية القائمة، أو يفشل أحد الأوامر (قيمة إرجاع غير صفرية من الأمر). تُصدر الأوامر الفاشلة صافرة إذا كنت قد فعلت الصافرات (^T B).

اضغط Esc D لإدراج المجموعة الحالية من ماكروهات لوحة المفاتيح كنص في المخزن المؤقت الحالي. على سبيل المثال، يبدو ماكرو إدراج "**" المذكور أعلاه كما يلي:

home,"**",dnarw ^K 0    الماكرو 0

يمكنك إدراج هذا في ملف .joerc الخاص بك وتغيير تسلسل المفاتيح (K 0) إلى شيء أكثر ديمومة.

بحث الأوسام¶

إذا كنت تحرر برنامج C ضخماً يضم العديد من ملفات المصدر، فيمكنك استخدام برنامج ctags لتوليد ملف tags. يحتوي هذا الملف على قائمة برموز البرنامج والملفات والمواضع التي عُرّفت فيها تلك الرموز.

أولاً، أنشئ ملف الأوسام باستخدام برنامج "ctags". على سبيل المثال:

ctags *.c *.h

سيؤدي هذا إلى إنشاء ملف يسمى "tags" في الدليل الحالي.

يبحث JOE عن ملف "tags" في الدليل الحالي. وفي حال عدم وجوده، سيحاول فتح الملف المحدد بواسطة متغير البيئة TAGS.

المسارات في ملف الأوسام تكون دائماً نسبية لموقع ملف الأوسام ذاته.

يحتوي ملف الأوسام على قائمة بمواقع تعريف المعرفات بأحد هذه التنسيقات:

identifier filename /search-expression/[;comments]
identifier filename ?search-expression?[;comments]
identifier filename line-number[;comments]

تتضمن بعض إصدارات ctags أسماء الفئات في المعرفات:

class::member

في هذه الحالة، سيطابق JOE أيًا من هذه السلاسل النصية:

member
::member
class::member

تتضمن بعض إصدارات ctags اسم ملف في المعرف:

filename:identifier

في هذه الحالة سيجد JOE المعرف فقط إذا تطابق اسم المنظم مع اسم الملف.

تعبير البحث هو تعبير نمطي لـ vi، لكن JOE يدعم فقط المحارف الخاصة التالية:

^ في البداية تعني أن التعبير يبدأ في بداية السطر
$ في النهاية تعني أن التعبير ينتهي في نهاية السطر
\x اقتباس x (إلغاء معنى / أو ؟ أو ^ أو $)

اكتب ^K ; لإظهار محث البحث عن الأوسام. إذا كان المؤشر فوق معرف، فسيُحمّل المحث به مسبقاً. يعمل الإكمال بمفتاح Tab في هذا المحث (يستخدم ملف الأوسام للعثور على الإكمالات).

عندما تضغط Enter، يبدأ البحث عن الأوسام:

إذا وجد تطابق واحد فقط، فسينتقل JOE مباشرة إلى التعريف.

إذا كانت هناك تطابقات متعددة، فسيُتحكم في السلوك عبر خيار notagsmenu. إذا كان notagsmenu مفعلاً، ينتقل JOE إلى التعريف الأول. إذا ضغطت ^K ; مرة أخرى قبل ضغط أي مفاتيح أخرى، ينتقل JOE إلى التعريف التالي، وهكذا. يؤدي الأمر "tagjump" هذه الوظيفة أيضاً.

إذا كان notagsmenu معطلاً، يعرض JOE قائمة بجميع التطابقات. تختار ما تريد وينتقل JOE إليه. إذا ضغطت ^K ; مرة أخرى قبل ضغط أي مفاتيح أخرى، تظهر القائمة نفسها مجدداً مع بقاء المؤشر في الموقع الأصلي.

يمكنك ضغط ^K - لنقل المؤشر إلى الموقع الأصلي قبل البحث عن الأوسام (وغالباً ما سيعمل ^C أيضاً).

بما أن ^K ; يحمل ملف التعريف في النافذة الحالية، فمن المحتمل أنك سترغب في تقسيم النافذة أولاً باستخدام ^K O، ليُحمّل كلا الملفين الأصلي وملف التعريف.

الحاسبة¶

يحتوي JOE على حاسبة مدمجة يمكن استدعاؤها باستخدام Esc M.

نوافذ الصدفة¶

اضغط ^K ´ لتشغيل صدفة أوامر في إحدى نوافذ JOE. عندما يكون المؤشر في نهاية نافذة الصدفة (استخدم ^K V إذا لم يكن كذلك)، فإن كل ما تكتبه يُمرر إلى الصدفة بدلاً من المنظم. أي مخرجات من الصدفة أو من الأوامر المنفذة فيها تُلحق بنافذة الصدفة (سيتبع المؤشر هذه المخرجات إذا كان في نهاية نافذة الصدفة). هذا الأمر مفيد لتسجيل نتائج أوامر الصدفة- على سبيل المثال مخرجات make، أو نتيجة استخدام grep للبحث عن سلسلة نصية في مجموعة ملفات، أو قوائم الأدلة من جلسات FTP. بالإضافة إلى المحارف القابلة للكتابة، تُمرر المفاتيح ^C و Backspace و Del و Return و ^D إلى الصدفة. اكتب أمر الصدفة exit لإيقاف تسجيل مخرجات الصدفة. إذا ضغطت ^C في نافذة صدفة، بينما لا يكون المؤشر في نهاية النافذة، تُقتل (kill) الصدفة.

إذا كنت تستخدم Bash، يمكنك ضغط: ^Q Up Arrow و ^Q Down Arrow للتمرير خلال منظم تاريخ Bash. تعمل مفاتيح أخرى أيضاً: جرب ^Q ^A للذهاب إلى بداية السطر أو ^Q ^E للذهاب إلى نهاية السطر. لسوء الحظ يحاكي JOE فقط طرفية غبية، لذا عليك استخدام الكثير من الخيال للقيام بأي تحرير يتجاوز ضغط مفتاح backspace.

بشكل عام، أي محرف مقتبس بـ ^Q يُرسل إلى الصدفة.

يُرسل أيضاً إلى الصدفة: Tab و Backspace و Enter و ^C و ^D.

نوافذ الصدفة المنبثقة¶

اضغط F1 - F4 لفتح والتبديل بين نوافذ الصدفة.

تستخدم نوافذ الصدفة المنبثقة محاكياً كاملاً للطرفية بحيث عندما تكتب "man ls" تُنسق بشكل صحيح (تعمل بشكل جيد بما يكفي لاستخدام بعض البرامج التفاعلية). ومع ذلك، لا تزال نافذة الصدفة منظم تحرير.

لا تزال نافذة الصدفة القديمة (بدون محاكاة طرفية) موجودة: استخدم ^K ´ لاستدعائها كالمعتاد. هذا مفيد لرؤية تسلسلات التحكم الصادرة عن برنامج ما.

تُمرر المزيد من المفاتيح إلى البرنامج المشغل في نوافذ الصدفة المنبثقة مقارنة بالقديمة. هناك قسم :vtshell في ملف joerc للتحكم في أيها يُمرر. وبشكل خاص، تُمرر مفاتيح الأسهم و Ctrl-C إلى البرنامج. هذا يعني أنه يمكنك التنقل بسهولة في تاريخ bash باستخدام مفاتيح الأسهم، أو إجهاض البرامج بالطريقة العادية باستخدام Ctrl-C.

من ناحية أخرى، فإن فقدان Ctrl-C يعني أن طريقة إغلاق النافذة تصبح أقل وضوحاً. أحدى الطرق هي نقل المؤشر بعيداً عن نقطة إدخال بيانات الصدفة (باستخدام Ctrl-P)، ثم ضغط Ctrl-C. طريقة أخرى هي ضغط ^K Q. وأخيراً، يمكنك كتابة ´pop´ عند محث الأوامر.

إذا كنت بحاجة إلى تمرير مفتاح إلى الصدفة يستخدمه JOE عادةً، فاقتبسه. على سبيل المثال، إذا استدعيت "emacs -nw" في نافذة الصدفة، يمكنك الخروج منه عبر:

^Q ^X ^C

لوضع المؤشر بسرعة مرة أخرى عند النقطة التي تُدخل فيها البيانات في الصدفة، اضغط ^K V.

عندما تفتح نافذة صدفة، يُستدعى سكربت بدء تشغيل خاص بـ JOE. يقع في /etc/joe/shell.sh (وأيضاً /etc/joe/shell.csh). يحتوي على بعض الأسماء المستعارة التي تتيح لك التحكم في JOE بأوامر صدفة وهمية. لدي هذه الأوامر حتى الآن:

• clear
  امسح نافذة الصدفة (احذف محتويات المخزن المؤقت)

• joe ملف
  حرر ملفًا في JOE

• math 1+2
  احسب المعادلة باستخدام حاسبة JOE

• cd xyz
  غيّر المجلد، مع إبقاء JOE محدثًا

• markb
  مماثل لـ ^KB

• markk
  مماثل لـ ^KK

• أمر mark
  نفّذ أمر صدفة، وضع علامة على مخرجاته

• أمر parse
  نفّذ أمر صدفة، وحلّل مخرجاته بحثًا عن أسماء الملفات وأرقام الأسطر (لأجل find أو grep)

• parser comman
  نفّذ أمر صدفة، وحلّل مخرجاته بحثًا عن الأخطاء (لأجل gcc)

• release
  حرّر الأخطاء المحللة

• pop
  أغلق نافذة الصدفة (مماثل لـ ^K Q)

تعمل هذه الميزات عن طريق إرسال تسلسل هروب يتعرف عليه محاكي الطرفية: Esc { joe_macro }. عند استلامه، يُنفّذ الماكرو. لأغراض أمنية، لا يمكن تنفيذ سوى الماكروهات المعرفة في ملف joerc والتي تبدأ بـ "shell_" بهذه الطريقة.

محللات المجمّع و grep/find¶

يملك JOE محللين يمكن استخدامهما لتوليد قائمة الأخطاء (قائمة أسماء الملفات / أرقام الأسطر).

أمر "parserr" يحلل المخزن المؤقت بالكامل، أو إذا كانت الكتلة محددة، يحلل فقط الكتلة البارزة بحثًا عن رسائل خطأ المجمّع. يجب أن تكون الرسائل بهذا التنسيق:

<بيانات> اسم.الملف <بيانات> رقم-السطر <بيانات> : <بيانات>

يجب أن يتكون اسم الملف من أرقام، وحروف، و ´/´، و ´.´ و ´-´. كما يجب أن يحتوي على نقطة ´.´ واحدة على الأقل. ويلزم وجود نقطتين رأسيتين في مكان ما بعد رقم السطر. يتم تجاهل الأسطر التي لا تتبع هذا التنسيق.

أمر "gparse" يحلل المخزن المؤقت بالكامل، أو إذا كانت الكتلة محددة، يحلل فقط الكتلة البارزة بحثًا عن قائمة بأسماء الملفات أو أسماء ملفات مع أرقام الأسطر من برامج "grep -n" و "find" وما شابهها.

اسم الملف
اسم الملف:<بيانات>
اسم الملف:رقم-السطر:<بيانات>

بمجرد حصول JOE على قائمة الأخطاء، تتوفر عدة أشياء يمكنك القيام بها بها:

• قم بزيارة الملفات/المواقع في القائمة باستخدام Esc - و Esc =
• ابحث واستبدل عبر كافة الملفات في القائمة باستخدام خيار البحث والاستبدال ´e´.
• امسح القائمة باستخدام أمر "release".

أيضًا، يمكنك استخدام Esc Space (أمر ´jump´) لتحليل السطر الذي يقف عليه المؤشر والقفز إلى اسم الملف ورقم السطر المحللين. يستخدم ´jump´ محلل grep/find ما لم يكن قد صدر أمر ´parserr´ سابقًا في المخزن المؤقت.

تلوين الصيغة¶

لتفعيل التلوين استخدم ^T H.

لاختيار الصياغة، استخدم ^T Y. يمكنك ضغط Tab Tab عند المحث للحصول على قائمة إكمال.

يحاول JOE تحديد الصياغة الواجب استخدامها بناءً على اسم الملف ومحتوياته. يحتوي ملف الضبط /etc/joe/ftyperc على التعريفات.

تُعرف كل صياغة بواسطة ملف موجود في /usr/share/joe/syntax/.

كيفية عمل تلوين صياغة JOE¶

من c.jsf http://joe-editor.hg.sourceforge.net/hgweb/joe-editor/joe-editor/file/tip/syntax/c.jsf.in، معدلة قليلاً

تُوفّر آلة حالة حتمية تقوم بالتحليل المعجمي للغة الهدف في ملف صياغة. (هذه هي "لغة التجميع" الخاصة بتلوين الصياغة. ومن حيث المبدأ يمكن استخدام برنامج منفصل لتحويل صياغة NFA ذات التعبيرات النمطية إلى هذا التنسيق).

تبدأ كل حالة بـ:

:<الاسم> <اسم-اللون> <السياق>

الاسم\ هو اسم الحالة.

اسم-اللون\ هو اللون المستخدم للمحارف التي تستهلكها الحالة (هو في الحقيقة رمز للون يمكن للمستخدم تعريفه).

يخبر السياق\ المحرر JOE إذا كان المحرف الحالي جزءًا من تعليق أو سلسلة نصية. يتيح هذا لـ JOE تخطي التعليقات والسلاسل النصية عند مطابقة المحارف مثل الأقواس. لاستخدام هذه الميزة، يجب تطبيق خيار highlighter_context على الملفات الملونة بواسطة الصياغة المقابلة. لتطبيق الخيار، أضفه إلى ftyperc لمداخل تلك الملفات.

السياقات الصالحة هي:

• comment هذا المحرف جزء من تعليق. مثال: /* تعليق */
• string هذا المحرف جزء من سلسلة نصية. أمثلة: "سلسلة نصية" ´c´ ´سلسلة نصية´

يجب وسم محددات التعليقات والسلاسل النصية نفسها بالسياق المناسب. يُعتبر السياق جزءًا من اللون، لذا فإن خياري recolor=-N و recolormark يطبقان السياق على المحارف السابقة.

تكون أول حالة تُعرّف هي الحالة المبدئية.

داخل الحالة، تُعرّف الانتقالات (القفزات) إلى حالات أخرى. لكل قفزة التنسيق التالي:

    <قائمة-المحارف> <اسم-الحالة-الهدف> [<خيارات>]

توجد ثلاث طرق لتحديد قائمة-المحارف\، إما * لأي محرف لم يُحدد خلاف ذلك، أو % أو & لمطابقة المحرف في مخزن مطابقة المحددات المؤقت (% يطابق المحرف المحفوظ تمامًا، بينما & يطابق المحرف المقابل، على سبيل المثال سيطابق ( الرمز ) عند استخدام &) أو قائمة حرفية من المحارف داخل علامات اقتباس (النطاقات وتسلسلات الهروب مسموح بها: انظر تسلسلات الهروب). عندما يطابق المحرف التالي أيًا منها في القائمة، يتم الانتقال إلى الحالة الهدف ويُستهلك المحرف (نتقدم إلى المحرف التالي من الملف المطلوب تلوينه).

يجب أن يكون الانتقال * هو أول انتقال مُحدد في الحالة.

توجد عدة خيارات:

• noeat - لا تستهلك المحرف، بل مرره إلى الحالة التالية (يميل هذا إلى جعل الحالات أصغر، لكن كن حذرًا: قد تقع في حلقات مفرغة). ´noeat´ يستلزم ´recolor=-1´.
• recolor=-N - أعِد تلوين المحارف الـ N الماضية بلون الحالة الهدف. على سبيل المثال، بمجرد التعرف على /* كبداية لتعليق في لغة C، سترغب في تلوين /* بلون تعليق C باستخدام recolor=-2.
• mark - حدد بداية المنطقة بالموضع الحالي.
• markend - حدد نهاية المنطقة.
• recolormark - أعِد تلوين كافة المحارف في المنطقة المحددة بلون الحالة الهدف. إذا لم يُعطَ markend، تُعاد تلوين كافة المحارف حتى الموضع الحالي. لاحظ أن المنطقة المحددة لا يمكن أن تتجاوز حدود الأسطر ويجب أن تكون في نفس السطر الذي يوجد فيه recolormark.
• buffer - ابدأ نسخ المحارف إلى مخزن سلسلة نصية مؤقت، بدءًا من هذا المحرف (لا بأس بعدم إنهاء التخزين بخيار ´strings´ أو ´istrings´ أو ´hold´ مقابل - المخزن محدود بأول 23 محرفًا).
• save_c - احفظ المحرف في مخزن مطابقة المحددات المؤقت.
• save_s - انسخ مخزن السلسلة النصية المؤقت إلى مخزن مطابقة المحددات المؤقت.
• strings - تتبعها قائمة من السلاسل النصية. إذا طابق المخزن المؤقت أيًا من السلاسل المعطاة، يتم الانتقال إلى الحالة الهدف في قائمة السلاسل بدلاً من الانتقال العادي.
• istrings - مماثل لـ strings، لكن مع تجاهل حالة الأحرف. لاحظ: يجب أن يكون strings و istrings آخر خيار في السطر. فهما يتسببان في تجاهل أي خيارات تتبعهما.
• hold - توقف عن تخزين السلسلة - سيبحث خيار ´strings´ أو ´istrings´ مستقبلاً في محتويات المخزن عند هذه النقطة. مفيد للتمييز بين الأوامر واستدعاءات الدوال في بعض اللغات: ´write 7´ هو أمر، بينما ´write (´ هو استدعاء دالة - يتيح لنا hold التوقف عند المسافة وتأخير البحث عن السلسلة حتى وصول ( أو 7.

تنسيق قائمة السلاسل النصية هو:

    "سلسلة"   <الحالة-الهدف> [<خيارات>]


    "سلسلة"   <الحالة-الهدف> [<خيارات>]


    "&"        <الحالة-الهدف> [<خيارات>]   # يطابق محتويات مخزن مطابقة المحددات


    done

(كافة الخيارات أعلاه مسموح بها باستثناء "strings" و "istrings" و "noeat". يتم افتراض noeat دائمًا بعد مطابقة السلسلة).

غرابة: الحالات وحدها تملك ألوانًا، وليس الانتقالات. يعني هذا أن عليك أحيانًا إنشاء حالات وهمية بـ

    *    <next-state>    noeat

فقط من أجل الحصول على توصيف للون.

مخزن مطابقة المحددات مخصص للغة perl والصدفة: يمكن للتعبير النمطي في perl أن يكون s<..>(...) وفي الصدة يمكنك قول: <<EOS ....... EOS. الفكرة هي أن تلتقط المحدد الأول في مخزن المطابقة (الرمز < أو أول "EOS") ثم تطابقه مع الثاني باستخدام "&" في قائمة سلاسل أو محارف.

ملف joerc¶

خيارات ^T، وشاشات المساعدة، وربط تسلسلات المفاتيح بأوامر المحرر كلها مُعرّفة في ملف تهيئة JOE. إذا قمت بعمل نسخة من هذا الملف (الذي يتواجد عادة في /etc/joe/joerc) إلى $HOME/.joerc، يمكنك تخصيص هذه الإعدادات حسب رغبتك. صياغة ملف التهيئة واضحة تمامًا وتوجد تعليمات إضافية بداخله.

يحتوي ملف joerc على توجيه لتضمين ملف آخر (:include). تُستخدم هذه الخاصية لتضمين ملف يسمى ftyperc (يتواجد عادة في /etc/joe/ftyperc). يحتوي ftyperc على جدول أنواع الملفات الذي يحدد أي الخيارات المحلية (بما في ذلك صياغة الملون) تُطبق على كل نوع ملف.

دعم الفأرة في Xterm¶

يوجد مستويان لدعم الفأرة. يفعل الخيار -mouse المستوى الأول، والذي سيعمل مع أي Xterm قياسي. وإذا ضُبط -joexterm أيضًا، فسيُحسّن دعم الفأرة، ولكنك ستحتاج إلى إصدار حديث من XTerm، ويجب أن يُضبط (./configure) مع خيار --enable-paste64.

عند ضبط -mouse، يمكنك:

• النقر بزر الفأرة الأيسر في نافذة نصية لضبط موضع المؤشر. والنقر بزر الفأرة الأيسر في نافذة مختلفة لنقل المؤشر إلى نافذة أخرى.
• تحديد النص بالفأرة. انقر بالزر الأيسر واسحب لتحديد بعض النص؛ وسيكون الأمر كما لو أنك استخدمت ^K B و ^K K لوسمه. انقر بالزر الأيسر (دون سحب) لوضع المؤشر في مكان آخر. انقر بالزر الأوسط لنسخ النص المحدد إلى موضع المؤشر؛ وسيكون كما لو أنك ضغطت ^K C. إذا سحبت خارج حافة نافذة النص، فستُمرر النافذة آليًا لتحديد المزيد من النص. لسوء الحظ، لا يرسل Xterm أي رموز عندما يكون المؤشر خارج إطار Xterm نفسه، لذا فإن هذا يعمل فقط إذا كانت الفأرة لا تزال داخل إطار Xterm. أُرسلت رقعة (patch) إلى مصين Xterm لتحسين هذا، ولكنه لم يقبلها بعد.
• تغيير حجم النوافذ بالفأرة: انقر مع الاستمرار على سطر الحالة الذي يفصل بين نافذتين لتحريكه.
• تحديد مدخلات القائمة (مثل أي قائمة إكمال أو قائمة خيارات ^T): انقر على عنصر القائمة لوضع المؤشر عليه. انقر نقرًا مزدوجًا على عنصر القائمة لتحديده (مثل الضغط على مفتاح return والمؤشر عليه).
• إذا كانت فارتك تحتوي على عجلة، فإن تدوير العجلة سيؤدي إلى تمرير النافذة مع المؤشر.

لسوء الحظ، عند اختيار -mouse، فإن القص واللصق بين نوافذ X لا يعمل كما هو معتاد في نافذة الصدفة (النقر الأيسر والسحب للتحديد، والنقر الأوسط للصق). بدلًا من ذلك، عليك الضغط المستمر على مفتاح shift للقيام بذلك: shift مع النقر الأيسر والسحب للتحديد، و shift مع النقر الأوسط للصق. لاحظ أن لصق النص في JOE بهذه الطريقة يواجه مشكلات: أي محارف ` ستفسد لأن ` تعني اقتباس محرف التحكم التالي. كما أنه إذا فُعّل الإزاحة الآلية، فلن يُزاح النص الملصق بشكل صحيح.

ملاحظة: حُلّت مشكلات اللصق هذه في الإصدارات الحديثة من JOE.

• يفعل JOE وضع "اللصق المحصور" في Xterm بحيث يُحصر النص الملصق بتسلسل هروب. يؤدي هذا التسلسل إلى تعطيل أوضاع الإزاحة الآلية، ولف الكلمات، والمسافات في JOE أثناء اللصق، ويستعيدها عند اكتماله.
• حتى لو لم يكن محاكي الطرفية يدعم وضع اللصق المحصور هذا، فإن JOE يكتشف النص الملصق عبر التوقيت: إذا وصل النص دفعة واحدة (كلّه في نفس المخزن المؤقت)، يُفترض أن النص ملصق وتُعطل الإزاحة الآلية ولف الكلمات مؤقتًا.

عند ضبط -joexterm (وبعد ضبط ./configure لـ Xterm مع خيار --enable-paste64):

•

دُمج القص واللصق بشكل صحيح مع X. النص المحدد عبر النقر الأيسر والسحب يصبح متاحًا للصقه في نوافذ X الأخرى (حتى لو كان النص المحدد أكبر من نافذة النص). النص المحدد في نوافذ X الأخرى يمكن لصقه في JOE عبر النقر الأوسط. لا توجد مشكلات في لصق النصوص التي تحتوي على ` أو مع الإزاحة الآلية.

يتيح --enable-paste64 لبرنامج التطبيق تبادل بيانات التحديد المرمزة بـ Base-64 من وإلى Xterm. يمتلك البرنامج تحكمًا كاملًا في محتوى بيانات التحديد ووقت استلامها أو إرسالها.

دعم ألوان Xterm¶

يمكن لـ JOE الاستفادة من Xterm أحادي اللون، وXterm ذو 8 ألوان، و16 لونًا، و88 لونًا، و256 لونًا. يُحدد عدد الألوان التي يدعمها Xterm بناءً على خيارات سكربت "configure" التي ضُبطت قبل تجميع كود المصدر لـ Xterm. يجب أن يدخل مدخل termcap أو terminfo في دعم كيفية ضبط Xterm الخاص بك. في توزيعة Slackware Linux الخاصة بي، يجب عليك ضبط متغير البيئة TERM على أحد هذه القيم:

• xterm
• xterm-color
• xterm-16color
• xterm-88color
• xterm-256color

إذا كان مدخل termcap/terminfo مفقودًا، يمكنك إضافة خيار "-assume_256color" إلى ملف joerc. لاحظ أن هذا كان معطلًا لـ terminfo في إصدارات JOE الأقدم من 3.4.

عندما يعمل، فإن الأمر: "joe -assume_256color -text_color bg_222" يجب أن يظهر بخلفية رمادية.

وضع التحرير الست عشري¶

عند اختيار هذا الوضع (إما بوضع -hex في سطر الأوامر، أو بالبحث عن "Hex edit mode" بعد الضغط على ^T)، يُعرض المخزن المؤقت كتفريغ ست عشري، ولكن جميع أوامر التحرير تعمل بنفس الطريقة. من المفيد جدًا اختيار وضع الكتابة الفوقية مع التفريغ الست عشري (اضغط ^T T)؛ وعندها لن تؤدي الكتابة إلى الإدراج.

• لإدخال بايت ست عشري 0xF8 اكتب ^Q x F 8
• يمكنك استخدام ^K C لنسخ كتلة كالمعتاد. إذا اختير وضع الكتابة الفوقية، فستكتب الكتلة فوق البيانات في الوجهة دون تغيير حجم الملف. وخلاف ذلك، فإنها تدرج.
• اضغط Esc X byte <Enter> للانتقال إلى إزاحة بايت معينة. يمكن إدخال القيم الست عشرية في هذا المحث مثل: 0x2000.
• تعمل عمليات البحث، والبحث التزايدي، والبحث والاستبدال كالمعتاد.

متغيرات البيئة¶

لكي يعمل JOE بشكل صحيح، يجب أن تكون عدة إعدادات بيئة أخرى صحيحة. يجب ضبط معدل النقل (Baud rate) للاتصال بين الحاسوب وطرفيتك بشكل صحيح لكي يقوم JOE بتحديث الشاشة بسلاسة ويسمح للكتابة المسبقة بتأجيل تحديث الشاشة. استخدم الأمر stty nnn لضبط ذلك. ينبغي ضبطه على قيمة قريبة قدر الإمكان من معدل النقل الفعلي للاتصال. على سبيل المثال، إذا كنت متصلًا عبر مودم بسرعة 1200 باود، استخدم هذه القيمة لـ stty. وإذا كنت متصلًا عبر مودم 14.4k، ولكن خادم الطرفية الذي تتصل به يتصل بالحاسوب بسرعة 9600 باود، فعليك ضبط السرعة على 9600 باود. يُستخدم معدل الباود الخاص 38400 أو extb للإشارة إلى أن لديك اتصالًا عالي السرعة جدًا، مثل وحدة تحكم مخططة في الذاكرة أو محاكي طرفية في نظام X-window. إذا لم تتمكن من استخدام stty لضبط معدل النقل الفعلي (ربما بسبب مودم يتواصل مع الحاسوب بمعدل مختلف عن تواصله عبر خط الهاتف)، يمكنك وضع قيمة عددية في متغير البيئة BAUD بدلًا من ذلك (استخدم setenv BAUD 9600 لـ csh أو BAUD=9600; export BAUD لـ sh).

يجب ضبط متغير البيئة TERM على نوع الطرفية التي تستخدمها. إذا كان حجم طرفيتك (عدد الأسطر/الأعمدة) مختلفًا عما هو مذكور في مدخل TERMCAP أو TERMINFO، يمكنك ضبط ذلك باستخدام الأمر stty rows nn cols nn، أو عبر ضبط متغيري البيئة LINES و COLUMNS. حجم الطرفية متغير في الأنظمة الحديثة ويُحدد عبر ioctl، لذا غالبًا ما لا يكون لهذه المعاملات أي تأثير.

يتوقع JOE عادةً أن يستخدم التحكم في التدفق بين الحاسوب وطرفيتك مصافحة ^S/^Q (أي إذا كان الحاسوب يرسل المحارف بسرعة كبيرة بالنسبة لطرفيتك، فإن طرفيتك ترسل ^S لإيقاف الإخراج و ^Q لاستئنافه). إذا كان التحكم في التدفق يستخدم مصافحة خارج النطاق أو مصافحة عتادية، أو إذا كانت طرفيتك سريعة بما يكفي لمواكبة مخرجات الحاسوب دائمًا وترغب في ربط ^S/^Q بأوامر التحرير، يمكنك ضبط متغير البيئة NOXON ليحاول JOE إيقاف مصافحة ^S/^Q. إذا كان الاتصال بين الحاسوب وطرفيتك لا يستخدم أي مصافحة ولم تكن طرفيتك سريعة بما يكفي لمواكبة مخرجات الحاسوب، يمكنك ضبط متغير البيئة DOPADDING ليقوم JOE بإبطاء الإخراج عبر حشو محارف PAD بين تسلسلات تحديث شاشة الطرفية.

إليك قائمة كاملة بمتغيرات البيئة:

• BAUD
  يخبر JOE بمعدل باود الطرفية (يتجاوز القيمة التي يبلغ عنها stty).

• COLUMNS
  اضبط عدد الأعمدة في محاكي الطرفية (في حال كان مدخل termcap خاطئاً). هذا مفيد فقط في الأنظمة القديمة التي لا تحتوي على ioctl "get window size".

• DOPADDING
  يفعل إرسال محارف NUL للحشو إلى الطرفية عند ضبطه (للطرفيات القديمة جدًا).

• HOME
  يُستخدم للحصول على مسار دليل المنزل لتوسيع ~ وأيضًا للعثور على ملف ~/.joerc ودليل ~/.joe.

• HOSTNAME
  يُستخدم للحصول على اسم المضيف لوضعه في أقفال متوافقة مع EMACS.

• JOETERM
  يعطي نوع الطرفية: سيستخدم JOE هذا المتغير بدلًا من TERM إذا كان مضبوطًا.

• LANG
  يضبط الإعدادات المحلية (مثل en_US.utf-8). يستخدم JOE أول متغير مضبوط من هذه القائمة: LC_ALL، ثم LC_CTYPE، ثم LANG.

• LC_ALL
  يضبط الإعدادات المحلية (مثل en_US.utf-8). يستخدم JOE أول متغير مضبوط من هذه القائمة: LC_ALL، ثم LC_CTYPE، ثم LANG.

• LC_CTYPE
  يضبط الإعدادات المحلية (مثل en_US.utf-8). يستخدم JOE أول متغير مضبوط من هذه القائمة: LC_ALL، ثم LC_CTYPE، ثم LANG.

• LINES
  اضبط عدد السطور في محاكي الطرفية (في حال كان مدخل termcap خاطئاً). هذا مفيد فقط في الأنظمة القديمة التي لا تحتوي على ioctl "get window size".

• NOXON
  عطل التحكم في التدفق ^S و ^Q، مما قد يسمح باستخدام ^S و ^Q كمفاتيح للمحرر.

• SHELL
  مسار الصدفة (مثل /bin/sh). يُستخدم هذا في عدة أماكن: إذا كنت على نظام لا يدعم التحكم في الوظائف، تُستدعى هذه الصدفة عند ضغط ^K Z. كما أنها الصدفة التي تعمل في نوافذ الصدفة. إذا لم يُضبط SHELL (كما في Cygwin) أو إذا ضُبط على /bin/sh، يستدعي JOE أول صدفة موجودة من هذه القائمة: /bin/bash، /usr/bin/bash، /bin/sh.

• SIMPLE_BACKUP_SUFFIX
  إذا ضُبط، فسيُلحق باسم الملف بدلًا من ~ لإنشاء اسم ملف النسخة الاحتياطية.

• TAGS
  إذا ضُبط على مسار ملف، سيحاول JOE استخدامه كملف "tags" إذا لم يوجد ملف "tags" في الدليل الحالي.

• TEMP
  إذا ضُبط، يعطي المسار إلى الدليل لفتح ملف التبديل (swapfile) بدلًا من /tmp

• TERMCAP
  يُستخدم بواسطة محلل ملفات termcap المدمج في JOE (لا يُستخدم لـ terminfo). يمكن وضع مدخل termcap مباشرة في هذا المتغير (والذي سيُستخدم إذا طابق TERM)، أو إذا بدأ بـ /، فإنه يعطي قائمة بمسارات ملفات termcap للبحث فيها.

• TERMPATH
  يعطي قائمة بالمسارات لملفات termcap للبحث فيها عندما يحتوي TERMCAP على مدخل termcap (وإلا فسيُتجاهل). قائمة المسارات المبدئية لملفات termcap (عندما لا يحتوي TERMCAP و TERMPATH عليها) هي: "~/.termcap /etc/joe/termcap /etc/termcap"

• TERM
  يعطي نوع الطرفية، مثل "vt100" أو "xterm".

• USER
  يُستخدم للحصول على اسم المستخدم لأقفال الملفات المتوافقة مع EMACS.

أوامر JOE مجمعة حسب الوظيفة¶

يمكن إدخال هذه الأوامر عند محث Esc X.

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.