.\" Copyright (c) 2010-2016 Florian Pritz, bluewind at xinu.at .\" 2011 Moritz Wilhelmy, mw at wzff.de .\" .\" Licensed under GPLv3 .\" (see COPYING for full license text) .\" .Dd April 11, 2016 .Dt FB 1 .Os .Sh "نام (NAME)" .Nm fb .Nd کلاینتی برای https://paste.xinu.at .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Op options .Ar file|directory|id://ID|URL ... .Nm .Op Fl dg .Op options .Ar ID|URL ... .Nm .Op Fl hv .Sh "توضیحات (DESCRIPTION)" .Nm کلاینتی برای https://paste.xinu.at است که به کاربر امکان می‌دهد به سادگی فایل‌ها را بارگذاری، حذف یا بارگیری کند. به‌طور پیش‌فرض، فایل‌ها همان‌گونه که هستند بارگذاری می‌شوند و پس از هر بارگذاری پیوندی به فایل در خروجی استاندارد چاپ می‌شود. اگر چند فایل بارگذاری شوند، یک پیوند چندگانه (multipaste - گزینه .Fl -multipaste را ببینید) به صورت خودکار ایجاد خواهد شد. .Pp دایرکتوری‌ها به صورت یک فایل فشرده تاربال بسته‌بندی شده و فایل حاصل با نام .Pa upload.tar بارگذاری می‌شود. اگر هیچ آرگومانی داده نشود، داده‌ها از ورودی استاندارد (stdin) در یک فایل موقت خوانده شده و به محض دریافت انتهای فایل (EOF) بارگذاری می‌شوند. اگر فایلی که بارگذاری می‌شود بزرگتر از 10MiB باشد، .Nm حداکثر اندازه مجاز بارگذاری را از سرور استعلام می‌کند و در صورت عدم پذیرش، بارگذاری را لغو می‌نماید. .Pp پیش از پایان کار، .Nm تلاش می‌کند تا تمام پیوندها را در کلیپ‌بورد کپی کند. این کار به محیطی که .Nm در آن اجرا شده بستگی دارد. اگر می‌خواهید این ویژگی کار کند، باید ابزار مناسب محیط خود را نصب کنید: .Bl -tag -width "wl-clipboard(1)" -offset indent .It Xr xclip 1 هنگام اجرا در X11 .It Xr wl-clipboard 1 هنگام اجرا در Wayland .It Xr pbcopy 1 هنگام اجرا در Mac OS / Darwin .El .Pp اگر می‌خواهید از paste.xinu.at استفاده کنید، باید در آن حساب کاربری ایجاد کرده و سپس دستور .Sq Nm Fl a را اجرا کنید تا کلید API ساخته شود. .Pp شناسه‌های (ID) پیوندهای موجود را می‌توان به صورت URL اشاره‌کننده به آن پیوند یا با افزودن پیشوند "id://" به شناسه مشخص کرد. .Sh "گزینه‌ها (OPTIONS)" .Bl -tag -width Ds .It Fl c, -compress فشرده‌سازی فایل‌های ارسالی با استفاده از .Xr gzip 1 . این مورد بر روی تمام فایل‌ها از جمله محتوای پایپ‌شده و دایرکتوری‌ها اعمال می‌شود. اگر دو بار مشخص شود، به جای gzip از .Xr xz 1 استفاده خواهد شد. اگر همراه با گزینه -g استفاده شود، داده‌های بارگیری‌شده را قبل از چاپ در خروجی استاندارد از حالت فشرده خارج می‌کند. .It Fl d, -delete حذف شناسه‌ها. در این حالت دیگر نمی‌توانید فایلی بارگذاری کنید. اگر آرگومان یک URL باشد، .Nm تلاش می‌کند شناسه را از آن استخراج کند. این گزینه شناسه‌ها را بدون پیشوند "id://" نیز می‌پذیرد. .It Fl -config Ar استفاده از یک فایل پیکربندی جایگزین. مقدار پیش‌فرض "$XDG_CONFIG_HOME/fb-client/config" است. .It Fl e Ar extension, Fl -extension Ar extension تغییر پسوند مورد استفاده برای رنگ‌آمیزی دستورها (Syntax Highlighting). همچنین در صورتی که فایل را قبلاً بارگذاری کرده‌اید، می‌توانید این کار را با افزودن پسوند به انتهای URL انجام دهید. آدرس https://paste.xinu.at//bash نحوه نمایش را به bash تغییر می‌دهد. .It Fl n Ar , Fl -name Ar استفاده از نام فایل مشخص‌شده برای بارگذاری در هنگام ارسال از ورودی استاندارد (stdin). پیش‌فرض "stdin" است. .It Fl a, -create-apikey ایجاد کلید API جدید. نام کاربری و گذرواژه پرسیده می‌شود. .It Fl H, -history نمایش تاریخچه بارگذاری‌ها. .It Fl g, -get بارگیری شناسه‌ها و نمایش در خروجی استاندارد. لطفاً هنگام استفاده از این گزینه احتیاط کنید، زیرا داده‌های باینری در صورت ارسال مستقیم به ترمینال ممکن است رفتارهای غیرمنتظره‌ای ایجاد کنند. در این حالت دیگر نمی‌توانید فایلی بارگذاری کنید. اگر آرگومان یک URL باشد، .Nm تلاش می‌کند شناسه را استخراج کند. این گزینه شناسه‌ها را بدون پیشوند "id://" نیز می‌پذیرد. .It Fl m, -multipaste ایجاد پیوند چندگانه (multipaste) از شناسه‌ها/فایل‌ها/دایرکتوری‌ها/آدرس‌های وب. این گزینه فایل‌ها را مانند حالت معمول بارگذاری می‌کند، اما سپس یک پیوند چندگانه ترکیبی از همه آنها ایجاد می‌نماید. آدرس‌هایی که با URL این پیست‌بین شروع می‌شوند شناسه‌شان استخراج شده و بارگیری نخواهند شد. تنها URL پیوند چندگانه نمایش داده شده و در کلیپ‌بورد کپی می‌شود. این گزینه در صورتی که چندین فایل بارگذاری شوند به صورت خودکار فعال می‌گردد. .It Fl M Ar , Fl -min-id-length Ar درخواست از سرور برای ایجاد شناسه‌هایی با حداقل طول نویسه. حداقل طول پشتیبانی‌شده دو نویسه است. .It Fl h, -help نمایش یک پیام راهنمای کوتاه. .It Fl t, -tar بارگذاری یک فایل tar شامل تمام فایل‌ها و دایرکتوری‌های مشخص‌شده در خط فرمان. نام فایل را می‌توان با گزینه -n مشخص کرد (هیچ پسوندی اضافه نکنید). .It Fl v, -version نمایش نسخه کلاینت. .It Fl D, -debug نمایش اطلاعات خطایابی. .El .Sh "فایل‌های پیکربندی (CONFIGURATION FILES)" .Bl -tag .It $XDG_CONFIG_HOME/fb-client/apikey این فایل شامل کلید API مورد استفاده برای احراز هویت است. .It $XDG_CONFIG_HOME/fb-client/config این فایل اجازه می‌دهد برخی متغیرها را با قالب 'option_name="value"' بازنویسی کنید. هم مقدار و هم نام گزینه، رشته‌هایی حساس به حروف کوچک و بزرگ هستند. می‌توان متغیرهای محیطی را با استفاده از نحو $VARIABLE_NAME در مقدار قرار داد. .Pp نام گزینه‌های زیر پشتیبانی می‌شوند: .Bl -tag .It pastebin آدرس URL پیست‌بینی که می‌خواهید استفاده کنید. .It clipboard_cmd دستور مورد استفاده برای کپی کردن آدرس فایل‌های بارگذاری‌شده در کلیپ‌بورد. پیش‌فرض در X11 برابر با .Xr xclip 1 ، در Wayland برابر با .Xr wl-copy 1 و در Mac OS / Darwin برابر با .Xr pbcopy 1 است. .It clipboard_target پیکربندی کلیپ‌بورد مورد استفاده. مقادیر مجاز: .Bl -tag -width "none / off" .It default استفاده از رفتار پیش‌فرض، یعنی "primary" برای X11/xclip و "clipboard" برای Wayland/wl-copy. اگر مشخص نشود، به صورت ضمنی پیش‌فرض همین است. .It none / off غیرفعال کردن کپی آدرس بارگذاری در کلیپ‌بورد. .It primary اجبار کپی در بخش انتخابی "primary" (برای Wayland/wl-copy). .It clipboard اجبار کپی در بخش انتخابی "clipboard" (برای X11/xclip). .El .It apikey_file فایلی که شامل کلید API است. مقدار پیش‌فرض "$XDG_CONFIG_HOME/fb-client/apikey" است. .El .El .Sh "محیط (ENVIRONMENT)" برخی گزینه‌ها را می‌توان با تغییر متغیرهای محیطی دگرگون ساخت: .Bl -tag -width XZ_OPTS .It Ev GZIP مقداردهی به GZIP باعث می‌شود برنامه gzip با مقدار آن طوری رفتار کند که گویی به خط فرمان اضافه شده است. .It Ev XZ_OPTS متغیر محیطی XZ_OPTS را می‌توان برای ارسال گزینه‌های اضافی به xz در صورتی که xz برای فشرده‌سازی استفاده شود به کار برد. .It TMPDIR تنظیم TMPDIR به یک دایرکتوری باعث می‌شود .Nm فایل‌های موقت را درون آن دایرکتوری ایجاد کند نه در مسیر پیش‌فرض سیستم. .El .Sh "مثال‌ها (EXAMPLES)" .Bl -tag .It Nm Fl tc Ar directory file یک آرشیو .tar حاوی دایرکتوری و فایل ایجاد کرده، آن را با gzip فشرده می‌کند و به صورت یک آرشیو بارگذاری می‌نماید. .It Nm Fl c Ar directory file یک آرشیو .tar فقط حاوی دایرکتوری ایجاد می‌کند. هر دو (دایرکتوری و فایل) با gzip فشرده شده و به طور مستقل بارگذاری می‌شوند. .It Nm Fl cc Ar directory یک آرشیو .tar فقط حاوی دایرکتوری ایجاد کرده و آن را با xz فشرده می‌کند. .It Nm Ar id://1bAc directory file https://paste.xinu.at/42SomeID http://example.com/example.png یک پیوند چندگانه حاوی پیست موجود با شناسه 1bAc، تاربال دایرکتوری، فایل، پیست موجود 42SomeID و فایل example.png ایجاد می‌کند که توسط کلاینت بارگیری شده و سپس به سرور ارسال می‌شود. .It Ic make \&|\&& Nm خروجی دستور make (شامل خروجی استاندارد و خطای استاندارد) را در csh و پوسته‌های مشابه بارگذاری می‌کند. .El .Sh "همچنین ببینید (SEE ALSO)" .Xr curl 1 , .Xr gzip 1 , .Xr tar 1 , .Xr xz 1 , .Xr xclip 1 .Sh "نویسندگان (AUTHORS)" .An -nosplit .Nm توسط افراد زیر نوشته شده است: .Bl -bullet -compact .It .\" mdoc has clever spam protection ;) .An Florian Pritz Aq bluewi\&nd@xinu.at .It .An Moritz Wilhelmy Aq mor\&itz@wzff.de .El و تحت شرایط GPLv3 قابل بازتوزیع است.