5.9 KiB
| title | localeTitle |
|---|---|
| Markdown Code Formatting | تنسيق الشفرة المنسقة |
تنسيق الشفرة المنسقة
هناك طريقتان لتنسيق التعليمات البرمجية في Markdown. يمكنك إما استخدام شفرة مضمنة ، من خلال وضع عناصر خلفية حول أجزاء من خط ما ، أو يمكنك استخدام كتلة تعليمات برمجية ، والتي سيقوم بعض العارضين بتطبيقها على تسليط الضوء عليه.
رمز مضمّن
يمكنك استخدام تنسيق التعليمات البرمجية المضمنة للتأكيد على أمر صغير أو جزء من البنية داخل السطر الذي تكتبه.
على سبيل المثال ، قد ترغب في الإشارة إلى وظيفة Array.protoype.map() في Javascript. باستخدام تنسيق التعليمات البرمجية المضمنة ، من الواضح أن هذا جزء من التعليمات البرمجية. يمكنك أيضًا استخدامه لتوضيح أمر المطراف ، مثل yarn install .
لاستخدام تنسيق التعليمات البرمجية المضمنة ، ما عليك سوى التفاف الشفرة التي تريد تنسيقها في backticks. على لوحة المفاتيح القياسية QWERTY للتخطيط الأمريكي ، يمكن العثور على هذا على يسار "1" ، وأعلى من علامة التبويب. يتم توفير مزيد من المعلومات حول موقع backtick على لوحات المفاتيح الدولية أدناه.
على سبيل المثال ، سيظهر كتابة `Array.prototype.map ()` في Array.prototype.map() كـ Array.prototype.map() .
كتل رمز
لكتابة مقتطفات من الشفرة أطول أو أكثر تفصيلاً ، غالبًا ما يكون من الأفضل وضعها داخل مجموعة تعليمات برمجية. تتيح لك رموز التعليمة البرمجية استخدام عدة أسطر ، وسيؤدي الترميز إلى وضعها داخل الصندوق الخاص بها وبنوع نوع الشفرة.
لتحقيق ذلك ، ابدء كتلة مع خط من ثلاثة backticks. هذا يشير إلى العلامة التي تقوم بإنشاء كتلة التعليمات البرمجية. سوف تحتاج إلى إنهاء مع خط آخر من ثلاثة backticks. فمثلا:
`` `
var add2 = function (number) {
رقم المرسل + 2 ؛
}
`` `
ستظهر في تخفيض السعر على النحو التالي:
var add2 = function(number) { return number + 2; }
على الرغم من أن العديد من محركات الشطب ، بما في ذلك تلك المستخدمة من قبل GitHub ، غير مدعومة أصلاً من خلال تخفيض السعر ، فإنها تدعم تسليط الضوء على تركيب الجملة. وهذا يعني أنه من خلال إخبارنا عن اللغة التي نستخدمها داخل كتلتنا ، فإنه سيضيف ألوانًا مثل بيئة تطوير متكاملة. يمكنك القيام بذلك عن طريق إضافة اسم اللغة على نفس السطر الخاص بك ثلاث علامات ظهر فتح. في المثال أعلاه ، إذا استخدمنا بدلاً من السطر الأول `` `` `` js ، فسيتم تطبيق التمييز على الكتلة.
var add2 = function(number) { return number + 2; }
هذا يمكن تطبيقه على أكثر من مجرد javascript رغم ذلك. يمكنني استخدام `` `html:
`
Hello World
`` `روبي:
"Hello World".split('').each do |letter| puts letter end
أو "بيثون":
a, b = 0, 1 while b < 10: print(b) a, b = a, a + b
بالإضافة إلى العديد من الآخرين. ولكن تذكر ، لن تقوم جميع محركات الشطب بتطبيق تسليط الضوء على تركيب الجملة.
كتابة باكتكس
يمكن أن يكون موقع مفتاح backtick مختلفًا على لوحات المفاتيح المختلفة ، وإذا كنت لا تستخدم لوحة مفاتيح QWERTY للتخطيط الأمريكي ، فقد يكون من الصعب العثور عليها. يسرد هذا الدليل المفيد بعض الطرق للعثور على مفتاح backtick الخاص بك ، والذي جمعناه هنا أدناه.
QWERTY و QWERTZ (المفتاح الذي تم وضع علامة له بالحد الأحمر)
AZERTY France ( Alt Gr + Key التي تم وضع علامة عليها بحدود حمراء)
AZERTY Belgium ( Alt Gr + Key التي تم وضع علامة عليها بحدود حمراء)
QWERTY Estonian (Keys التي تم تعليمها بحد أحمر)
رمز Alt
وأخيرًا ، يحتوي مفتاح backtick على رمز بديل ، والذي يجب أن يعمل على أي مفتاح رئيسي. إذا لم تتمكن من العثور على مفتاح backtick على لوحة المفاتيح ، يمكنك الاستمرار على مفتاح Alt ، ثم اضغط 9 ، ثم 6 (Alt + 9 ، 6). هذا سوف يدرج backtick.