الاسم¶

nanorc - ملف إعداد نانو من غنو (GNU nano)

الوصف¶

تحتوي ملفات nanorc على الإعدادات المبدئية لمحرر النصوص الصغير والودود nano. أثناء بدء التشغيل، إذا لم يُعط الخيار --rcfile، يقرأ nano ملفين: أولًا الإعدادات على مستوى النظام من /etc/nanorc (قد يختلف المسار الدقيق في نظامك)، ثم الإعدادات الخاصة بالمستخدم، إما من ~/.nanorc أو من $XDG_CONFIG_HOME/nano/nanorc أو من ~/.config/nano/nanorc، أيهما يُعثر عليه أولًا. إذا أُعطي الخيار --rcfile، فيقرأ nano ملف الإعدادات المحدد فقط.

ملاحظات¶

منذ الإصدار 9.0، كل السطور تُمرر أفقياً معاً (عندما يقترب المؤشر من الحافة)، بالمقدار المطلوب فقط، بدلاً من تمرير السطر الحالي فقط بخطوة كبيرة. إذا كنت تفضل السلوك القديم، يمكنك استخدام --solo في سطر الأوامر أو set solosidescroll في ملف nanorc الخاص بك.

أيضًا منذ الإصدار 9.0، أُعيد تعيين ضغطات المفاتيح M-< و M-> إلى دالتي `scrollleft` و `scrollright`. إذا أردت أن تقوم ضغطات المفاتيح تلك بما كانت تفعله قبل الإصدار 9.0، أضف هذين السطرين في نهاية ملف nanorc الخاص بك:

منذ الإصدار 8.0، ولتكون الواجهة صديقة للمبتدئين، يبدأ الاختصار ^F بحثاً للأمام، و ^B يبدأ بحثاً للخلف، و M-F يبحث عن التكرار التالي للأمام، و M-B يبحث عن التكرار التالي للخلف. إذا كنت تريد أن تقوم ضغطات المفاتيح تلك بما كانت تفعله قبل الإصدار 8.0، أضف السطور الأربعة التالية في نهاية ملف nanorc الخاص بك:

الخيارات¶

يقبل ملف الإعداد سلسلة من الأوامر set و unset، والتي يمكن استخدامها لضبط نانو عند بدء التشغيل دون استخدام خيارات سطر الأوامر. بالإضافة إلى ذلك، هناك بعض الأوامر لتعريف إبراز الصيغة وإعادة ربط المفاتيح — انظر القسمين المنفصلين حول ذلك. يقرأ nano أمرًا واحدًا في كل سطر. يجب كتابة جميع الأوامر والكلمات المفتاحية بأحرف صغيرة.

تتمتع الخيارات في ملفات nanorc بالأولوية على قيم نانو المبدئية، وتتجاوز خيارات سطر الأوامر إعدادات nanorc. أيضًا، الخيارات التي لا تأخذ معطى تكون غير مفعّلة مبدئيًا. لذا، لا يلزم استخدام الأمر unset إلا عند الرغبة في تجاوز إعداد من ملف nanorc الخاص بالنظام في ملف nanorc الخاص بك. لا يمكن إلغاء تعيين الخيارات التي تأخذ معطى.

يجب عدم هروب علامات الاقتباس داخل معلمات characters أدناه. ستُعتبر آخر علامة اقتباس مزدوجة في السطر على أنها علامة الإغلاق.

الأوامر والمعطيات المدعومة هي:

set afterends

يجعل Ctrl+Right و Ctrl+Delete يتوقفان عند نهايات الكلمات بدلاً من بداياتها.

set allow_insecure_backup

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

set atblanks

عند تفعيل الالتفاف اللين للسطور، اجعله يلف السطور عند المحارف الفارغة (علامات التبويب والمسافات) بدلًا من الالتفاف دائمًا عند حافة الشاشة.

set autoindent

أزح السطر الجديد آلياً بنفس عدد علامات الجدولة أو المسافات كالسطر السابق (أو كالسطر التالي إذا كان السطر السابق هو بداية فقرة).

set backup

عند حفظ ملف، أنشئ ملفًا احتياطيًا عن طريق إضافة علامة المدا (~) إلى اسم الملف.

