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