GIST(1) راهنمای Gist GIST(1) نام (NAME) gist - بارگذاری و مدیریت Gistهای گیت‌هاب از خط فرمان خلاصه دستور (SYNOPSIS) جم gist دستوری با نام gist در اختیارتان می‌گذارد که با آن می‌توانید از خط فرمان خود، محتوا را در https://gist.github.com بارگذاری کنید. نصب (INSTALLATION) • اگر روبی (Ruby) را نصب دارید: gem install gist • اگر از Bundler استفاده می‌کنید: source :rubygems gem 'gist' • در سیستم‌عامل OS X، ابزار gist در Homebrew موجود است: brew install gist • در سیستم‌عامل FreeBSD، ابزار gist در مخزن ports موجود است: pkg install gist • برای اوبونتو و دبیان: apt install gist نکته: دبیان برای جلوگیری از تداخل نام، نام فایل اجرایی را به gist-paste تغییر داده است. دستورات و کاربرد (COMMAND) • برای بارگذاری محتوای فایل a.rb کافی است اجرا کنید: gist a.rb • بارگذاری چند فایل: gist a b c gist *.rb • به‌طور پیش‌فرض محتوا از ورودی استاندارد (STDIN) خوانده می‌شود و می‌توانید با گزینه -f نام فایلی برای آن تعیین کنید: gist -f test.rb ~/.gist) استفاده از umask تضمین می‌کند که این فایل تنها از طریق حساب کاربری خود شما قابل دسترسی است. گیت‌هاب سازمانی (GitHub Enterprise) اگر می‌خواهید gist از نسخه محلی GitHub Enterprise نصب‌شده شما در https://enterprise.github.com استفاده کند، باید متغیر محیطی GITHUB_URL را صادر (export) کنید (معمولاً در فایل ~/.bashrc شما انجام می‌شود). export GITHUB_URL=http://github.internal.example.com/ پس از انجام این کار و راه‌اندازی مجدد ترمینال (یا اجرای source ~/.bashrc)، ابزار gist به‌طور خودکار به جای github.com عمومی از GitHub Enterprise استفاده خواهد کرد. توکن شما برای GitHub Enterprise به جای ~/.gist در مسیری مانند .gist..[.] (برای مثال ~/.gist.http.github.internal.example.com برای متغیر GITHUB_URL بالا) ذخیره خواهد شد. اگر چندین سرور دارید یا به تناوب از نسخه سازمانی و گیت‌هاب عمومی استفاده می‌کنید، می‌توانید با ساخت اسکریپت‌هایی که متغیر محیطی را تنظیم کرده و سپس gist را اجرا می‌کنند این کار را مدیریت کنید. به یاد داشته باشید که برای استفاده از گیت‌هاب عمومی باید مقدار این متغیر محیطی را پاک کنید. صرفاً تنظیم آن روی نشانی عمومی کار نخواهد کرد؛ از دستور unset GITHUB_URL استفاده کنید. قالب فایل توکن (Token file format) اگر نمی‌توانید از گذرواژه استفاده کنید (همانند اغلب نسخه‌های Enterprise)، می‌توانید توکن را از طریق رابط وب ایجاد کرده و سپس رشته آن را در فایل مربوطه ذخیره کنید. از قرار دادن شکست‌های خطی اضافه خودداری کنید، در غیر این صورت ممکن است با خطای زیر روبرو شوید: $ gist -l Error: Bad credentials همچنین می‌توانید از Gist به‌عنوان یک کتابخانه در داخل کدهای روبی (Ruby) خود استفاده کنید: اگر به قابلیت‌های پیشرفته‌تری نیاز دارید، می‌توانید این پارامترها را نیز ارسال کنید: • :access_token برای احراز هویت با استفاده از OAuth2 (پیش‌فرض مقدار `File.read("~/.gist")) است). • :filename برای تغییر برجسته‌سازی نحوی (Syntax Highlighting) فایل (پیش‌فرض a.rb است). • :public اگر می‌خواهید Gist شما دارای نشانی قابل حدس زدن (عمومی) باشد. • :description برای افزودن توضیحات به Gist شما. • :update برای به‌روزرسانی یک Gist موجود (می‌تواند یک URL یا یک شناسه باشد). • :copy برای کپی کردن نشانی اینترنتی حاصل در کلیپ‌بورد (پیش‌فرض false است). • :open برای باز کردن نشانی اینترنتی حاصل در یک مرورگر (پیش‌فرض false است). نکته: مقدار access_token باید دارای محدوده دسترسی (scope) gist باشد و همچنین ممکن است به محدوده user:email نیاز داشته باشد. • اگر می‌خواهید چند فایل را درون یک Gist بارگذاری کنید: Gist.multi_gist("a.rb" => "Foo.bar", "a.py" => "Foo.bar") • اگر ترجیح می‌دهید از access_token داخلی gist استفاده کنید، می‌توانید با فراخوانی دستور زیر کاربر را وادار به دریافت توکن کنید: Gist.login! • این کار کاربر را از طریق فرآیند دریافت توکن OAuth2 هدایت کرده و آن را در ~/.gist ذخیره می‌کند؛ جایی که بعداً توسط Gist.gist قابل خواندن خواهد بود. پیکربندی (CONFIGURATION) • اگر می‌خواهید گزینه‌های -o یا -c هنگام اجرای برنامه gist به‌طور پیش‌فرض فعال باشند، یک نام مستعار (alias) به فایل ~/.bashrc (یا معادل آن) اضافه کنید. برای نمونه: alias gist='gist -c' • اگر ترجیح می‌دهید gist مرورگر متفاوتی را باز کند، می‌توانید متغیر محیطی BROWSER را صادر کنید: export BROWSER=google-chrome اگر یکپارچه‌سازی کلیپ‌بورد یا مرورگر در پلتفرم شما به درستی کار نمی‌کند، لطفاً یک گزارش باگ یا ترجیحاً یک Pull Request ارسال کنید. اگر برای دسترسی به اینترنت نیاز به استفاده از یک پروکسی HTTP دارید، متغیر محیطی HTTP_PROXY یا http_proxy را صادر (export) کنید تا gist از آن استفاده کند. درباره و نویسندگان (AUTHORS) با تشکر از @defunkt و @indirect برای نگارش و نگهداری نسخه‌های ۱ تا ۳. با تشکر از @rking و @ConradIrwin برای نگهداری نسخه ۴. تحت مجوز MIT منتشر شده است. گزارش اشکالات و دریافت Pull Requestها با استقبال پذیرفته می‌شود. July 2026 GIST(1)