.\" Automatically generated by Pandoc 2.5 .\" .TH "TRANS" "1" "2023\-02\-08" "0.9.7.1" "" .hy .SH "نام (NAME)" .PP trans \- مترجم خط فرمان با استفاده از Google Translate، Bing Translator، Yandex.Translate و غیره .SH "خلاصه دستور (SYNOPSIS)" .PP \f[B]trans\f[R] [\f[I]OPTIONS\f[R]] [\f[I]SOURCE\f[R]]:[\f[I]TARGETS\f[R]] [\f[I]TEXT\f[R]]... .SH "توضیحات (DESCRIPTION)" .PP این ابزار متن را از طریق خط فرمان و با استفاده از یک موتور ترجمه نظیر Google Translate، Bing Translator و Yandex.Translate به هر زبانی ترجمه می‌کند. .PP هر آرگومانی که یک گزینهٔ معتبر نباشد، به‌عنوان \f[I]TEXT\f[R] برای ترجمه در نظر گرفته می‌شود. .PP اگر نه \f[I]TEXT\f[R] و نه فایل ورودی از طریق آرگومان‌های خط فرمان مشخص نشده باشند، برنامه ورودی را از ورودی استاندارد (standard input) خوانده و ترجمه می‌کند. .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های اطلاعاتی (Information options)" .TP .B \f[B]\-V\f[R], \f[B]\-version\f[R] چاپ نسخه و خروج. .TP .B \f[B]\-H\f[R], \f[B]\-help\f[R] چاپ پیام راهنما و خروج. .TP .B \f[B]\-M\f[R], \f[B]\-man\f[R] نمایش صفحهٔ راهنما (man page) و خروج. .TP .B \f[B]\-T\f[R], \f[B]\-reference\f[R] چاپ جدول مرجع تمام زبان‌ها و کدهای پشتیبانی‌شده و خروج. نام زبان‌ها به زبان بومی خودشان (endonyms) نمایش داده می‌شود. .TP .B \f[B]\-R\f[R], \f[B]\-reference\-english\f[R] چاپ جدول مرجع تمام زبان‌ها و کدهای پشتیبانی‌شده و خروج. نام زبان‌ها به انگلیسی نمایش داده می‌شود. .TP .B \f[B]\-S\f[R], \f[B]\-list\-engines\f[R] فهرست کردن موتورهای ترجمهٔ موجود و خروج. .TP .B \f[B]\-list\-languages\f[R] فهرست کردن تمام زبان‌های پشتیبانی‌شده (با نام بومی خودشان) و خروج. .TP .B \f[B]\-list\-languages\-english\f[R] فهرست کردن تمام زبان‌های پشتیبانی‌شده (با نام انگلیسی) و خروج. .TP .B \f[B]\-list\-codes\f[R] فهرست کردن تمام کدهای پشتیبانی‌شده و خروج. .TP .B \f[B]\-list\-all\f[R] فهرست کردن تمام زبان‌های پشتیبانی‌شده (نام‌های بومی و نام‌های انگلیسی) و کدها، و خروج. .TP .B \f[B]\-L\f[R] \f[I]CODES\f[R], \f[B]\-linguist\f[R] \f[I]CODES\f[R] چاپ جزئیات زبان‌ها و خروج. هنگام مشخص کردن دو یا چند کد زبان، آن‌ها را با علامت جمع \[dq]+\[dq] به یکدیگر متصل کنید. .TP .B \f[B]\-U\f[R], \f[B]\-upgrade\f[R] بررسی برای ارتقای این برنامه. .SS "گزینه‌های مترجم (Translator options)" .TP .B \f[B]\-e\f[R] \f[I]ENGINE\f[R], \f[B]\-engine\f[R] \f[I]ENGINE\f[R] مشخص کردن موتور ترجمه برای استفاده. (پیش‌فرض: auto) .SS "گزینه‌های نمایش (Display options)" .TP .B \f[B]\-verbose\f[R] حالت پرگو (پرحاشیه). .RS .PP نمایش متن اصلی و مرتبط‌ترین ترجمهٔ آن، سپس علائم آوانگاری آن (در صورت وجود)، سپس ترجمه‌های جایگزین آن (در صورت وجود) یا تعریف آن در لغت‌نامه (اگر یک واژه باشد). .PP این گزینه در بیشتر موارد غیرضروری است زیرا حالت پرگو به‌طور پیش‌فرض فعال است. .RE .TP .B \f[B]\-b\f[R], \f[B]\-brief\f[R] حالت مختصر. .RS .PP تنها مرتبط‌ترین ترجمه یا علائم آوانگاری آن نمایش داده می‌شود. .RE .TP .B \f[B]\-d\f[R], \f[B]\-dictionary\f[R] حالت لغت‌نامه. .RS .PP نمایش تعریف واژهٔ اصلی در لغت‌نامه. .RE .TP .B \f[B]\-identify\f[R] شناسایی زبان. .RS .PP نمایش زبان شناسایی‌شدهٔ متن اصلی. .RE .TP .B \f[B]\-show\-original\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن متن اصلی. (پیش‌فرض: yes) .TP .B \f[B]\-show\-original\-phonetics\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن علائم آوانگاری متن اصلی. (پیش‌فرض: yes) .TP .B \f[B]\-show\-translation\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن ترجمه. (پیش‌فرض: yes) .TP .B \f[B]\-show\-translation\-phonetics\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن علائم آوانگاری ترجمه. (پیش‌فرض: yes) .TP .B \f[B]\-show\-prompt\-message\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن پیام اعلان (prompt). (پیش‌فرض: yes) .TP .B \f[B]\-show\-languages\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن زبان‌های مبدأ و مقصد. (پیش‌فرض: yes) .TP .B \f[B]\-show\-original\-dictionary\f[R] \f[I]y/N\f[R] نمایش دادن یا ندادن مدخل لغت‌نامه برای متن اصلی. (پیش‌فرض: no) .RS .PP این گزینه در حالت لغت‌نامه فعال است. .RE .TP .B \f[B]\-show\-dictionary\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن مدخل لغت‌نامه برای ترجمه. (پیش‌فرض: yes) .TP .B \f[B]\-show\-alternatives\f[R] \f[I]Y/n\f[R] نمایش دادن یا ندادن ترجمه‌های جایگزین. (پیش‌فرض: yes) .TP .B \f[B]\-w\f[R] \f[I]NUM\f[R], \f[B]\-width\f[R] \f[I]NUM\f[R] مشخص کردن عرض صفحه برای فاصله‌گذاری (padding). .RS .PP این گزینه تنظیمات متغیر محیطی $\f[B]COLUMNS\f[R] را بازنویسی می‌کند. .RE .TP .B \f[B]\-indent\f[R] \f[I]NUM\f[R] مشخص کردن اندازهٔ تورفتگی (تعداد فاصله‌ها). (پیش‌فرض: 4) .TP .B \f[B]\-theme\f[R] \f[I]FILENAME\f[R] مشخص کردن پوسته برای استفاده. (پیش‌فرض: default) .TP .B \f[B]\-no\-theme\f[R] عدم استفاده از هر پوسته‌ای به‌جز پیش‌فرض. .TP .B \f[B]\-no\-ansi\f[R] عدم استفاده از کدهای اسکیپ ANSI. .TP .B \f[B]\-no\-autocorrect\f[R] عدم تصحیح خودکار. (در صورتی که توسط موتور ترجمه به‌طور پیش‌فرض فعال شده باشد) .TP .B \f[B]\-no\-bidi\f[R] عدم تبدیل متون دوجهته (bidirectional). .TP .B \f[B]\-bidi\f[R] همیشه متون دوجهته تبدیل شوند. .TP .B \f[B]\-no\-warn\f[R] پیام‌های هشدار در خروجی خطای استاندارد (stderr) نوشته نشوند..TP .B \f[B]\-dump\f[R] در عوض، پاسخ خام API را چاپ می‌کند. .SS "گزینه‌های صوتی" .TP .B \f[B]\-p\f[R], \f[B]\-play\f[R] شنیدن ترجمه. .RS .PP برای پخش جریانی از موتور Google Text\-to\-Speech، باید حداقل یکی از پخش‌کننده‌های صوتی پشتیبانی‌شده (\f[B]mplayer\f[R]، \f[B]mpv\f[R] یا \f[B]mpg123\f[R]) نصب باشد. در غیر این صورت، ممکن است در عوض از یک ترکیب‌کننده گفتار محلی استفاده شود (\f[B]say\f[R] در macOS، و \f[B]espeak\f[R] در Linux یا سایر بسترها). .RE .TP .B \f[B]\-speak\f[R] شنیدن متن اصلی. .TP .B \f[B]\-n\f[R] \f[I]VOICE\f[R], \f[B]\-narrator\f[R] \f[I]VOICE\f[R] مشخص کردن راوی و شنیدن ترجمه. .RS .PP مقدارهای متداول برای این گزینه \f[B]male\f[R] و \f[B]female\f[R] هستند. .RE .TP .B \f[B]\-player\f[R] \f[I]PROGRAM\f[R] مشخص کردن پخش‌کننده صوتی مورد استفاده و شنیدن ترجمه. .RS .PP گزینه \f[B]\-play\f[R] به‌طور پیش‌فرض تلاش خواهد کرد از \f[B]mplayer\f[R]، \f[B]mpv\f[R] یا \f[B]mpg123\f[R] استفاده کند، زیرا عملکرد این پخش‌کننده‌ها برای نشانی‌های پخش جریانی شناخته شده است. همه پخش‌کننده‌های صوتی خط فرمان نمی‌توانند به این شکل کار کنند. تنها زمانی از این گزینه استفاده کنید که اولویت خاص خودتان را داشته باشید. .PP این گزینه بر تنظیم متغیر محیطی $\f[B]PLAYER\f[R] اولویت دارد. .RE .TP .B \f[B]\-no\-play\f[R] گوش ندادن به ترجمه. .TP .B \f[B]\-no\-translate\f[R] هنگام استفاده از \-speak چیزی ترجمه نشود. .TP .B \f[B]\-download\-audio\f[R] بارگیری صدا در دایرکتوری جاری. .TP .B \f[B]\-download\-audio\-as\f[R] \f[I]FILENAME\f[R] بارگیری صدا در فایل مشخص‌شده. .SS "گزینه‌های صفحه‌بندی ترمینال و مرور" .TP .B \f[B]\-v\f[R], \f[B]\-view\f[R] مشاهده ترجمه در یک صفحه‌بند ترمینال (\f[B]less\f[R]، \f[B]more\f[R] یا \f[B]most\f[R]). .TP .B \f[B]\-pager\f[R] \f[I]PROGRAM\f[R] مشخص کردن صفحه‌بند ترمینال مورد استفاده و مشاهده ترجمه. .RS .PP این گزینه بر تنظیم متغیر محیطی $\f[B]PAGER\f[R] اولویت دارد. .RE .TP .B \f[B]\-no\-view\f[R], \f[B]\-no\-pager\f[R] ترجمه در صفحه‌بند ترمینال نمایش داده نشود. .TP .B \f[B]\-browser\f[R] \f[I]PROGRAM\f[R] مشخص کردن مرورگر وب مورد استفاده. .RS .PP این گزینه بر تنظیم متغیر محیطی $\f[B]BROWSER\f[R] اولویت دارد. .RE .TP .B \f[B]\-no\-browser\f[R] مرورگر وب باز نشود. .SS "گزینه‌های شبکه" .TP .B \f[B]\-x\f[R] \f[I]HOST:PORT\f[R], \f[B]\-proxy\f[R] \f[I]HOST:PORT\f[R] استفاده از پراکسی HTTP روی درگاه مشخص‌شده. .RS .PP این گزینه بر تنظیم متغیرهای محیطی $\f[B]HTTP_PROXY\f[R] و $\f[B]http_proxy\f[R] اولویت دارد. .RE .TP .B \f[B]\-u\f[R] \f[I]STRING\f[R], \f[B]\-user\-agent\f[R] \f[I]STRING\f[R] مشخص کردن رشته User\-Agent برای شناسایی. .RS .PP این گزینه بر تنظیم متغیر محیطی $\f[B]USER_AGENT\f[R] اولویت دارد. .RE .TP .B \f[B]\-4\f[R], \f[B]\-ipv4\f[R], \f[B]\-inet4\-only\f[R] اتصال فقط به نشانی‌های IPv4. .TP .B \f[B]\-6\f[R], \f[B]\-ipv6\f[R], \f[B]\-inet6\-only\f[R] اتصال فقط به نشانی‌های IPv6..SS "گزینه‌های پوسته تعاملی (Interactive shell options)" .TP .B \f[B]\-I\f[R], \f[B]\-interactive\f[R], \f[B]\-shell\f[R] شروع یک پوستهٔ تعاملی، با فراخوانی \f[B]rlwrap\f[R] در هر زمان که ممکن باشد (مگر اینکه \f[B]\-no\-rlwrap\f[R] مشخص شده باشد). .TP .B \f[B]\-E\f[R], \f[B]\-emacs\f[R] راه‌اندازی پیشانهٔ GNU Emacs برای یک پوستهٔ تعاملی. .RS .PP این گزینه نیازی به استفاده در کنار \f[B]\-I\f[R] یا \f[B]\-no\-rlwrap\f[R] ندارد و نمی‌تواند همراه با آن‌ها استفاده شود. .RE .TP .B \f[B]\-no\-rlwrap\f[R] هنگام راه‌اندازی پوستهٔ تعاملی، \f[B]rlwrap\f[R] فراخوانی نشود. .RS .PP این گزینه زمانی مفید است که نوع پایانهٔ شما توسط \f[B]rlwrap\f[R] پشتیبانی نمی‌شود (مانند \f[B]emacs\f[R]). .RE .SS "گزینه‌های ورودی/خروجی (I/O options)" .TP .B \f[B]\-i\f[R] \f[I]FILENAME\f[R], \f[B]\-input\f[R] \f[I]FILENAME\f[R] مشخص کردن فایل ورودی. .RS .PP متن مبدأ برای ترجمه به جای ورودی استاندارد، از فایل ورودی خوانده خواهد شد. .RE .TP .B \f[B]\-o\f[R] \f[I]FILENAME\f[R], \f[B]\-output\f[R] \f[I]FILENAME\f[R] مشخص کردن فایل خروجی. .RS .PP ترجمه‌ها به جای خروجی استاندارد، در فایل خروجی نوشته خواهند شد. .RE .SS "گزینه‌های ترجیحات زبان (Language preference options)" .TP .B \f[B]\-hl\f[R] \f[I]CODE\f[R], \f[B]\-host\f[R] \f[I]CODE\f[R] مشخص کردن زبان بومی شما (زبانی که مایلید برای نمایش پیام‌های اعلان در ترجمه دیده شود). .RS .PP این گزینه تنها بر نمایش در حالت پرگویی (verbose) تأثیر می‌گذارد (هر چیزی غیر از زبان مبدأ و زبان مقصد به زبان بومی شما نمایش داده خواهد شد). این گزینه در حالت مختصر (brief) هیچ تأثیری ندارد. .PP این گزینه اختیاری است. هنگامی که این تنظیم مشخص نشود، زبان انگلیسی استفاده خواهد شد. .PP این گزینه بر تنظیم متغیرهای محیطی $\f[B]LC_ALL\f[R]، $\f[B]LANG\f[R] و $\f[B]HOST_LANG\f[R] اولویت دارد. .RE .TP .B \f[B]\-s\f[R] \f[I]CODES\f[R], \f[B]\-sl\f[R] \f[I]CODES\f[R], \f[B]\-source\f[R] \f[I]CODES\f[R], \f[B]\-from\f[R] \f[I]CODES\f[R] مشخص کردن زبان(های) مبدأ (زبان یا زبان‌های متن اصلی). هنگام مشخص کردن دو یا چند کد زبان، آن‌ها را با علامت به‌علاوه \[dq]+\[dq] به هم متصل کنید. .RS .PP این گزینه اختیاری است. هنگامی که این تنظیم مشخص نشود، زبان متن اصلی به طور خودکار شناسایی خواهد شد (همراه با احتمال تشخیص نادرست). .PP این گزینه بر تنظیم متغیر محیطی $\f[B]SOURCE_LANG\f[R] اولویت دارد. .RE .TP .B \f[B]\-t\f[R] \f[I]CODES\f[R], \f[B]\-tl\f[R] \f[I]CODES\f[R], \f[B]\-target\f[R] \f[I]CODES\f[R], \f[B]\-to\f[R] \f[I]CODES\f[R] مشخص کردن زبان(های) مقصد (زبان یا زبان‌های متن ترجمه‌شده). هنگام مشخص کردن دو یا چند کد زبان، آن‌ها را با علامت به‌علاوه \[dq]+\[dq] به هم متصل کنید. .RS .PP این گزینه اختیاری است. هنگامی که این تنظیم مشخص نشود، همه‌چیز به انگلیسی ترجمه خواهد شد. .PP این گزینه بر تنظیم متغیرهای محیطی $\f[B]LC_ALL\f[R]، $\f[B]LANG\f[R] و $\f[B]TARGET_LANG\f[R] اولویت دارد. .RE .TP .B [\f[I]SOURCE\f[R]]:[\f[I]TARGETS\f[R]] روشی ساده‌تر و جایگزین برای مشخص کردن زبان مبدأ و زبان(های) مقصد، استفاده از یک رشتهٔ قالب‌بندی‌شدهٔ میان‌بر است: .RS .IP \[bu] 2 \f[I]SOURCE\-CODE\f[R]:\f[I]TARGET\-CODE\f[R] .IP \[bu] 2 \f[I]SOURCE\-CODE\f[R]:\f[I]TARGET\-CODE1\f[R]+\f[I]TARGET\-CODE2\f[R]+... .IP \[bu] 2 \f[I]SOURCE\-CODE\f[R]=\f[I]TARGET\-CODE\f[R] .IP \[bu] 2 \f[I]SOURCE\-CODE\f[R]=\f[I]TARGET\-CODE1\f[R]+\f[I]TARGET\-CODE2\f[R]+... .PP جداکننده‌های \[dq]:\[dq] و \[dq]=\[dq] می‌توانند به جای یکدیگر استفاده شوند. .PP هر یک از \f[I]SOURCE\f[R] یا \f[I]TARGETS\f[R] را می‌توان حذف کرد، اما نویسهٔ جداکننده باید حفظ شود. .RE.SS "گزینه‌های پیش‌پردازش متن (Text preprocessing options)" .TP .B \f[B]\-j\f[R], \f[B]\-join\-sentence\f[R] تمام آرگومان‌ها را به عنوان یک جملهٔ واحد در نظر می‌گیرد. .SS "سایر گزینه‌ها (Other options)" .TP .B \f[B]\-no\-init\f[R] هیچ اسکریپت راه‌اندازی را بارگذاری نمی‌کند. .TP .B \f[B]\-\-\f[R] پایان گزینه‌ها. .RS .PP تمام آرگومان‌های پس از این گزینه، به عنوان \f[I]TEXT\f[R] برای ترجمه در نظر گرفته می‌شوند. .RE .SH "وضعیت خروج (EXIT STATUS)" .TP .B \f[B]0\f[R] ترجمهٔ موفقیت‌آمیز. .TP .B \f[B]1\f[R] خطا. .SH "محیط (ENVIRONMENT)" .TP .B \f[B]PAGER\f[R] معادل با تنظیم گزینهٔ \f[B]\-pager\f[R]. .TP .B \f[B]BROWSER\f[R] معادل با تنظیم گزینهٔ \f[B]\-browser\f[R]. .TP .B \f[B]PLAYER\f[R] معادل با تنظیم گزینهٔ \f[B]\-player\f[R]. .TP .B \f[B]HTTP_PROXY\f[R] معادل با تنظیم گزینهٔ \f[B]\-proxy\f[R]. .TP .B \f[B]USER_AGENT\f[R] معادل با تنظیم گزینهٔ \f[B]\-user\-agent\f[R]. .TP .B \f[B]HOST_LANG\f[R] معادل با تنظیم گزینهٔ \f[B]\-host\f[R]. .TP .B \f[B]SOURCE_LANG\f[R] معادل با تنظیم گزینهٔ \f[B]\-source\f[R]. .TP .B \f[B]TARGET_LANG\f[R] معادل با تنظیم گزینهٔ \f[B]\-target\f[R]. .SH "فایل‌ها (FILES)" .TP .B \f[I]/etc/translate\-shell\f[R] اسکریپت راه‌اندازی. (سراسری در سیستم) .TP .B \f[I]$HOME/.translate\-shell/init.trans\f[R] اسکریپت راه‌اندازی. (مخصوص کاربر) .TP .B \f[I]$XDG_CONFIG_HOME/translate\-shell/init.trans\f[R] اسکریپت راه‌اندازی. (مخصوص کاربر) .TP .B \f[I]./.trans\f[R] اسکریپت راه‌اندازی. (دایرکتوری جاری) .SH "مستندات بیشتر (FURTHER DOCUMENTATION)" .PP .SH "گزارش باگ‌ها (REPORTING BUGS)" .PP .SH "نویسندگان (AUTHORS)" Mort Yao .