نام (NAME)

rofimoji - ابزار انتخاب ایموجی و نویسه‌های عمومی برای rofi و ابزارهای مشابه

خلاصه دستور (SYNOPSIS)

rofimoji [-h] [--version] [--action {type,copy,clipboard,type-numerical,unicode,copy-unicode,print,menu}] [--skin-tone {neutral,light,medium-light,moderate,dark brown,black,ask}] [--files {all,FILE [FILE ...]]} [--prompt PROMPT] [--selector-args SELECTOR_ARGS] [--max-recent MAX_RECENT] [--no-frecency] [--hidden-descriptions] [--clipboarder CLIPBOARDER] [--typer TYPER] [--selector SELECTOR]

توضیحات (DESCRIPTION)

انتخاب، درج یا کپی نویسه‌های یونیکد مانند ایموجی با استفاده از rofi.

گزینه‌ها (OPTIONS)

-h, --help: نمایش اطلاعات مختصر نحوه استفاده.
--version: نمایش شماره نسخه برنامه و خروج.
--action, -a: مقادیر مجاز: type، copy، clipboard، type-numerical، unicode، copy-unicode، print، menu

انتخاب عملیات بر روی نویسه‌های انتخاب‌شده: تایپ مستقیم آن‌ها با "Typer"، کپی در کلیپ‌بورد با استفاده از "Clipboarder"، یا درج غیرمستقیم با استفاده از کلیپ‌بورد. برای استفاده از قابلیت کلید compose، مقدار "type-numerical" را انتخاب کنید. مقدار "unicode" کدهای یونیکد نویسه‌های انتخاب‌شده را تایپ می‌کند و "copy-unicode" آن را کپی می‌کند. مقدار "print" نویسه‌ها را صرفاً در خروجی استاندارد چاپ می‌کند.
اگر می‌خواهید در همان لحظه تصمیم بگیرید، از "menu" استفاده کنید.

--files FILE [FILE ...], -f FILE [FILE ...]: خواندن نویسه‌ها از این فایل (یا این فایل‌ها)، یک ورودی در هر خط. مسیرهای مطلق و نسبی، و همچنین الگوهای تطبیق فایل (globbing) پشتیبانی می‌شوند (--files /home/you/characters.csv ../other*.csv).

برای فایل‌های نویسه داخلی و تمام فایل‌های موجود در ${XDG_DATA_HOME}/rofimoji/data، تنها ذکر نام فایل بدون پسوند کافی است (--files musical_symbols supplemental_arrows). در اینجا نیز globbing پشتیبانی شده و به صورت پیش‌فرض انجام می‌شود.

در فایل پیکربندی، چندین فایل باید به شکل files=[_FILE_, _FILE_] فهرست شوند.

--skin-tone=skin-tone, -s skin-tone: مقادیر مجاز: neutral، light، medium-light، moderate، dark brown، black، ask

تعیین رنگ پوست (skin-tone) برای تمام ایموجی‌های پشتیبانی‌شده. در صورت عدم
تنظیم (یا تنظیم روی "ask")، برای هر مورد از شما سؤال خواهد شد.

--max-recent MAX-RECENT: نمایش حداکثر این تعداد از نویسه‌های اخیراً استفاده‌شده (نمی‌تواند بزرگ‌تر از ۱۰ باشد).
--no-frecency: عدم نمایش نویسه‌های پرتکرار در ابتدای فهرست.
--hidden-descriptions: تنها فهرست کردن نویسه‌ها بدون نمایش توضیحات آن‌ها. توجه داشته باشید که همچنان می‌توانید در توضیحات جستجو کنید. صرفاً برای rofi استفاده می‌شود.
--use-icons: نمایش نویسه‌ها به صورت آیکون در rofi. در سایر انتخاب‌گرها استفاده نمی‌شود.
--prompt PROMPT, -r PROMPT: تنظیم اعلان (prompt) برنامه rofimoji
--selector-args SELECTOR-ARGS: رشته‌ای از آرگومان‌ها برای ارسال به انتخاب‌گر (selector).
--selector SELECTOR: مقادیر مجاز: rofi، wofi، fuzzel، bemenu، tofi، dmenu، wmenu، choose، hyprlauncher

انتخاب دستی برنامه انتخاب‌گر (selector). معمولاً `rofi`، اما می‌توانید برنامه دیگری را مشخص کنید.

--clipboarder CLIPBOARDER: مقادیر مجاز: xsel، xclip، wl-copy، pbcopy

انتخاب دستی برنامه دسترسی به کلیپ‌بورد.

--typer TYPER: مقادیر مجاز: xdotool، wtype، ydotool، cliclick، wl-ime-type

انتخاب دستی برنامه تایپ خودکار نویسه‌ها.

--keybinding-copy, --keybinding-type, --keybinding-clipboard, --keybinding-unicode, --keybinding-copy-unicode: تعریف کلیدهای میانبر متفاوت برای این عملیات‌ها.

کلیدهای میانبر (KEYBINDINGS)

(اختیاری) انتخاب چندگانه ایموجی با shift+enter

enter برای درج مستقیم ایموجی

alt+c برای کپی آن در کلیپ‌بورد

alt+t برای تایپ مستقیم آن

alt+p برای درج با استفاده از کلیپ‌بورد

alt+1، alt+2 برای درج نویسه‌ای که اخیراً استفاده شده است (alt+2 برای دومین نویسه اخیر و به همین ترتیب)

alt+u برای درج کد یونیکد (Unicode codepoint)

alt+i برای کپی کد یونیکد در کلیپ‌بورد

لطفاً توجه داشته باشید که wofi به جز enter از کلیدهای میانبر دیگر پشتیبانی نمی‌کند.

فایل‌ها (FILES)

~/.config/rofimoji.rc: فایل پیکربندی اختصاصی کاربر.
/etc/xdg/xdg-i3/rofimoji.rc: فایل پیکربندی سراسری سیستم.
~/.local/share/rofimoji/recent: ذخیره‌سازی نویسه‌های اخیراً استفاده‌شده.
~/.local/share/rofimoji/data/filename.additional.csv: شامل نویسه‌های تکمیلی یا توضیحات اضافی برای مجموعه نویسه‌های موجود در filename

پیکربندی (CONFIGURATION)

آرگومان‌هایی که با “--” شروع می‌شوند (مانند --version) را می‌توان در یک فایل پیکربندی نیز تنظیم کرد.

نحو (syntax) فایل پیکربندی موارد زیر را مجاز می‌داند: key=value، flag=true، stuff=[a,b,c] (برای جزئیات بیشتر، ساختار نحو را در https://github.com/fdw/rofimoji#example-config-file مشاهده کنید). اگر یک آرگومان در بیش از یک مکان مشخص شده باشد، مقادیر خط فرمان بر مقادیر فایل پیکربندی اولویت خواهند داشت.

وبگاه (WEBSITE)

https://github.com/fdw/rofimoji

نویسندگان (AUTHORS)

Fabian Winter.