set backupdir directory

أنشئ واحفظ ليس فقط ملفًا احتياطيًا واحدًا، بل أنشئ واحفظ ملفًا مرقمًا بشكل فريد في كل مرة يُحفظ فيها الملف — عندما تكون النسخ الاحتياطية مفعّلة باستخدام set backup أو --backup أو -B. تُخزن الملفات المرقمة فريدًا في directory المحدد.

set boldtext

استخدم الخط العريض بدلًا من الفيديو المعكوس لشريط العنوان، وشريط الحالة، وشريط المحث، والشريط الصغير، ومجموعات المفاتيح، وأرقام السطور، والنص المحدد. يمكن تجاوز هذا عن طريق تعيين الخيارات titlecolor، و statuscolor، و promptcolor، و minicolor، و keycolor، و numbercolor، و/أو selectedcolor.

set bookstyle

عند الضبط (justifying)، عامل أي سطر يبدأ بمساحة فارغة كبداية لفقرة (ما لم يكن الإزاحة الآلية قيد التشغيل).

set brackets "characters"

اضبط المحارف التي تُعامل كأقواس إغلاق عند ضبط الفقرات. لا يجوز أن يشمل ذلك محارف فارغة. علامات ترقيم الإغلاق فقط (انظر set punct)، المتبوعة اختياريًا بأقواس الإغلاق المحددة، يمكنها إنهاء الجمل. القيمة المبدئية هي ""')>]}".

set breaklonglines

التف السطر الحالي التفافًا صلبًا آليًا عندما يصبح طويلاً جدًا — أي: عندما يصبح أعرض من القيمة المعطاة مع set fill (والتي تكون قيمتها المبدئية عرض الطرفية ناقص ثمانية).

set casesensitive

أجرِ عمليات بحث حساسة لحالة الأحرف مبدئيًا.

set colonparsing

عندما ينتهي اسم ملف معطى في سطر الأوامر بنقطتين ورأسيتين متبوعتين بأرقام ولا يكون اسم الملف هذا موجودًا، فاقصص النقطتين والأرقام واعتبر الأرقام رقم سطر. إذا كان اسم الملف المقصوص لا يوجد أيضًا، فكرر العملية واعتبر الرقمين المستخرجين رقم سطر وعمود. ولكن إذا لم يكن اسم الملف المقصوص مرتين موجودًا أيضًا، فانسَ أمر القص واقبل اسم الملف الأصلي كما هو. لتعطيل هذا التحليل للنقطتين لملف ما، استخدم +1 أو ما شابه قبل اسم الملف المعني.

set constantshow

أبلغ باستمرار عن موضع المؤشر في شريط الحالة. يتجاوز هذا الخيار quickblank.

set cutfromcursor

استخدم القص من المؤشر إلى نهاية السطر مبدئيًا، بدلًا من قص السطر بأكمله.

set emptyline

لا تستخدم السطر الموجود أسفل شريط العنوان، واتركه فارغاً تماماً.

set errorcolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لشريط الحالة عند عرض رسالة خطأ. القيمة المبدئية هي bold,white,red. انظر set titlecolor لمعرفة أسماء الألوان الصالحة.

set fill number

اضبط عرض الهدف للمحاذاة والالتفاف التلقائي القسري عند number من الأعمدة. إذا كانت القيمة 0 أو أقل، يحدث الالتفاف عند عرض الشاشة ناقص number من الأعمدة، مما يسمح لنقطة الالتفاف بالتغير مع عرض الشاشة إذا غُير حجمها. القيمة المبدئية هي -8.

set functioncolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لوصف الوظائف الموجز في سطري المساعدة بأسفل الشاشة. انظر set titlecolor لمزيد من التفاصيل.

set guidestripe number

ارسم شريطًا عموديًا عند العمود المعطى، للمساعدة في تقدير عرض النص. (يمكن تغيير لون الشريط باستخدام set stripecolor.)

set historylog

احفظ آخر مئة سلسلة بحث وسلسلة استبدال وأوامر نُفذت، بحيث يمكن إعادة استخدامها بسهولة في الجلسات اللاحقة.

