98 lines
5.9 KiB
Markdown
98 lines
5.9 KiB
Markdown
---
|
|
title: Markdown Code Formatting
|
|
localeTitle: تنسيق الشفرة المنسقة
|
|
---
|
|
# تنسيق الشفرة المنسقة
|
|
|
|
هناك طريقتان لتنسيق التعليمات البرمجية في 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:
|
|
|
|
`
|
|
<div class="row">
|
|
<div class="col-md-6 col-md-offset-3">
|
|
<h1>Hello World</h1>
|
|
</div>
|
|
</div>
|
|
`
|
|
|
|
\`\` \`روبي:
|
|
|
|
`"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 للتخطيط الأمريكي ، فقد يكون من الصعب العثور عليها. يسرد [هذا](http://superuser.com/a/254077/122424) الدليل المفيد بعض الطرق للعثور على مفتاح 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. |