.\" Documents/brltty.1.  Generated from brltty.1.in by configure.
.\"
.\" BRLTTY - A background process providing access to the console screen (when in
.\"          text mode) for a blind person using a refreshable braille display.
.\"
.\" Copyright (C) 1995-2026 by The BRLTTY Developers.
.\"
.\" BRLTTY comes with ABSOLUTELY NO WARRANTY.
.\"
.\" This is free software, placed under the terms of the
.\" GNU Lesser General Public License, as published by the Free Software
.\" Foundation; either version 2.1 of the License, or (at your option) any
.\" later version. Please see the file LICENSE-LGPL for details.
.\"
.\" Web Page: http://brltty.app
.\"
.\" This software is maintained by Dave Mielke <dave@mielke.cc>.
.\"
.TH "BRLTTY" "1" "April 2026" "brltty 6.9.1" "BRLTTY User's Manual"
.SH "نام (NAME)"
brltty \- دیمن دسترسی‌پذیری به کنسول لینوکس برای نمایشگر بریل
.SH "خلاصه دستور (SYNOPSIS)"
\fBbrltty \fR[\fIگزینه\fR ...]
.SH "توضیحات (DESCRIPTION)"
.B brltty
یک پردازه پس‌زمینه (دیمن) است
که دسترسی به صفحه کنسول را (در حالت متنی)
برای یک فرد نابینا با استفاده از یک نمایشگر بریل با قابلیت تازه‌سازی (refreshable) فراهم می‌کند\&.
این برنامه نمایشگر بریل را راه‌اندازی کرده،
و قابلیت‌های کامل مرور صفحه را ارائه می‌دهد\&.
همچنین برخی امکانات گفتاری نیز در آن گنجانده شده است\&.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌ها را می‌توان به روش‌های مختلفی به
.B brltty
ارسال کرد\&.
از بیشترین تا کمترین میزان اثرگذاری، این روش‌ها عبارتند از:
.IP 1. 4
گزینه‌های خط فرمان
.IP 2. 4
پارامترهای بوت
.IP 3. 4
متغیرهای محیطی
(اگر گزینه
.B \-E
.RB "(" "\-\-environment\-variables" ")"
فعال باشد)
.IP 4. 4
فایل پیکربندی
.IP 5. 4
پیش‌فرض‌های توکار
.SS "گزینه‌های خط فرمان"
گزینه‌ها به ترتیب از چپ به راست پردازش می‌شوند\&.
اگر گزینه‌ای بیش از یک بار مشخص شود،
یا در صورت بروز تداخل،
مشخصه سمت راست‌ترین اولویت دارد\&.
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.TP
\fB\-a \fItable\fR (\fB\-\-attributes\-table=\fR)
مسیر جدول مشخصه‌ها (attributes table)\&.
مسیرهای نسبی نسبت به دایرکتوری
.B /usr/share/brltty/Attributes
سنجیده می‌شوند\&.
پسوند
.B ".atb"
اختیاری است\&.
پیش‌فرض توکار
.B left_right.atb
است\&.
.TP
\fB\-b \fIdriver\fB,\fR...|\fBauto\fR (\fB\-\-braille\-driver=\fR)
درایور مربوط به نمایشگر بریل
(بخش مشخصات درایور را ببینید)\&.
پیش‌فرض توکار \fBauto\fR است\&.
.TP
\fB\-c \fItable\fR (\fB\-\-contraction\-table=\fR)
مسیر جدول انقباض‌ها (contraction table)\&.
مسیرهای نسبی نسبت به دایرکتوری
.B /usr/share/brltty/Contraction
سنجیده می‌شوند\&.
پسوند
.B ".ctb"
اختیاری است\&.
.TP
\fB\-d \fIdevice\fB,\fR... (\fB\-\-braille\-device=\fR)
دستگاهی که نمایشگر بریل به آن متصل است\&.
پیش‌فرض توکار \fBusb:,bluetooth:\fR است\&.
.RS
.PP
شکل کلی مشخصه دستگاه بریل به صورت
\fIqualifier\fB:\fIdata\fR
است\&.
برای سازگاری رو به عقب با نسخه‌های پیشین،
در صورت حذف qualifier، مقدار
.B serial:
فرض می‌شود\&.
انواع دستگاه‌های زیر پشتیبانی می‌شوند:
.TP
.B بلوتوث (Bluetooth)
برای یک دستگاه بلوتوث، \fBbluetooth:\fIaddress\fR را مشخص کنید\&.
آدرس باید شش عدد هگزادسیمال دو رقمی باشد که با دو نقطه از هم جدا شده‌اند، مانند
.BR "01:23:45:67:89:AB" "."
.TP
.B سریال (Serial)
برای یک دستگاه سریال، \fBserial:\fIdevice\fR را مشخص کنید\&.
شناسه
.B serial:
(برای سازگاری رو به عقب) اختیاری است\&.
اگر یک مسیر نسبی داده شود، نسبت به
.B /dev/
(محل معمول تعریف دستگاه‌ها در یک سیستم شبه‌یونیکس) سنجیده می‌شود\&.
مشخصه‌های دستگاه زیر همگی به دستگاه سریال اصلی در لینوکس اشاره دارند:
.BR "serial:ttyS0" ","
.BR "serial:/dev/ttyS0" ","
.BR "ttyS0" ","
.BR "/dev/ttyS0" "."
.TP
.B یو‌اس‌بی (USB)
برای یک دستگاه USB، مقدار \fBusb:\fR را مشخص کنید\&.
دستور
.B brltty
اولین دستگاه USB را جستجو می‌کند که با درایور نمایشگر بریل در حال استفاده مطابقت دارد\&.
اگر این ناکافی باشد،
مثلاً اگر بیش از یک نمایشگر بریل USB دارید که به درایور یکسانی نیاز دارند،
می‌توانید با افزودن شماره سریال نمایشگر به آن، مشخصه دستگاه را دقیق‌تر کنید، مانند
.BR "usb:12345" "."
نکته:
قابلیت «شناسایی بر اساس شماره سریال» برای برخی مدل‌ها کار نمی‌کند
زیرا برخی از سازندگان
یا توصیف‌کننده شماره سریال USB را اصلاً تنظیم نمی‌کنند
یا آن را روی مقداری غیریکتا تنظیم می‌کنند\&.
.PP
می‌توان فهرستی از دستگاه‌های بریل را که با کاما از هم جدا شده‌اند مشخص کرد\&.
در این صورت، تشخیص خودکار روی هر یک از دستگاه‌های فهرست‌شده به ترتیب انجام می‌شود\&.
این ویژگی به‌ویژه زمانی مفید است که نمایشگر بریل دارای بیش از یک رابط باشد،
مانند پورت سریال و پورت USB به صورت همزمان\&.
.RE
.TP
\fB\-e\fR (\fB\-\-standard\-error\fR)
نوشتن لاگ‌ها در خطای استاندارد به جای لاگ سیستم (مفید برای اشکال‌زدایی)\&.
.TP
\fB\-f \fIfile\fR (\fB\-\-configuration\-file=\fR)
مسیر فایل پیکربندی\&.
مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند\&.
پیش‌فرض توکار
.B /etc/brltty.conf
است\&.
.TP
\fB\-h\fR (\fB\-\-help\fR)
چاپ خلاصه‌ای از نحوه استفاده در خط فرمان (تنها گزینه‌های پرکاربرد)،
و سپس خروج\&.
.TP
\fB\-i \fIname\fR (\fB\-\-speech\-input=\fR)
شیء فایل‌سیستمی
(مانند FIFO، لوله نام‌گذاری‌شده، سوکت نام‌گذاری‌شده و غیره)
که به سایر برنامه‌ها امکان دسترسی به درایور گفتار
.B brltty
را برای تبدیل متن به گفتار می‌دهد\&.
این شیء در زمان راه‌اندازی ایجاد شده و هنگام خاتمه برنامه حذف می‌شود\&.
مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند\&.
پیش‌فرض توکار این است که شیء فایل‌سیستمی ایجاد نشود\&.
.TP
\fB\-k \fItable\fR (\fB\-\-keyboard\-table=\fR)
مسیر جدول صفحه‌کلید\&.
مسیرهای نسبی نسبت به دایرکتوری
.B /usr/share/brltty/Keyboard
سنجیده می‌شوند\&.
پسوند
.B ".ktb"
اختیاری است\&.
.TP
\fB\-l \fIlevel\fR (\fB\-\-log\-level=\fR)
حداقل سطح اهمیت پیام‌هایی که در لاگ نوشته می‌شوند\&.
هر یک از اعداد زیر،
یا اختصاری از نام‌های متناظر آن‌ها را می‌توان مشخص کرد:
.RS
.TP 4
.B 0
.B emergency
.TP 4
.B 1
.B alert
.TP 4
.B 2
.B critical
.TP 4
.B 3
.B error
.TP 4
.B 4
.B warning
.TP 4
.B 5
.B notice
.TP 4
.B 6
.B information
.TP 4
.B 7
.B debug
.RE
.PP
پیش‌فرض توکار
.B notice
است\&.
.TP
\fB\-m \fIdevice\fR (\fB\-\-midi\-device=\fR)
دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود\&.
برای ALSA به صورت \fIclient\fB:\fIport\fR است،
که هر یک می‌تواند یک عدد یا زیررشته‌ای حساس به حروف بزرگ و کوچک از نام آن باشد\&.
برای سایر رابط‌ها، مسیر کامل به دستگاه سیستمی مناسب است\&.
پیش‌فرض توکار عبارت است از:
.RS
.IP Linux/ALSA 12
نخستین پورت خروجی MIDI در دسترس
.IP Linux/OSS 12
.B /dev/sequencer
.RE
.TP
\fB\-n\fR (\fB\-\-no\-daemon\fR)
ماندن در پیش‌زمینه (مفید برای اشکال‌زدایی)\&.
.TP
\fB\-o \fIname\fB=\fIvalue\fB,\fR... (\fB\-\-override\-preference=\fR)
بازنویسی یک تنظیم ترجیحی\&.
برای مشاهده مکان فایل ترجیحات، به گزینه
.B \-F
.RB "(" "\-\-preferences\-file" ")"
مراجعه کنید\&.
.TP
\fB\-p \fIdevice\fR (\fB\-\-pcm\-device=\fR)
دستگاهی که برای صدای دیجیتال استفاده می‌شود\&.
برای ALSA به صورت \fIname\fR[\fB:\fIargument\fB,\fR...] است\&.
برای سایر رابط‌ها، مسیر کامل به دستگاه سیستمی مناسب است\&.
پیش‌فرض توکار عبارت است از:
.RS
.IP FreeBSD 12
.B /dev/dsp
.IP Linux/ALSA 12
.B hw:0,0
.IP Linux/OSS 12
.B /dev/dsp
.IP NetBSD 12
.B /dev/audio
.IP OpenBSD 12
.B /dev/audio
.IP Qnx 12
دستگاه خروجی PCM ترجیحی
.IP Solaris 12
.B /dev/audio
.RE
.TP
\fB\-q\fR (\fB\-\-quiet\fR)
نادیده گرفتن و جلوگیری از نمایش پیام‌های راه‌اندازی\&.
این کار با کاهش سطح پیش‌فرض لاگ
(به گزینه
.B \-l
.RB "(" "\-\-log\-level=" ")"
مراجعه کنید)
به
.B warning
انجام می‌شود
.RB "("
در صورتی که
.B \-v
.RB "(" "\-\-verify" ")"
یا
.B \-V
.RB "(" "\-\-version" ")"
نیز مشخص شده باشد، به
.B information
کاهش می‌یابد
.RB ")" "\&."
.TP
\fB\-r\fR (\fB\-\-release\-device\fR)
رهاسازی دستگاهی که نمایشگر بریل به آن متصل است
زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد\&.
.TP
\fB\-s \fIdriver\fB,\fR...|\fBauto\fR (\fB\-\-speech\-driver=\fR)
درایور برای ترکیب‌کننده گفتار
(بخش مشخصات درایور را ببینید)\&.
پیش‌فرض توکار \fBauto\fR است\&.
.TP
\fB\-t \fItable\fR (\fB\-\-text\-table=\fR)
مسیر جدول متنی\&.
مسیرهای نسبی نسبت به دایرکتوری
.B /usr/share/brltty/Text
سنجیده می‌شوند\&.
پسوند
.B ".ttb"
اختیاری است\&.
پیش‌فرض توکار
.B "en-nabcc.ttb"
(کد کامپیوتری بریل آمریکای شمالی) است\&.
.TP
\fB\-v\fR (\fB\-\-verify\fR)
چاپ پیام‌های راه‌اندازی و سپس خروج\&.
این پیام‌ها همیشه شامل نسخه خود
.BR brltty ،
سمت سرور رابط برنامه‌نویسی نرم‌افزار آن،
و هر یک از درایورهای انتخاب‌شده بریل و گفتار است\&.
اگر گزینه
.B \-q
.RB "(" "\-\-quiet" ")"
نیز مشخص نشده باشد،
شامل مقادیر گزینه‌ها پس از بررسی تمام منابع نیز خواهد بود\&.
اگر بیش از یک درایور بریل یا بیش از یک دستگاه بریل
مشخص شده باشد، تشخیص خودکار نمایشگر بریل انجام می‌شود\&.
اگر بیش از یک درایور گفتار
مشخص شده باشد، تشخیص خودکار ترکیب‌کننده گفتار انجام می‌شود\&.
.TP
\fB\-x \fIdriver\fR (\fB\-\-screen\-driver=\fR)
درایور صفحه نمایش\&.
پیش‌فرض توکار متناسب با سیستم‌عامل انتخاب می‌شود\&.
.TP
\fB\-A \fIname\fB=\fIvalue\fB,\fR... (\fB\-\-api\-parameters=\fR)
پارامترهای رابط برنامه‌نویسی نرم‌افزار\&.
اگر یک پارامتر بیش از یک بار مشخص شود،
مشخصه سمت راست‌ترین استفاده می‌شود\&.
نام پارامترها را می‌توان به صورت اختصاری مشخص کرد\&.
.TP
\fB\-B \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB\-\-braille\-parameters=\fR)
پارامترهای درایور نمایشگر بریل\&.
اگر یک پارامتر بیش از یک بار مشخص شود،
مشخصه سمت راست‌ترین استفاده می‌شود\&.
نام پارامترها را می‌توان به صورت اختصاری مشخص کرد\&.
اگر انتساب یک پارامتر با یک کد شناسایی درایور مقید شده باشد،
تنها در صورتی پردازش می‌شود که آن درایور نمایشگر بریل در حال استفاده باشد\&.
.TP
\fB\-D \fIdirectory\fR (\fB\-\-drivers\-directory=\fR)
مسیر دایرکتوری حاوی شیءهای درایور
که به صورت پویا قابل بارگذاری هستند\&.
پیش‌فرض توکار
.B /usr/lib/brltty
است\&.
.TP
\fB\-E\fR (\fB\-\-environment\-variables\fR)
شناسایی متغیرهای محیطی\&.
.TP
\fB\-F \fIfile\fR (\fB\-\-preferences\-file=\fR)
مسیر فایل ترجیحات\&.
مسیرهای نسبی نسبت به دایرکتوری
.B /var/lib/brltty
سنجیده می‌شوند\&.
پیش‌فرض توکار
.B brltty.prefs
است\&.
.TP
\fB\-H\fR (\fB\-\-full\-help\fR)
چاپ خلاصه نحوه استفاده در خط فرمان (تمام گزینه‌ها)،
و سپس خروج\&.
.TP
\fB\-I\fR (\fB\-\-install\-service\fR)
(تنها در ویندوز)
نصب
.B brltty
به عنوان سرویس
.B BrlAPI
تا هنگام بوت شدن سیستم به صورت خودکار راه‌اندازی شود،
و برنامه‌ها بتوانند متوجه شوند که یک سرور
.B BrlAPI
در حال اجرا است\&.
.TP
\fB\-K \fIarg\fR (\fB\-\-keyboard\-properties=\fR)
ویژگی‌های صفحه‌کلید\&.
.TP
\fB\-L \fIfile\fR (\fB\-\-log\-file=\fR)
فایلی که پیام‌های لاگ در آن نوشته می‌شوند\&.
مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند\&.
پیش‌فرض این است که پیام‌های لاگ به لاگ سیستم ارسال شوند\&.
.TP
\fB\-M \fIcsecs\fR (\fB\-\-message\-delay=\fR)
زمان نگه‌داشتن پیام بر حسب صدم ثانیه\&.
پیش‌فرض توکار
.B 400
(۴ ثانیه) است\&.
.TP
\fB\-N\fR (\fB\-\-no\-api\fR)
رابط برنامه‌نویسی نرم‌افزار راه‌اندازی نشود\&.
.TP
\fB\-P \fIfile\fR (\fB\-\-pid\-file=\fR)
مسیر کامل فایل شناسه پردازه (PID)\&.
اگر این گزینه مشخص شود،
.B brltty
شناسه پردازه خود (PID) را در زمان راه‌اندازی درون فایل مشخص‌شده می‌نویسد\&.
این فایل هنگام پایان یافتن کار
.B brltty
حذف می‌شود\&.
.TP
\fB\-R\fR (\fB\-\-remove\-service\fR)
(تنها در ویندوز)
حذف سرویس
.B BrlAPI
تا
.B brltty
هنگام بوت شدن سیستم به طور خودکار شروع به کار نکند،
و برنامه‌ها بتوانند متوجه شوند که هیچ سرور
.B BrlAPI
در حال اجرا نیست\&.
.TP
\fB\-S \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR... (\fB\-\-speech\-parameters=\fR)
پارامترهای درایور ترکیب‌کننده گفتار\&.
اگر یک پارامتر بیش از یک بار مشخص شود،
مشخصه سمت راست‌ترین استفاده می‌شود\&.
نام پارامترها را می‌توان به صورت اختصاری مشخص کرد\&.
اگر انتساب یک پارامتر با یک کد شناسایی درایور مقید شده باشد،
تنها در صورتی پردازش می‌شود که آن درایور ترکیب‌کننده گفتار در حال استفاده باشد\&.
.TP
\fB\-T \fIdirectory\fR (\fB\-\-tables\-directory=\fR)
مسیر دایرکتوری حاوی جدول‌های متنی،
انقباض‌ها، مشخصه‌ها، صفحه‌کلید و ورودی\&.
پیش‌فرض توکار
.B /usr/share/brltty
است\&.
.TP
\fB\-U \fIdirectory\fR (\fB\-\-updatable\-directory=\fR)
مسیر دایرکتوری حاوی فایل‌هایی که می‌توانند به‌روزرسانی شوند\&.
پیش‌فرض توکار
.B /var/lib/brltty
است\&.
.TP
\fB\-V\fR (\fB\-\-version\fR)
چاپ نسخه خود
.BR brltty ،
سمت سرور رابط برنامه‌نویسی نرم‌افزار آن،
و درایورهایی که در زمان ساخت در آن پیکربندی شده‌اند،
و سپس خروج\&.
اگر گزینه
.B \-q
.RB "(" "\-\-quiet" ")"
مشخص نشده باشد،
اطلاعات حق نشر نیز چاپ می‌شود\&.
.TP
\fB\-W \fIdirectory\fR (\fB\-\-writable\-directory=\fR)
مسیر دایرکتوری با قابلیت نوشتن\&.
پیش‌فرض توکار
.B /run/brltty
است\&.
.TP
\fB\-X \fIname\fB=\fIvalue\fB,\fR... (\fB\-\-screen\-parameters=\fR)
پارامترهای درایور صفحه نمایش\&.
اگر یک پارامتر بیش از یک بار مشخص شود،
مشخصه سمت راست‌ترین استفاده می‌شود\&.
نام پارامترها را می‌توان به صورت اختصاری مشخص کرد\&.
.TP
\fB\-Y \fItext\fR (\fB\-\-start\-message=\fR)
متنی که هنگام شروع به کار درایور بریل نمایش داده می‌شود
و متنی که هنگام شروع به کار درایور گفتار خوانده می‌شود\&.
پیش‌فرض توکار
.B "BRLTTY 6.9.1"
است\&.
.TP
\fB\-Z \fItext\fR (\fB\-\-stop\-message=\fR)
متنی که هنگام توقف درایور بریل نمایش داده می‌شود\&.
پیش‌فرض توکار
.B "BRLTTY stopped"
است\&.
.SS "متغیرهای محیطی"
در صورت مشخص شدن گزینه
.B \-E
.RB "(" "\-\-environment\-variables" ")"
متغیرهای محیطی زیر شناسایی می‌شوند:
.TP
\fBBRLTTY_API_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
پارامترهای رابط برنامه‌نویسی نرم‌افزار\&.
برای جزئیات به گزینه
.B \-A
.RB "(" "\-\-api\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_ATTRIBUTES_TABLE=\fItable\fR
جدول مشخصه‌ها\&.
برای جزئیات به گزینه
.B \-a
.RB "(" "\-\-attributes\-table=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_BRAILLE_DEVICE=\fIdevice\fB,\fR...
دستگاهی که نمایشگر بریل به آن متصل است\&.
برای جزئیات به گزینه
.B \-d
.RB "(" "\-\-braille\-device=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_BRAILLE_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
درایور نمایشگر بریل\&.
برای جزئیات به گزینه
.B \-b
.RB "(" "\-\-braille\-driver=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_BRAILLE_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور نمایشگر بریل\&.
برای جزئیات به گزینه
.B \-B
.RB "(" "\-\-braille\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_CONFIGURATION_FILE=\fIfile\fR
فایل پیکربندی\&.
برای جزئیات به گزینه
.B \-f
.RB "(" "\-\-configuration\-file=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_CONTRACTION_TABLE=\fItable\fR
جدول انقباض‌ها\&.
برای جزئیات به گزینه
.B \-c
.RB "(" "\-\-contraction\-table=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_MIDI_DEVICE=\fIdevice\fR
دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود\&.
برای جزئیات به گزینه
.B \-m
.RB "(" "\-\-midi\-device=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_PCM_DEVICE=\fIdevice\fR
دستگاهی که برای صدای دیجیتال استفاده می‌شود\&.
برای جزئیات به گزینه
.B \-p
.RB "(" "\-\-pcm\-device=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_PREFERENCES_FILE=\fIfile\fR
فایل ترجیحات\&.
برای جزئیات به گزینه
.B \-F
.RB "(" "\-\-preferences\-file=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_RELEASE_DEVICE=on\fR|\fBoff\fR
رهاسازی دستگاهی که نمایشگر بریل به آن متصل است
زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد\&.
برای جزئیات به گزینه
.B \-r
.RB "(" "\-\-release\-device" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_SCREEN_DRIVER=\fIdriver\fR
درایور صفحه نمایش\&.
برای جزئیات به گزینه
.B \-x
.RB "(" "\-\-screen\-driver=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_SCREEN_PARAMETERS=\fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور صفحه نمایش\&.
برای جزئیات به گزینه
.B \-X
.RB "(" "\-\-screen\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_SPEECH_DRIVER=\fIdriver\fB,\fR...|\fBauto\fR
درایور ترکیب‌کننده گفتار\&.
برای جزئیات به گزینه
.B \-s
.RB "(" "\-\-speech\-driver=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_SPEECH_INPUT=\fIname\fR
شیء فایل‌سیستمی که به سایر برنامه‌ها امکان دسترسی به درایور گفتار
.B brltty
را برای تبدیل متن به گفتار می‌دهد\&.
برای جزئیات به گزینه
.B \-i
.RB "(" "\-\-speech\-input=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_SPEECH_PARAMETERS=\fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور ترکیب‌کننده گفتار\&.
برای جزئیات به گزینه
.B \-S
.RB "(" "\-\-speech\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBBRLTTY_TEXT_TABLE=\fItable\fR
جدول متنی\&.
برای جزئیات به گزینه
.B \-t
.RB "(" "\-\-text\-table=" ")"
مراجعه کنید\&.
.SS "فایل پیکربندی"
خطوط خالی نادیده گرفته می‌شوند\&.
اگر نویسه
.B "#"
در هر خطی بیاید،
تمام نویسه‌ها از آن تا انتهای آن خط به عنوان کامنت در نظر گرفته می‌شوند\&.
.PP
دستورالعمل‌های پیکربندی زیر پشتیبانی می‌شوند:
.TP
\fBapi\-parameters \fIname\fB=\fIvalue\fB,\fR...
پارامترهای رابط برنامه‌نویسی نرم‌افزار\&.
برای جزئیات به گزینه
.B \-A
.RB "(" "\-\-api\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBattributes\-table \fItable\fR
جدول مشخصه‌ها\&.
برای جزئیات به گزینه
.B \-a
.RB "(" "\-\-attributes\-table=" ")"
مراجعه کنید\&.
.TP
\fBbraille\-device \fIdevice\fB,\fR...
دستگاهی که نمایشگر بریل به آن متصل است\&.
برای جزئیات به گزینه
.B \-d
.RB "(" "\-\-braille\-device=" ")"
مراجعه کنید\&.
.TP
\fBbraille\-driver \fIdriver\fB,\fR...|\fBauto\fR
درایور نمایشگر بریل\&.
برای جزئیات به گزینه
.B \-b
.RB "(" "\-\-braille\-driver=" ")"
مراجعه کنید\&.
.TP
\fBbraille\-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور نمایشگر بریل\&.
برای جزئیات به گزینه
.B \-B
.RB "(" "\-\-braille\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBcontraction\-table \fItable\fR
جدول انقباض‌ها\&.
برای جزئیات به گزینه
.B \-c
.RB "(" "\-\-contraction\-table=" ")"
مراجعه کنید\&.
.TP
\fBmidi\-device \fIdevice\fR
دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود\&.
برای جزئیات به گزینه
.B \-m
.RB "(" "\-\-midi\-device=" ")"
مراجعه کنید\&.
.TP
\fBpcm\-device \fIdevice\fR
دستگاهی که برای صدای دیجیتال استفاده می‌شود\&.
برای جزئیات به گزینه
.B \-p
.RB "(" "\-\-pcm\-device=" ")"
مراجعه کنید\&.
.TP
\fBpreferences\-file \fIfile\fR
فایل ترجیحات\&.
برای جزئیات به گزینه
.B \-F
.RB "(" "\-\-preferences\-file=" ")"
مراجعه کنید\&.
.TP
\fBrelease\-device on\fR|\fBoff\fR
رهاسازی دستگاهی که نمایشگر بریل به آن متصل است
زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد\&.
برای جزئیات به گزینه
.B \-r
.RB "(" "\-\-release\-device" ")"
مراجعه کنید\&.
.TP
\fBscreen\-driver \fIdriver\fR
درایور صفحه نمایش\&.
برای جزئیات به گزینه
.B \-x
.RB "(" "\-\-screen\-driver=" ")"
مراجعه کنید\&.
.TP
\fBscreen\-parameters \fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور صفحه نمایش\&.
برای جزئیات به گزینه
.B \-X
.RB "(" "\-\-screen\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBspeech\-driver \fIdriver\fB,\fR...|\fBauto\fR
درایور ترکیب‌کننده گفتار\&.
برای جزئیات به گزینه
.B \-s
.RB "(" "\-\-speech\-driver=" ")"
مراجعه کنید\&.
.TP
\fBspeech\-input \fIname\fR
شیء فایل‌سیستمی که به سایر برنامه‌ها امکان دسترسی به درایور گفتار
.B brltty
را برای تبدیل متن به گفتار می‌دهد\&.
برای جزئیات به گزینه
.B \-i
.RB "(" "\-\-speech\-input=" ")"
مراجعه کنید\&.
.TP
\fBspeech\-parameters \fR[\fIdriver\fB:\fR]\fIname\fB=\fIvalue\fB,\fR...
پارامترهای درایور ترکیب‌کننده گفتار\&.
برای جزئیات به گزینه
.B \-S
.RB "(" "\-\-speech\-parameters=" ")"
مراجعه کنید\&.
.TP
\fBtext\-table \fItable\fR
جدول متنی\&.
برای جزئیات به گزینه
.B \-t
.RB "(" "\-\-text\-table=" ")"
مراجعه کنید\&.
.SS "مشخصات درایور"
درایور نمایشگر بریل یا ترکیب‌کننده گفتار
باید با کد شناسایی آن مشخص شود:
.RS
.TP 4
.B al
Alva
.TP 4
.B an
Android
.TP 4
.B at
Albatross
.TP 4
.B ba
BrlAPI
.TP 4
.B bc
BrailComm
.TP 4
.B bd
Braudi
.TP 4
.B bl
BrailleLite
.TP 4
.B bm
Baum
.TP 4
.B bn
BrailleNote
.TP 4
.B cb
CombiBraille
.TP 4
.B ce
Cebra
.TP 4
.B cn
Canute
.TP 4
.B dp
DotPad
.TP 4
.B ec
EcoBraille
.TP 4
.B en
eSpeak-NG
.TP 4
.B es
eSpeak
.TP 4
.B eu
EuroBraille
.TP 4
.B fa
FrankAudiodata
.TP 4
.B fl
FestivalLite
.TP 4
.B fs
FreedomScientific
.TP 4
.B fv
Festival
.TP 4
.B gs
GenericSay
.TP 4
.B hd
Hedo
.TP 4
.B hm
HIMS
.TP 4
.B ht
HandyTech
.TP 4
.B hw
HumanWare
.TP 4
.B ir
Iris
.TP 4
.B ic
Inceptor
.TP 4
.B lb
Libbraille
.TP 4
.B lt
LogText
.TP 4
.B mb
MultiBraille
.TP 4
.B md
MDV
.TP 4
.B mm
BrailleMemo
.TP 4
.B mn
MiniBraille
.TP 4
.B mp
Mikropuhe
.TP 4
.B mt
Metec
.TP 4
.B no
بدون درایور (no driver)
.TP 4
.B np
NinePoint
.TP 4
.B pg
Pegasus
.TP 4
.B pm
Papenmeier
.TP 4
.B sd
SpeechDispatcher
.TP 4
.B sk
Seika
.TP 4
.B sw
Swift
.TP 4
.B th
Theta
.TP 4
.B tn
TechniBraille Systems Inc.
.TP 4
.B ts
Telesensory Systems Inc.
.TP 4
.B vd
VideoBraille
.TP 4
.B vo
Voyager, Part232 (مبدل سریال), BraillePen/EasyLink
.TP 4
.B vs
VisioBraille
.TP 4
.B vv
ViaVoice
.TP 4
.B xs
ExternalSpeech
.PP
می‌توان فهرستی از درایورها را که با کاما از هم جدا شده‌اند مشخص کرد\&.
در این صورت، تشخیص خودکار با استفاده از هر یک از درایورهای فهرست‌شده به ترتیب انجام می‌شود\&.
ممکن است برای تعیین قابل‌اعتمادترین ترتیب نیاز به آزمایش داشته باشید،
زیرا برخی درایورها بهتر از دیگران عمل تشخیص خودکار را انجام می‌دهند\&.
.PP
اگر واژه مفرد
.B auto
مشخص شود، تشخیص خودکار
تنها با استفاده از درایورهایی انجام می‌شود که به قابلیت اطمینان برای این منظور شناخته شده‌اند\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
برای دریافت مستندات کامل، به راهنمای برخط
.BR brltty
در
.RB "[" "http://brltty.app/documentation.html" "]"
مراجعه کنید\&.