set indicator

اعرض "شريط تمرير" على الجانب الأيمن من نافذة التحرير. يُوضَح موضع نافذة العرض في المخزن المؤقت ومقدار ما تُغَطِّيه نافذة العرض من المخزن المؤقت.

set jumpyscrolling

مرر محتويات المخزن المؤقت بمقدار نصف شاشة بدلاً من سطر واحد.

set keycolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لمجموعات مفاتيح الاختصار في سطري المساعدة بأسفل الشاشة. انظر set titlecolor لمزيد من التفاصيل.

set linenumbers

اعرض أرقام الأسطر إلى يسار منطقة النص. (أي سطر يحتوي على مرساة يحصل إضافياً على علامة في الهامش.)

set locking

فعّل ملفات القفل بأسلوب vim عند تحرير الملفات.

set magic

عندما لا يعطي اسم الملف ولا سطره الأول أي تلميح، حاول استخدام libmagic لتحديد الصيغة القابلة للتطبيق. (يمكن أن يكون استدعاء libmagic مستهلكًا للوقت نسبيًا، ولذلك لا يجري مبدئيًا.)

set matchbrackets "characters"

حدد أقواس الفتح والإغلاق التي يمكن العثور عليها عبر عمليات البحث عن الأقواس. لا يجوز أن يشمل ذلك محارف فارغة. يجب أن تأتي مجموعة الفتح قبل مجموعة الإغلاق، ويجب أن تكون المجموعتان بالترتيب نفسه. القيمة المبدئية هي "(<[{)>]}".

set minibar

إخفاء شريط العنوان وإظهار معلومات عن المخزن المؤقت الحالي بدلاً من ذلك في أسفل الشاشة، في مساحة شريط الحالة. في هذا "الشريط المصغر" يُعرض اسم الملف على اليسار، متبوعاً بنجمة إذا عُدل المخزن المؤقت. على اليمين تُعرض أرقام السطر والعمود الحاليين، ورمز المحرف الموجود تحت المؤشر (بتنسيق Unicode: U+xxxx)، ونفس الأعلام التي يعرضها set stateflags، ونسبة مئوية تعبر عن مدى تقدم المؤشر في الملف (من حيث عدد الأسطر). عند تحميل ملف أو حفظه، وكذلك عند التبديل بين المخازن المؤقتة، يُعرض عدد الأسطر في المخزن المؤقت بعد اسم الملف. يُمسح هذا الرقم عند ضغطة المفتاح التالية، أو يُستبدل بعداد [i/n] عند فتح مخازن مؤقتة متعددة. تُعرض أرقام السطر والعمود ورمز المحرف فقط عند استخدام --constantshow، ويمكن تبديلها بـ M-C. تُعرض أعلام الحالة فقط عند استخدام --stateflags.

set minicolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه للشريط الصغير. (عندما لا يُحدد هذا الخيار، تُستخدم ألوان شريط العنوان.) انظر set titlecolor لمزيد من التفاصيل.

set mouse

فعّل دعم الفأرة، إذا كان متاحًا في نظامك. عند تفعيله، يمكن استخدام نقرات الفأرة لوضع المؤشر، وتعيين العلامة (بنقرتين)، وتنفيذ الاختصارات. تعمل الفأرة في نظام النوافذ X، وعلى الطرفية عند تشغيل gpm. لا يزال بالإمكان تحديد النص من خلال السحب مع الاستمرار في الضغط على مفتاح Shift.

set multibuffer

عند قراءة ملف باستخدام ^R، أدرجه في مخزن مؤقت جديد مبدئيًا.

set noconvert

لا تحوّل الملفات من تنسيق DOS/Mac.

set nohelp

لا تعرض سطري المساعدة بأسفل الشاشة.

set nonewlines

لا تضف سطراً جديداً آلياً عندما لا ينتهي النص بواحد. (قد يتسبب هذا في حفظ ملفات نصية غير متوافقة مع POSIX.)

set nowrap

خيار مهجور لأنه أصبح الإعداد المبدئي. عند الحاجة، استخدم unset breaklonglines بدلاً من ذلك.

set numbercolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لأرقام السطور. انظر set titlecolor لمزيد من التفاصيل.

set operatingdir directory

عند بدء التشغيل، اجعل nano ينتقل إلى directory المعطى، واسمح بقراءة وكتابة الملفات في هذا الدليل وأدلته الفرعية فقط.

set positionlog

احفظ مواضع المؤشر والمراسخ بين جلسات التحرير. تُتذكر هذه المواضع لآخر 200 ملف جرى تحريرها.

set preserve

احفظ تسلسلات XOFF و XON (أي ^S و ^Q) حتى تُلتقط بواسطة الطرفية (لإيقاف المخرجات واستئنافها).

set promptcolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لشريط المحث. (عندما لا يُحدد هذا الخيار، تُستخدم ألوان شريط العنوان.) انظر set titlecolor لمزيد من التفاصيل.

set punct "characters"

اضبط المحارف التي تُعامل كعلامات ترقيم إغلاق عند ضبط الفقرات. لا يجوز أن يشمل ذلك محارف فارغة. علامات ترقيم الإغلاق المحددة فقط، المتبوعة اختياريًا بأقواس الإغلاق (انظر set brackets)، يمكنها إنهاء الجمل. القيمة المبدئية هي "!.?".

set quickblank

اجعل رسائل شريط الحالة تختفي بعد ضغطة مفتاح واحدة بدلاً من 20. لاحظ أن الخيار constantshow يتجاوز هذا. عندما يكون الخيار minibar أو zero قيد التشغيل، فإن quickblank يجعل الرسالة تختفي بعد 0.8 ثانية بدلاً من الوقت المبدئي البالغ 1.5 ثانية.

set quotestr "regex"

اضبط التعبير النمطي لمطابقة جزء الاقتباس في السطر. القيمة المبدئية هي "^([ \t]*([!#%:;>|}]|//))+". (لاحظ أن \t ترمز لمحرف جدولة فعلي.) هذا يتيح إعادة ضبط كتل النصوص المقتبسة عند صياغة البريد الإلكتروني، وإعادة لف كتل التعليقات السطرية عند كتابة الشيفرة المصدرية.

set rawsequences

تفسير تسلسلات الهروب مباشرة، بدلاً من مطالبة ncurses بترجمتها. (إذا كنت تحتاج لهذا الخيار لجعل بعض المفاتيح تعمل بشكل صحيح، فهذا يعني أن وصف طرفية terminfo المستخدم لا يتطابق تماماً مع السلوك الفعلي لطرفيتك. يمكن أن يحدث هذا عند الدخول عبر ssh إلى جهاز BSD مثلاً.) استخدام هذا الخيار يعطل دعم الفأرة في nano.

set rebinddelete

تفسير مفتاحي Delete و Backspace بشكل مختلف بحيث يعمل كلاهما بشكل صحيح. يجب استخدام هذا الخيار فقط عندما يتصرف Backspace في نظامك مثل Delete أو يتصرف Delete مثل Backspace.

set regexp

أجرِ عمليات بحث بالتعبيرات النمطية مبدئيًا. التعبيرات النمطية في nano هي من النوع الموسع (ERE).

set saveonexit

احفظ المخزن المؤقت المغيّر آليًا عند الخروج (^X)؛ دون إظهار محث.

set scrollercolor fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لاسم المؤشر المستعار "scrollbar". انظر set titlecolor لمزيد من التفاصيل.

set selectedcolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه للنص المحدد. انظر set titlecolor لمزيد من التفاصيل.

set showcursor

ضع المؤشر على العنصر المبرز في متصفح الملفات، واعرض المؤشر في عارض المساعدة، لمساعدة مستخدمي طريقة برايل وضعاف البصر.

set smarthome

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

set softwrap

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

set solosidescroll

عندما يقترب المؤشر من الحافة اليمنى لنافذة التحرير، يقوم بتمرير السطر الحالي فقط جانبياً بمقدار كبير، بدلاً من تمرير كل السطور المرئية جانبياً بالمقدار المطلوب فقط لإبقاء المؤشر في مجال الرؤية. سلوك التمرير الجانبي السلس للنافذة بالكامل هذا هو السلوك المبدئي الجديد. التمرير الجانبي المتقطع ذو السطر الواحد الذي يفعّله هذا الخيار كان السلوك القديم — السلوك الوحيد الذي عرفه nano.

