You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
carbon/docs/README.ar.md

227 lines
13 KiB
Markdown

<p align="center">
<img width="100%" src="https://user-images.githubusercontent.com/10369094/31211729-591d059c-a950-11e7-86af-fa5ea3d7dbac.png" />
</p>
<p align="center">
<a href="https://reporanger.com">
<img src="https://img.shields.io/badge/maintained%20with-Ranger-1f93f3.svg" alt="maintained with Ranger" />
</a>
<a href="#contributors">
<img src="https://img.shields.io/badge/all_contributors-160-orange.svg" alt="All Contributors" />
</a>
<a href="/LICENSE">
<img src="https://img.shields.io/github/license/carbon-app/carbon.svg" alt="MIT License" />
</a>
<a href="https://app.fossa.io/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon?ref=badge_shield">
<img src="https://app.fossa.io/api/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon.svg?type=shield" alt="FOSSA Status" />
</a>
</p>
<br>
## <h2 dir="rtl">مقدمة</h2>
<div dir="rtl">
انت شوفت <a href="https://twitter.com/dan_abramov/status/890191815567175680">كل</a> <a href="https://twitter.com/reactjs/status/890511993261654017">لقطات الشاشه</a> <a href="https://twitter.com/notquiteleo/status/873483329345028096">لكود</a> في تويتر؟ مع ان الكود بيكون كويس وبيبهرنا؛ بس احنا شوفنا فرصه ان احنا نحسن الشكل بتاع الكود. كاربون بيخلي الموضوع سهل في مشاركه صور الكود بتاعك، ليه تستنا؟ انطلق لابهار جميع متابعيك ببراعه وحلاوه التصميم
</div>
<br>
<p align="center">
<img width="100%" alt="Carbon example" src="https://user-images.githubusercontent.com/8397708/63456416-b27d1a80-c403-11e9-9572-105b089be885.png">
</p>
## <div dir="rtl">المميزات</div>
<ul dir="rtl">
<li><strong>التخصيص</strong>. قم بتخصيص أشياء مثل سمة بناء جملة صورتك ونمط الخط والمزيد</li>
<li><strong>شارك بسرعة</strong>. احفظ صورتك أو رابط بنقرة واحدة</li>
<li><strong>حفظ المقتطفات</strong>. أنشئ حسابًا لحفظ المقتطفات لوقت لاحق. يتم نشر المقتطفات المشتركة تلقائيًا على Twitter و Slack.</li>
</ul>
## <div dir="rtl">كيفيه الاستخدام</div>
#### <div dir="rtl">استيراد</div>
<div dir="rtl">
<p>توجد عدة طرق مختلفة لاستيراد التعليمات البرمجية إلى كاربون:</p>
<ul>
<li>قم بإسقاط ملف على المحرر</li>
<li>قم بإلحاق معرف GitHub بعنوان (URL) (e.g. <a href="https://carbon.now.sh/3208813b324d82a9ebd197e4b1c3bae8"><code dir="ltr">carbon.now.sh/&lt;gist_id_goes_here&gt;</code></a>)</li>
<li>أو ابدأ بالكتابة!</li>
</ul>
</div>
#### <div dir="rtl">التخصيص</div>
<div dir="rtl">بمجرد حصولك على جميع التعليمات البرمجية الخاصة بك في Carbon ، يمكنك تخصيص صورتك عن طريق تغيير سمة البنية ولون الخلفية وموضوع النافذة والحشو والظلال والخطوط والمزيد.</div>
#### <div dir="rtl">التصدير والمشاركة</div>
<div dir="rtl">بعد تخصيص صورتك ، يمكنك مشاركة مقتطفك بعدة طرق</div>
#### <div dir="rtl">أنشئ مقتطفًا محفوظًا</div>
<div dir="rtl">
<p>ستؤدي مشاركة مقتطف محفوظ إلى فتح الصورة تلقائيًا على منصات مثل Twitter و Slack. يتيح ذلك للمستخدمين رؤية إنشائك ، مع منحهم أيضًا إمكانية الوصول إلى شفرة المصدر عبر الرابط. والأفضل من ذلك ، إذا كنت بحاجة إلى إجراء تحديث ، فما عليك سوى اتباع الرابط بنفسك لتحرير المقتطف مباشرةً.</p>
<p>لإنشاء مقتطف محفوظ:</p>
<ol>
<li>تسجيل الدخول باستخدام زر "تسجيل الدخول / التسجيل"</li>
<li>قم بالتحرير كما تفعل عادةً - سيتم حفظ المقتطف الخاص بك تلقائيًا</li>
<li>انسخ عنوان URL من نافذة المتصفح الخاص بك وشاركه!</li>
</ol>
</div>
#### <div dir="rtl">قم بتضمين المقتطف</div>
<div dir="rtl">
<p>هذه هي الطريقة الموصى بها لمشاركة Carbon على موقع الويب أو المدونة الخاصة بك. يمكن للقارئ نسخ الكود بنقرة زر واحدة.</p>
<p>يمكنك تضمين أي مقتطف كربون في موقع الويب الخاص بك مباشرة باستخدام عنوان <code dir="ltr">carbon.now.sh/embed</code> URL. تتيح لك "قائمة النسخ" نسخ مقتطف iFrame أو عنوان URL المشفر بسرعة للتضمين في أنظمة أساسية مثل Medium.</p>
<p>أخيرًا ، يمكنك أيضًا تضمين المقتطفات المحفوظة أو قوائم GitHub باستخدام <code dir="ltr">carbon.now.sh/embed/:id</code>.</p>
</div>
#### <div dir="rtl">استخدم زر <span dir="ltr">Twitte</span></div>
<div dir="rtl">
<p>لن يقوم زر التغريد بمشاركة الصورة على تويتر فحسب ، بل سيقوم أيضًا بترميز النص بشكل صحيح لضمان إمكانية الوصول إلى صورك. ومع ذلك ، إذا كنت تريد أن تغرد صورة بنفسك ، فالرجاء التحقق من <a href="https://help.twitter.com/en/using-twitter/picture-descriptions">كيفية تسهيل الوصول إلى صور Twitter الخاصة بك.</a></p>
</div>
#### <div dir="rtl">حمل الصورة مباشرة</div>
<div dir="rtl">
<p>يدعم Carbon تنزيل صورتك بصيغة PNG و SVG. يمكنك أيضًا النقر فوق<code dir="ltr">Export → Open</code> لفتح صورتك مباشرة في المتصفح. أخيرًا ، يمكنك نسخ صورة الكربون مباشرةً إلى الحافظة الخاصة بك بالانتقال إلى<code dir="ltr">Copy → Image</code>.</p>
</div>
#### <div dir="rtl">تثبيت Carbon لسطح المكتب (غير متصل بالإنترنت)</div>
<div dir="rtl">
<p>إذا كنت تستخدم Google Chrome ، أو متصفحًا آخر يدعم تطبيقات الويب التقدمية ، فيمكنك تثبيت Carbon لاستخدام
في حاله لو انت غير متصل بالإنترنت عن طريق:</p>
<ol>
<li>قم بزياره <a dir="ltr" href="https://carbon.now.sh">carbon.now.sh</a></li>
<li>انقر فوق قائمة إعدادات متصفحك</li>
<li>و اضغط &quot;Install Carbon...&quot;</li>
</ol>
</div>
## <div dir="rtl">الجماعة</div>
<div dir="rtl">تحقق من هذه المشاريع التي قام مجتمعنا الرائع بإنشائها:</div>
#### <div dir="rtl">إضافات المحرر</div>
<ul dir="rtl">
<li><a dir="ltr" href="https://plugins.jetbrains.com/plugin/10469-carbon-now-sh">IntelliJ IDEA <code>carbon-now-sh</code></a> - افتح التحديد في ملف IntelliJ IDEA الحالي الخاص بك في Carbon من خلال قائمة السياق</li>
<li><a dir="ltr" href="https://atom.io/packages/carbon-now-sh">Atom <code>carbon-now-sh</code></a> - افتح ملف Atom الحالي في Carbon باستخدام <code dir="ltr">shift-cmd-A</code></li>
<li><a dir="ltr" href="https://marketplace.visualstudio.com/items?itemName=ericadamski.carbon-now-sh">VS Code <code>carbon-now-sh</code></a> - افتح ملف VS Code الحالي في Carbon باستخدام الأمر <code dir="ltr">carbon</code></li>
<li><a dir="ltr" href="https://github.com/molnarmark/carbonSublime">Sublime Text 3 <code>carbon-now-sh</code></a> - افتح التحديد في ملف Sublime Text 3 الحالي الخاص بك باستخدام مفتاح مرتبط مخصص</li>
<li><a dir="ltr" href="https://github.com/kristijanhusak/vim-carbon-now-sh">Vim <code>carbon-now-sh</code></a> - قلم التحديد في وظيفة استخدام Vim / Neovim الحالية <code dir="ltr">CarbonNowSh()</code></li>
<li><a dir="ltr" href="https://github.com/veelenga/carbon-now-sh.el">Emacs <code>carbon-now-sh</code></a> - افتح التحديد في Emacs الحالي الخاص بك باستخدام الوظيفة التفاعلية <code dir="ltr">carbon-now-sh</code></li>
<li><a dir="ltr" href="https://github.com/StevenMagdy/CarboNow4Xcode">Xcode <code>carbon-now-sh</code></a> - افتح اختيارك الحالي في <code dir="ltr">carbon.now.sh</code></li>
<li><a dir="ltr" href="https://github.com/bow-swift/nef-plugin">Xcode <code>nef</code></a> - يمكّنك امتداد Xcode هذا من تصدير تحديد رمز كمقتطف كربون في إجراء واحد</li>
</ul>
#### <div dir="rtl">الأدوات</div>
<ul dir="rtl">
<li><a dir="ltr" href="https://github.com/mixn/carbon-now-cli">CLI <code dir="ltr">carbon-now-cli</code></a> - افتح ملفًا في Carbon أو قم بتنزيله مباشرةً باستخدام <code dir="ltr">carbon-now</code>, تتميز بوضع تفاعلي وإبراز انتقائي والمزيد</li>
<li><a dir="ltr" href="https://codeexpander.com">CodeExpander</a> - عميل GitHub ذكي مع ميزات TextExpander</li>
<li><a dir="ltr" href="https://github.com/bow-swift/nef#-exporting-carbon-code-snippets"><code dir="ltr">nef</code></a> - تصدير عدة مقتطفات رمز الكربون من <code dir="ltr">Xcode Playground</code>.</li>
<li><a dir="ltr" href="https://t.me/carbonshbot"><code>@carbonshbot</code></a> - روبوت الدردشة Telegram الذي يأخذ مقتطفًا من التعليمات البرمجية أو عنوان URL الجوهري وينشئ صورة كربونية</li>
<li><a dir="ltr" href="https://yonicd.github.io/carbonate/">R <code>carbonate</code></a> - تلاعب بشكل متكرر بجماليات الصورة في <code dir="ltr">R</code> وإما أن تفتح في Carbon أو تنزل مباشرة.</li>
<li><a dir="ltr" href="https://github.com/faisalsayed10/carbon-slack">Carbon for Slack</a> - استخدم الكربون مباشرة في Slack. فقط قم باستدعاء ملف <code dir="ltr">/carbon</code> أمر.</li>
</ul>
#### <div dir="rtl">الاقتباسات</div>
<ul dir="rtl">
<li><a dir="ltr" href="https://itunes.apple.com/us/book/id1435714196">&quot;CS 101 - An Introduction to Computational Thinking&quot;</a> - كتاب علوم الكمبيوتر من تأليف Sarbo Roy.</li>
</ul>
## <div dir="rtl">المؤلفون</div>
<div dir="rtl">
<p>الكربون هو مشروع من قبل:</p>
<ul dir="ltr">
<li>Mike Fix (<a href="https://twitter.com/fixitup2">@mfix22</a>)</li>
<li>Brian Dennis (<a href="https://github.com/briandennis">@briandennis</a>)</li>
<li>Jake Dexheimer (<a href="https://github.com/jakedex">@jakedex</a>)</li>
</ul>
</div>
#### <div dir="rtl">ترخيص</div>
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon?ref=badge_large)
<br />
<br />
---
## <div dir="rtl">المساهمة والدعم</div>
<p dir="rtl">طلبات السحب مرحب بها! يرجى الاطلاع على <a dir="ltr" href="/.github/CONTRIBUTING.md">contributing guidelines</a> لمزيد من التفاصيل.</p>
### <div dir="rtl">الرعاة والداعمون</div>
[![Fossa](https://assets-global.website-files.com/5f4d9ea2592c16056cb0f7a5/5f4d9ea2592c16d9a2b0f7da_logo-FOSSA-night-blue.svg)](https://fossa.com)
[![Powered by Vercel](https://www.datocms-assets.com/31049/1618983297-powered-by-vercel.svg)](https://vercel.com?utm_source=carbon-app&utm_campaign=oss)
<a href="https://opencollective.com/carbon-app/backers/0/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/0/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/1/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/1/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/2/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/2/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/3/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/3/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/4/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/4/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/5/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/5/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/6/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/6/avatar"></a>
<a href="https://opencollective.com/carbon-app/backers/7/website" target="_blank"><img src="https://opencollective.com/carbon-app/backers/7/avatar"></a>
### <div dir="rtl">بفضل</div>
<p dir="rtl"><a dir="ltr" href="https://vercel.com?utm_source=carbon-app&amp;utm_campaign=oss">▲ Vercel</a> لرعاية استضافة كربون.</p>
### <div dir="rtl">جميع المساهمين</div>
<p dir="rtl">الشكر لكل هؤلاء الناس الرائعين (<a dir="ltr" href="https://github.com/kentcdodds/all-contributors#emoji-key">emoji key</a>):</p>
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->