Skip to content

Latest commit

 

History

History
297 lines (242 loc) · 44.5 KB

README.fa.md

File metadata and controls

297 lines (242 loc) · 44.5 KB

maintained with Ranger All Contributors MIT License FOSSA Status



 آشنایی اولیه

احتمالا تا الان کلی از این اسکرین شات های کد ها را در توئیتر و اینطرف و آنطرف دیده اید. ولی بنظر ما هنوز جای بهبود در زیبایی این تصاویر بود، پس این شما و این کربن! کربن یک ابزار حرفه ای برای ساختن و اشتراک تصاویر چشم نواز از کد شماست. پس منتظر چه هستید؟ همین حالا کد تان را به زیبا ترین شکل ممکن آماده کنید!

Carbon example

امکانات

  • شخصی سازی. امکان شخصی سازی تقریبا همه چیز، از استایل رنگ بندی گرفته تا فونت و خیلی بیشتر!
  • اشتراک سریع. با یک کلیک تصویرتان را دانلود و یا اشتراک گذاری کنید.
  • ذخیره کد های کوچک. با ساخت یک حساب کاربری، قطعه کد های شما ذخیره و در صورت نیاز میتوانید بطور مستقیم آنها را در توئیتر و اسلک به اشتراک بگذارید.

نحوه استفاده

وارد کردن کد به کربن

راه های مختلفی برای واردن کردن کد شما به کربن وجود دارد:

  • فایل کدتان را داخل ادیتور بیندازید(Drag and Drop)
  • یک gist ID از گیتهاب را در آدرس صفحه بیندازید (برای مثال: <carbon.now.sh/<gist_id)
  • یا شروع به تایپ کردن کد تان در ادیتور کنید!

شخصی سازی

بعد از اینکه تمام کدتان را وارد کربن کردید، میتوانید با تغییر قالب رنگی سینتکس ها، رنگ پس زمینه، عنوان صفحه، فاصله ها، سایه ها، فونت ها و دیگر موارد به شخصی سازی تصویرتان بپردازید!

دانلود و اشتراک گذاری

بعد از اینکه شخصی سازی تصویرتان هم به اتمام رسید و به نتیجه مدنظرتان رسیدید، میتوانید قطعه کدتان را به روش های مختلفی به اشتراک بگذارید:

ساخت یک قطعه کد ذخیره شده

ااشتراک گذاری یک قطعه کد ذخیره شده بطور خودکار تصویر را در پلتفرم هایی مثل توئیتر و اسلک منتشر خواهد کرد. در نتیجه، کاربران میتوانند قطعه کد شما را ببینند و علاوه بر آن، با کلیک روی لینک به کد نیز دسترسی پیدا کنند. همچنین در این روش، میتوانید با مراجعه به همان لینک نسبت به ادیت کدتان و موارد مربوط به آن نیز اقدام کنید! برای ساخت یک قطعه کد ذخیره شده:

  1. با استفاده از دکمه "Sign in/Sign up" وارد شوید
  2. مطابق معمول به ادیت کد مورد نظرتان بپردازید
  3. آدرس بالای صفحه(URL) را کپی کرده و به اشتراک بگذارید!
امبد(Embed) کردن قطعه کد

این راه پیشنهادی ما برای قرار دادن کربن در وبسایت و یا بلاگ شماست. در این روش مخاطبان میتوانند کد را با تنها یک کلیک کپی کنند. شما میتوانید با استفاده از carbon.now.sh/embed هر قطعه کدی را در وبسایتتان به نمایش بگذارید. منوی کپی(Copy Menu) به شما اجازه میدهد به سرعت iFrame صحیح برای قطعه کد و یا آدرس encode شده برای embed کردن روی پلتفرم هایی مانند Medium را بدست آورید.

همچنین شما میتوانید قطعه کد های ذخیره شده و یا gist های گیتهاب را هم با استفاده از carbon.now.sh/embed/:id امبد(Embed) کنید.