set speller "program [argument ...]"

استخدم program المعطى لإجراء التدقيق الإملائي والتصحيح، بدلاً من استخدام المصحح المدمج الذي يستدعي hunspell(1) أو spell(1).

set spotlightcolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لإبراز مطابقة البحث. القيمة المبدئية هي black,lightyellow. انظر set titlecolor لمعرفة أسماء الألوان الصالحة.

set stateflags

استخدم الزاوية اليمنى العليا من الشاشة لإظهار بعض أعلام الحالة: I عند الإزاحة الآلية، و M عندما تكون العلامة مفعلة، و L عند اللف الصلب (كسر الأسطر الطويلة)، و R عند تسجيل ماكرو، و S عند اللف الناعم. عند تعديل المخزن المؤقت، تظهر نجمة (*) بعد اسم الملف في مركز شريط العنوان.

set statuscolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لشريط الحالة. انظر set titlecolor لمزيد من التفاصيل.

set stripecolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه للشريط الإرشادي العمودي. انظر set titlecolor لمزيد من التفاصيل.

set tabsize number

استخدم حجم علامة تبويب مقداره number من الأعمدة. يجب أن تكون قيمة number أكبر من 0. القيمة المبدئية هي 8.

set tabstospaces

حول كل علامة جدولة مكتوبة إلى مسافات — إلى عدد المسافات التي ستشغلها علامة جدولة في ذلك الموضع. (ملاحظة: علامات الجدولة الملصقة لا تُحول.)

set titlecolor [bold,][italic,]fgcolor,bgcolor

استخدم تشكيلة الألوان هذه لشريط العنوان. الأسماء الصالحة لألوان الواجهة والخلفية هي: red و green و blue و magenta و yellow و cyan و white و black. يمكن بادئة كل من هذه الأسماء الثمانية بكلمة light للحصول على نسخة أكثر سطوعًا من ذلك اللون. يمكن استخدام الكلمة grey أو gray كمرادف لـ lightblack. في محث لينكس، ليس لـ light أي تأثير على لون الخلفية. في محاكيات الطرفية التي تدعم 256 لونًا على الأقل، فإن أسماء الألوان الصالحة الأخرى (ولكن لا يمكن وضع بادئة لها) هي: pink و purple و mauve و lagoon و mint و lime و peach و orange و latte و rosy و beet و plum و sea و sky و slate و teal و sage و brown و ocher و sand و tawny و brick و crimson و normal — حيث تعني normal اللون المبدئي للواجهة أو الخلفية. في مثل هذه المحاكيات، يمكن أيضًا تحديد اللون كرقم ست عشري مكون من ثلاثة أرقام مسبوق بـ #، حيث تمثل الأرقام كميات الأحمر والأخضر والأزرق على التوالي. هذا يخبر nano أن يختار من اللوحة المتاحة اللون الذي يقترب من القيم المعطاة.

يمكن حذف إما "fgcolor" أو ",bgcolor"، ويمكن أن يسبق الزوج الكلمتان bold و/أو italic (مفصولة بفاصلات) للحصول على خط عريض و/أو مائل، إذا كانت طرفيتك تدعم ذلك.

set trimblanks

أزل المسافات الفارغة الزائدة من السطور الملتفة عند حدوث الالتفاف الصلب الآلي أو عند ضبط النص.

set unix

احفظ الملف مبدئيًا بتنسيق يونكس (Unix). يتجاوز هذا سلوك نانو المبدئي المتمثل في حفظ الملف بالتنسيق الذي كان عليه. (ليس لهذا الخيار أي تأثير عند استخدام set noconvert أيضًا.)

set whitespace "characters"

اضبط المحرفين المستخدمين للإشارة إلى وجود علامات التبويب والمسافات. يجب أن تكون محارف ذات عمود واحد. الزوج المبدئي للمحلية UTF-8 هو "»⋅" وللمحليات الأخرى ">.".

set wordbounds

