65 lines
5.8 KiB
Markdown
65 lines
5.8 KiB
Markdown
---
|
|
title: Writing a Markdown File for GitHub Using Atom
|
|
localeTitle: كتابة ملف Markdown ل GitHub باستخدام Atom
|
|
---
|
|
يمثل Markdown طريقة لتصميم النص على الويب ، ويستفيد مستخدمو GitHub من الترقيم لتوفير الوثائق لمستودعاتهم.
|
|
|
|
من [أدلة GitHub](https://guides.github.com/features/mastering-markdown/) :
|
|
|
|
> يمكنك التحكم في عرض المستند. إن تنسيق الكلمات على شكل غامق أو مائل ، وإضافة الصور ، وإنشاء القوائم ليست سوى عدد قليل من الأشياء التي يمكننا القيام بها باستخدام 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` .
|
|
|
|
ملفات تخفيض السعر سهلة الكتابة ، ويمكنك العثور على ورقة الغش تخفيض السعر [هنا](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) .
|
|
|
|
## إنشاء ملف التمهيدي على جيثب
|
|
|
|
يمكنك إنشاء ملف README.md على GitHub نفسه:
|
|
|
|
|
|
|
|
يمنحك ذلك القدرة على التبديل بين طرق عرض "تعديل ملف جديد" و "معاينة":
|
|
|
|
|
|
|
|
هذا مثالي إذا كان الملف التمهيدي الخاص بك صغيرًا ، ولا تمانع في التبديل بين طريقتي العرض.
|
|
|
|
ولكن ماذا لو لم يكن ملف `.md` الخاص بك `.md` ، وتريد ترف العمل في محرر نصوص ومعاينة مباشرة لما يبدو عليه نصك في نفس الوقت الذي تقوم فيه بتحريره؟
|
|
|
|
## كتابة ملفات تخفيض السعر باستخدام Atom
|
|
|
|
إذا كنت تكتب ملفًا تقريبًا طويلًا أو مفصلاً ، فسيساعدك ذلك في الحصول على معاينة مباشرة لما يبدو عليه شكلك الشعار ، تمامًا كما قد تستخدم إمكانات إعادة التحميل المباشر لتحديث متصفحك إذا كنت تعمل في مشروع يستخدم HTML و CSS ، على سبيل المثال.
|
|
|
|
هناك طريقة جيدة للانطلاق نحو إنشاء ملف تخفيض السعر يستخدم [محرر نص Atom](https://atom.io/) . يمكنك تثبيت Atom واستخدامه مجانًا.
|
|
|
|
تستخدم Atom ، مثل برامج تحرير النصوص الأخرى ، الحزم ، وهي أجزاء من التعليمات البرمجية التي تسمح لك بتخصيص سير العمل الخاص بك.
|
|
1\. أولاً ، سترغب في تثبيت محرر نص Atom من [هنا](https://atom.io/) .
|
|
2\. عندما يتم تثبيت Atom ، افتحه ، وافتح ملفًا جديدًا `.md` .
|
|
3\. لمشاهدة المعاينة المباشرة ، انقر بزر الماوس الأيمن فوق ملف `.md` الخاص بك من المستكشف الموجود على اليمين ، ثم حدد الخيار العلوي ، "معاينة تخفيض السعر":
|
|
|
|
|
|
|
|
رائع! يجب أن تشاهد الآن جزأين في Atom. على اليسار يوجد النص الخاص بك ، وعلى اليمين هو تخفيض السعر "المجمع" ، أي ما قد يبدو عليه على GitHub:
|
|
|
|
|
|
|
|
لاحظ أن Atom يتعرف أيضًا على ما تعمل معه ليكون تنسيقًا محددًا ، أي "GitHub Markdown":
|
|
|
|
|
|
|
|
1. عندما يكون ملف تخفيض السعر الخاص بك جاهزًا للالتزام بمستودع GitHub ، يمكنك المضي قدمًا وإلزامه!
|
|
|
|
للمساهمة في ويكي FreeCodeCamp ، انتقل إلى [هذه الصفحة](https://github.com/FreeCodeCamp/freecodecamp/wiki) واطلع على قسم "أدلة حول كيفية المساهمة".
|
|
|
|
لإضافة مشروع أو ملفات إلى GitHub ، انتقل إلى [هذه الصفحة](https://help.github.com/articles/adding-an-existing-project-to-github-using-the-command-line/) .
|
|
|
|
**خطوة إضافية:** تحتوي Atom على حزمة باسم [Markdown Preview Plus](https://atom.io/packages/markdown-preview-plus) . وهو يفعل نفس طريقة المعاينة العادية للضغط ، ولكن يتم تصميم ملف المعاينة بشكل أكثر دقة على نمط GitHub. المضي قدما وتثبيت هذه الحزمة ونرى ما تحصل عليه.
|