5.8 KiB
| title | localeTitle |
|---|---|
| Writing a Markdown File for GitHub Using Atom | كتابة ملف Markdown ل GitHub باستخدام Atom |
يمثل Markdown طريقة لتصميم النص على الويب ، ويستفيد مستخدمو GitHub من الترقيم لتوفير الوثائق لمستودعاتهم.
من أدلة GitHub :
يمكنك التحكم في عرض المستند. إن تنسيق الكلمات على شكل غامق أو مائل ، وإضافة الصور ، وإنشاء القوائم ليست سوى عدد قليل من الأشياء التي يمكننا القيام بها باستخدام Markdown. في الغالب ، Markdown هو مجرد نص عادي مع عدد قليل من الأحرف غير الأبجدية القيت ، مثل # أو *.
يمكنك استخدام Markdown في معظم الأماكن حول GitHub:
- جوهر
- التعليقات في القضايا وطلبات السحب
- الملفات ذات الامتداد .md أو .markdown
ملفات
.mdالسعر تحتوي على الامتداد.mdوسترى أن عددًا كبيرًا من مستودعات GitHub بها ملفاتREADME.md.
مثال رائع هو أنك إذا أردت كتابة ملف Wiki لهذا المستودع ، فستحتاج إلى أن يكون ملف .md . ما تقرأه الآن هو ملف writing-a-markdown-file-using-atom.md يسمى " writing-a-markdown-file-using-atom.md ملف writing-a-markdown-file-using-atom.md .
ملفات تخفيض السعر سهلة الكتابة ، ويمكنك العثور على ورقة الغش تخفيض السعر هنا .
إنشاء ملف التمهيدي على جيثب
يمكنك إنشاء ملف README.md على GitHub نفسه:
يمنحك ذلك القدرة على التبديل بين طرق عرض "تعديل ملف جديد" و "معاينة":
هذا مثالي إذا كان الملف التمهيدي الخاص بك صغيرًا ، ولا تمانع في التبديل بين طريقتي العرض.
ولكن ماذا لو لم يكن ملف .md الخاص بك .md ، وتريد ترف العمل في محرر نصوص ومعاينة مباشرة لما يبدو عليه نصك في نفس الوقت الذي تقوم فيه بتحريره؟
كتابة ملفات تخفيض السعر باستخدام Atom
إذا كنت تكتب ملفًا تقريبًا طويلًا أو مفصلاً ، فسيساعدك ذلك في الحصول على معاينة مباشرة لما يبدو عليه شكلك الشعار ، تمامًا كما قد تستخدم إمكانات إعادة التحميل المباشر لتحديث متصفحك إذا كنت تعمل في مشروع يستخدم HTML و CSS ، على سبيل المثال.
هناك طريقة جيدة للانطلاق نحو إنشاء ملف تخفيض السعر يستخدم محرر نص Atom . يمكنك تثبيت Atom واستخدامه مجانًا.
تستخدم Atom ، مثل برامج تحرير النصوص الأخرى ، الحزم ، وهي أجزاء من التعليمات البرمجية التي تسمح لك بتخصيص سير العمل الخاص بك.
1. أولاً ، سترغب في تثبيت محرر نص Atom من هنا .
2. عندما يتم تثبيت Atom ، افتحه ، وافتح ملفًا جديدًا .md .
3. لمشاهدة المعاينة المباشرة ، انقر بزر الماوس الأيمن فوق ملف .md الخاص بك من المستكشف الموجود على اليمين ، ثم حدد الخيار العلوي ، "معاينة تخفيض السعر":
رائع! يجب أن تشاهد الآن جزأين في Atom. على اليسار يوجد النص الخاص بك ، وعلى اليمين هو تخفيض السعر "المجمع" ، أي ما قد يبدو عليه على GitHub:
لاحظ أن Atom يتعرف أيضًا على ما تعمل معه ليكون تنسيقًا محددًا ، أي "GitHub Markdown":
- عندما يكون ملف تخفيض السعر الخاص بك جاهزًا للالتزام بمستودع GitHub ، يمكنك المضي قدمًا وإلزامه!
للمساهمة في ويكي FreeCodeCamp ، انتقل إلى هذه الصفحة واطلع على قسم "أدلة حول كيفية المساهمة".
لإضافة مشروع أو ملفات إلى GitHub ، انتقل إلى هذه الصفحة .
خطوة إضافية: تحتوي Atom على حزمة باسم Markdown Preview Plus . وهو يفعل نفس طريقة المعاينة العادية للضغط ، ولكن يتم تصميم ملف المعاينة بشكل أكثر دقة على نمط GitHub. المضي قدما وتثبيت هذه الحزمة ونرى ما تحصل عليه.