اكتشف حدود الكلمات بشكل مختلف عن طريق معاملة محارف الترقيم كأجزاء من الكلمات.

set wordchars "characters"

حدد المحارف الأخرى (بجانب المحارف الأبجدية الرقمية العادية) التي ينبغي اعتبارها أجزاءً من الكلمات. عند استخدام هذا الخيار، ربما ترغب في إلغاء تعيين wordbounds.

set zap

يُسمح لمفتاحي Backspace أو Delete غير المعدلين بمسح المنطقة المحددة (بدلاً من محرف واحد، ودون التأثير على مخزن القص).

set zero

أخفِ جميع عناصر الواجهة (شريط العنوان، وشريط الحالة، وأسطر المساعدة) واستخدم جميع صفوف الطرفية لعرض محتويات المخزن المؤقت. يظهر شريط الحالة فقط عندما تكون هناك رسالة مهمة، ويختفي بعد 1.5 ثانية أو عند الضغطة التالية. باستخدام M-Z يمكن تبديل شريط العنوان مع شريط الحالة. وباستخدام M-X تُبدل أسطر المساعدة.

إبراز الصيغة¶

تلوين العناصر النحوية المختلفة للملف يجري عبر التعبيرات النمطية (انظر الأمر color أدناه). هذا غير كامل بطبيعته، لأن التعبيرات النمطية ليست قوية بما يكفي لتحليل الملف بشكل كامل. ومع ذلك، يمكن للتعبيرات النمطية أن تفعل الكثير ويسهل إنشاؤها، لذا فهي مناسبة تمامًا لمحرر صغير مثل nano.

جميع التعبيرات النمطية في nano هي تعبيرات نمطية موسعة متوافقة مع POSIX. هذا يعني أن المحارف . و ? و * و + و ^ و $ والعديد من المحارف الأخرى لها طبيعة خاصة. النقطة . تطابق أي محرف واحد، و ? تعني أن العنصر السابق اختياري، و * تعني أن العنصر السابق يمكن مطابقته صفر أو أكثر من المرات، و + تعني أن العنصر السابق يجب مطابقته مرة واحدة أو أكثر، و ^ تطابق بداية السطر، و $ تطابق نهايته، و \< تطابق بداية الكلمة، و \> تطابق نهايتها، و \s تطابق الفراغ. ويعني ذلك أيضًا أن التطلع الأمامي (lookahead) والتطلع الخلفي (lookbehind) غير ممكنين. يمكن العثور على شرح كامل في صفحة دليل GNU grep: man grep.

ينبغي إحاطة كل تعبير نمطي في ملف nanorc بعلامتي اقتباس مزدوجتين (""). يمكن أن تتلو التعبيرات النمطية المتعددة بعضها البعض في السطر من خلال فصلها بفراغات. هذا يعني أن التعبير النمطي لا يمكن أن يحتوي على علامة اقتباس مزدوجة متبوعة بفراغ. عندما تحتاج إلى هذه التشكيلة داخل تعبير نمطي، فيجب وضع إما علامة الاقتباس المزدوجة أو الفراغ بين قوسين مربعين ([]).

لكل نوع من الملفات يمكن تعريف صيغة منفصلة عبر الأوامر التالية:

syntax name ["fileregex" ...]

ابدأ تعريف الصيغة بهذا name. تضاف جميع أوامر color اللاحقة والأوامر الأخرى المشابهة إلى هذه الصيغة، حتى يُصادف أمر syntax جديد.

عند تشغيل nano، تنشط هذه الصيغة آليًا (للمخزن المؤقت المعني) إذا طابق اسم الملف المطلق التعبير النمطي الموسع fileregex. أو يمكن تنشيط الصيغة صراحةً (لجميع المخازن المؤقتة) باستخدام خيار سطر الأوامر -Y أو --syntax متبوعًا بـ name.

تعد الصيغة default خاصة: فهي لا تأخذ fileregex، وتُطبق على الملفات التي لا تطابق أي تعبيرات نمطية لأي صيغة. الصيغة none محجوزة؛ وتحديدها في سطر الأوامر يماثل عدم وجود صيغة على الإطلاق.