از دکمه توئیت(Tweet) استفاده کنید!

دکمه توئیت نه تنها تصویر مورد نظر شما را در توئیتر به اشتراک میگذارد، بلکه توضیحات تصویر(alt text) صحیح را هم به آن اضافه میکند تا مطمئن شود که همه میتوانند تصویر را به درستی بخوانند! با این حال در صورتی که میخواهید خودتان تصاویر را توئیت کنید، لطفا راهنمای خوانا سازی تصاویر برای توئیتر را مطالعه کنید.

دانلود مستقیم تصویر

ابزار کربن دانلود مستقیم تصویر ساخته شده را به دو فرمت PNG and SVG را پشتیبانی میکند. همچنین میتوانید با کلیک روی Export → Open تصویر خروجی را بطور مستقیم در مرورگر باز کنید. در پایان، با رفتن به Copy → Image میتوانید تصویر را مستقیم در کلیپ بورد خود کپی کنید.

نصب کربن برای لپتاپ و یا کامپیوتر برای استفاده آفلاین

در صورتی که از مرورگر کروم(Google Chrome) و یا هر مرورگر دیگری که از وب اپ های پیشرو(PWA) ها پشتیبانی میکند استفاده میکنید، میتوانید با طی مراحل زیر کربن را برای استفاده آفلاین و بدون اینترنت در مروگر خود نصب کنید:

  1. به carbon.now.sh بروید
  2. روی دکمه منوی تنظیمات مرورگر خود(Browser's settings menu) کلیک کنید
  3. روی "Install Carbon..." کلیک کنید

کامیونیتی

سری به این پروژه های فوق العاده که کامیونیتی ما ساخته بزنید:

پلاگین های ادیتور ها
  • افزونه IntelliJ IDEA carbon-now-sh - کد انتخاب شده در فایل فعلی باز شده در IntelliJ IDEA را در کربن با استفاده از یک Context menu باز کنید
  • افزونه Atom carbon-now-sh - فایل Atom فعلی تان را در کربن با استفاده از کلید ترکیبی shift-cmd-A باز کنید
  • افزونه VS Code carbon-now-sh - با استفاده از کامند carbon فایل فعلی تان را در کربن باز کنید
  • افزونه Sublime Text 3 carbon-now-sh - کد انتخاب شده در فایل باز شده تان در Sublime Text 3 را با استفاده از یک کلید ترکیبی کاستوم در کربن باز کنید
  • افزونه Vim carbon-now-sh - کد انتخاب شده در فایل باز شده تان در Vim/Neovim را با فانکشن CarbonNowSh() در کربن باز کنید
  • افزونه Emacs carbon-now-sh - کد انتخاب شده فعلی در Emacs را با فانکشن interactive carbon-now-sh در کربن باز کنید
  • افزونه Xcode carbon-now-sh - کد انتخاب شده فعلی تان را در carbon.now.sh باز کنید
  • افزونه Xcode nef - این افزونه Xcode به شما اجازه میدهد کد انتخاب شده را بصورت مستقیم به عنوان یک قطعه کد در کربن خروجی بگیرید
ابزار ها
  • ابزار خط فرمان(CLI) carbon-now-cli - با استفاده از carbon-now, یک فایل را در کربن باز و یا دانلود کنید. این ابزار تعاملی به شما امکاناتی مثل هایلایت کردن انتخابی و دیگر موارد را خواهد داد
  • ابزار CodeExpander - یک کلاینت هوشمند gist های گیتهاب، با قابلیت های TextExpander
  • ابزار nef - چندین قطعه کد کربن را از Xcode Playground خروجی بگیرید
  • ربات تلگرامی @carbonshbot -یک ربات تلگرام که قطعه کد و یا آدرس gist را از شما گرفته، و یک تصویر کربن را برای شما می سازد
  • ابزار زبان R carbonate - بصورت تعاملی ویژگی های تصویر را در R ویرایش کرده، در کربن باز کنید و یا مستقیما دانلود کنید
  • کربن برای اسلک - کربن را بطور مستقیم در اسلک استفاده کنید! کافیست از کامند /carbon استفاده کنید
ارجاعات

نویسندگان

کربن توسط این افراد خفن ساخته شده است:

لایسنس

FOSSA Status




پشتیبانی و مشارکت در این پروژه

ما از Pull requests ها استقبال میکنیم! لطفا قوانین و شرایط مشارکت و کانتریبیوت کردن را برای جزئیات بیشتر بخوانید.

اسپانسر ها و حامیان

Fossa

Powered by Vercel

با تشکر از

▲ Vercel برای اسپانسر هاستینگ کربن شدن.

تمام مشارکت کنندگان

یک دمت گرم، به همه این افراد فوق العاده که در پروژه کربن مشارکت داشته اند (emoji key):


briandennis

💻 📖 🚇 👀

mfix22

💬 💻 🤔

jakedex

💬 💻 🎨 📹

andrewda

💬 💻 🐛 👀

yeskunall

💻 📖 🔧 🐛

stoshfabricius

💻

jkling38

📖

otobrglez

💻

darahak

📖

dom96

💻

elrumordelaluz

💻

cjb

💻

Krzysztof-Cieslak

💻

fernahh

📖

g3r4n

💻

Mat Gadd

🐛 💻

Brad Davies

🐛 💻

Rafael Câmara

💻

Gleb Bahmutov

⚠️ 🔧

Iván Munguía

💻

Dillon Mulroy

💻

Nihad Abbasov

💻

Bruno C. Couto

💻

Mark Molnar

💻

Takahiko Inayama

💻

François Martin

💻

Raphael Amorim

💻

Camron Flanders

💻

Eric Adamski

💻

Winner Crespo

💻 🎨

Milos

💻 🔧 📖 🌍

Yashu Mittal

💻

Rachel M. Carmena

📖

Miguel Salazar

📖 🌍

Vyom Jain

📖 🌍

racaljk

🌍

Sean

💻

Izabela Borges

🌍

Shinil M S

🌍

Berke Atac

🌍

LEE YONGJUN

🌍

Matthew Nielsen

💻

Boy

📦

Vetrivel Chinnasamy

🌍

Farzad YZ

💻 🤔

Yannick Loriot

🌍

Joel Hanson

💻

Muhammad Muzzammil

💻

souppower

🚇

Masato Urai (@uraway_)

🌍

Fernando

🌍

Megha Sachdev

💻 ⚠️

Anudeep Reddy

🚇

Munieru

🌍

Adam Lusted

💻

Jose Noriega

🌍

Merlin Fuchs

🌍

Ramy Majouji

💻

Viktor Nemes

💻

Eric Bailey

💻

Nazeefa

🌍

Pratik Butani

📝

Bakti Aditya

💻

Caleb Taylor

💻

Rogério Munhoz

💻

Technoknol

💻

Tymoteusz Makowski

💻

Nisar Hassan Naqvi

🐛

Ilyas Karim

🐛

Nick Fix

🤔

Melanie Sumner

🤔

aluc

💻

B. Mearns

🤔

Peng Jie

💻

Binyamin Aron Green

💻

Michal

🌍

Quinn Blenkinsop

💻

Dwiferdio Seagal Putra

💻

Ashley Woodall Clark

💻

Tim Wienk

🌍

George McCarron

📖

Erwin Rahayu

🌍 📖

Luca

💻

Andrew Hayes

💻

Bereket Semagn

💻

Lorenzo Lancia

🌍

Guy Adler

🌍

Dan Bamikiya

🤔

kewang

🌍

Rizda Dwi Prasetya

🖋

AbreuY

🌍

>_Rizky.dev

🌍 📖

Abidemi Harry

💻

Marco

🌍

Sam Robbins

📖

alceil

💻

hatsu

💻

Praveen Kumar Purushothaman

🌍

Amir Elsagan

🌍

korzck

🌍

Sakibul Alam

🌍