header "regex" ...

إذا لم يطابق أي fileregex من جميع الصيغ المعرفة، فقارن هذا regex (أو التعبيرات النمطية) بالسطر الأول من الملف الحالي، لتحديد ما إذا كان ينبغي استخدام هذه الصيغة له.

magic "regex" ...

إذا لم يطابق أي fileregex ولم يطابق أي تعبير نمطي لـ header أيضًا، فقارن هذا regex (أو التعبيرات النمطية) بنتيجة الاستعلام من قاعدة بيانات magic حول الملف الحالي، لتحديد ما إذا كان ينبغي استخدام هذه الصيغة له. (يجري هذا الاستعلام فقط عندما يكون libmagic مثبتًا بالفعل على النظام ومع إعطاء الخيار --magic أو الأمر set magic.)

formatter program [argument ...]

شغّل program المعطى على المحتويات الكاملة للمخزن المؤقت الحالي.

linter program [argument ...]

استخدم program المعطى لتشغيل فحص الصيغة في المخزن المؤقت الحالي.

comment "string"

استخدم string المعطى للتعليق وإلغاء التعليق على السطور. إذا كانت السلسلة تحتوي على محرف شريط عمودي أو أنبوب (| )، فإن هذا يعين تعليقات بأسلوب الأقواس؛ على سبيل المثال، "/*|*/" لملفات CSS. تلحق المحارف التي تسبق الأنبوب في بداية السطر وتلحق المحارف التي بعد الأنبوب في نهاية السطر. إذا لم يكن محرف الأنبوب موجودًا، تلحق السلسلة الكاملة في البداية؛ على سبيل المثال، "#" لملفات بايثون. إذا حُددت علامتا اقتباس مزدوجتان فارغتان، تُعطّل وظيفة التعليق/إلغاء التعليق؛ على سبيل المثال، "" لملفات JSON. القيمة المبدئية هي "#".

tabgives "string"

اجعل مفتاح <Tab> ينتج string المعطى. مفيد للغات مثل بايثون التي تتطلب رؤية مسافات فقط للإزاحة. يتجاوز هذا إعداد الخيار tabstospaces.

color [bold,][italic,]fgcolor,bgcolor "regex" ...

لون جميع أجزاء النص التي تطابق التعبير النمطي الموسع regex بألوان الواجهة والخلفية المعطاة، ويجب تحديد أحدها على الأقل. أسماء الألوان الصالحة هي: red و green و blue و magenta و yellow و cyan و white و black. يمكن بادئة كل من هذه الأسماء الثمانية بكلمة light للحصول على نسخة أكثر سطوعًا من ذلك اللون. يمكن استخدام الكلمة grey أو gray كمرادف لـ lightblack. في محث لينكس، ليس لـ light أي تأثير على لون الخلفية. في محاكيات الطرفية التي تدعم 256 لونًا على الأقل، فإن أسماء الألوان الصالحة الأخرى (ولكن لا يمكن وضع بادئة لها) هي: pink و purple و mauve و lagoon و mint و lime و peach و orange و latte و rosy و beet و plum و sea و sky و slate و teal و sage و brown و ocher و sand و tawny و brick و crimson و normal — حيث تعني normal اللون المبدئي للواجهة أو الخلفية. في مثل هذه المحاكيات، يمكن أيضًا تحديد اللون كرقم ست عشري مكون من ثلاثة أرقام مسبوق بـ #, حيث تمثل الأرقام كميات الأحمر والأخضر والأزرق على التوالي. هذا يخبر nano أن يختار من اللوحة المتاحة اللون الذي يقترب من القيم المعطاة.

يمكن أن يسبق زوج الألوان الكلمتان bold و/أو italic (مفصولة بفاصلات) للحصول على خط عريض و/أو مائل، إذا كانت طرفيتك تدعم ذلك.

تُطبق جميع أوامر التلوين بالترتيب الذي حُددت به، مما يعني أن الأوامر اللاحقة يمكنها إعادة تلوين الأشياء التي لُوّنت سابقًا.

icolor [bold,][italic,]fgcolor,bgcolor "regex" ...

مثله كالعلا، باستثناء أن المطابقة غير حساسة لحالة الأحرف.

color [bold,][italic,]fgcolor,bgcolor start="fromrx" end="torx"

لون جميع أجزاء النص التي تطابق بدايتها التعبير النمطي الموسع fromrx وتطابق نهايتها التعبير النمطي الموسع torx بألوان الواجهة والخلفية المعطاة، ويجب تحديد أحدها على الأقل. هذا يعني أنه بعد ظهور أول مثيل لـ fromrx، يُلوّن النص بأكمله حتى أول مثيل لـ torx. يتيح هذا لإبراز الصيغة أن يمتد عبر سطور متعددة.

icolor [bold,][italic,]fgcolor,bgcolor start="fromrx" end="torx"

مثله كالعلا، باستثناء أن المطابقة غير حساسة لحالة الأحرف.

include "syntaxfile"

اقرأ صيغ الألوان القائمة بذاتها من syntaxfile. لاحظ أن syntaxfile لا يجوز أن يحتوي إلا على الأوامر المذكورة أعلاه، من syntax إلى icolor.

extendsyntax name command argument ...

وسع الصيغة المعرفة سابقًا باسم name بأمر آخر command. يتيح هذا إضافة أمر جديد لـ color أو icolor أو header أو magic أو formatter أو linter أو comment أو tabgives إلى صيغة معرفة بالفعل — وهو أمر مفيد عندما تريد تحسين صيغة معرفة في أحد الملفات المثبتة في النظام طفيفًا (والتي لا تكون قابلة للكتابة عادةً).

إعادة ربط المفاتيح¶

يمكن تغيير روابط المفاتيح عبر الأوامر الثلاثة التالية:

لاحظ أن bind key "{function}" menu يماثل bind key function menu، باستثناء أنه في الشكل الأخير يتحقق nano من توفر function في menu المعطاة في وقت بدء التشغيل (ويبلغ عن خطأ إذا لم تكن موجودة هناك)، بينما في الشكل الأول يتحقق nano في وقت التنفيذ من وجود function ولكن ليس مما إذا كانت منطقية في القائمة الحالية. يجب على المستخدم التأكد من ملاءمة اسم الوظيفة بين الأقواس المعقوفة (أو أي تسلسل منها). قد ينتج سلوك غريب أو حتى انهيار للنظام عندما يكون الاسم المحاط بأقواس غير مناسب.

ينبغي أن يكون تنسيق key أحد التالي:

قد لا تكون إعادة ربط ^M (مفتاح الإدخال Enter) أو ^I (مفتاح الجدولة Tab) فكرة جيدة. إعادة ربط ^[ (مفتاح الهروب Esc) غير ممكنة، لأن رمز المفتاح الخاص بها هو البايت البادئ لضغطات مفاتيح Meta وتسلسلات الهروب. إعادة ربط أي من المفاتيح المخصصة لتحريك المؤشر (الأسهم، ومفاتيح Home و End و PageUp و PageDown) غير ممكنة. في بعض الطرفيات، لا يمكن إعادة ربط ^H (ما لم يُستخدم الخيار --raw) لأن رمز المفتاح الخاص بها يتطابق مع رمز مفتاح مسافة للخلف (Backspace).

أسماء function الصالحة للربط هي:

أقسام القائمة الصالحة هي:

أمثلة¶

لجعل الاختصار Ctrl+Z يعلّق عمل نانو:

لجعل الاختصار Shift+Alt+C ينسخ المنطقة المعلّمة إلى حافظة النظام:

الملفات¶

/etc/nanorc

ملف ضبط على مستوى النظام.

~/.nanorc أو $XDG_CONFIG_HOME/nano/nanorc أو ~/.config/nano/nanorc

ملف ضبط لكل مستخدم.

/usr/share/nano/*

تعريفات الصيغ لتلوين الصيغة لأنواع الملفات الشائعة (ولأنواع الملفات الأقل شيوعًا في الدليل الفرعي extra/).

انظر أيضًا¶

nano(1)

https://nano-editor.org/cheatsheet.html

نظرة عامة على ارتباطات المفاتيح المبدئية.

ترجمة¶

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

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

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