نام (NAME)

brltty - دیمن دسترسی‌پذیری به کنسول لینوکس برای نمایشگر بریل

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

brltty [گزینه ...]

توضیحات (DESCRIPTION)

brltty یک پردازه پس‌زمینه (دیمن) است که دسترسی به صفحه کنسول را (در حالت متنی) برای یک فرد نابینا با استفاده از یک نمایشگر بریل با قابلیت تازه‌سازی (refreshable) فراهم می‌کند. این برنامه نمایشگر بریل را راه‌اندازی کرده، و قابلیت‌های کامل مرور صفحه را ارائه می‌دهد. همچنین برخی امکانات گفتاری نیز در آن گنجانده شده است.

گزینه‌ها (OPTIONS)

گزینه‌ها را می‌توان به روش‌های مختلفی به brltty ارسال کرد. از بیشترین تا کمترین میزان اثرگذاری، این روش‌ها عبارتند از:

1.: گزینه‌های خط فرمان
2.: پارامترهای بوت
3.: متغیرهای محیطی (اگر گزینه -E (--environment-variables) فعال باشد)
4.: فایل پیکربندی
5.: پیش‌فرض‌های توکار

گزینه‌های خط فرمان

گزینه‌ها به ترتیب از چپ به راست پردازش می‌شوند. اگر گزینه‌ای بیش از یک بار مشخص شود، یا در صورت بروز تداخل، مشخصه سمت راست‌ترین اولویت دارد.

گزینه‌های زیر پشتیبانی می‌شوند:

-a table (--attributes-table=): مسیر جدول مشخصه‌ها (attributes table). مسیرهای نسبی نسبت به دایرکتوری /usr/share/brltty/Attributes سنجیده می‌شوند. پسوند .atb اختیاری است. پیش‌فرض توکار left_right.atb است.
-b driver,...|auto (--braille-driver=): درایور مربوط به نمایشگر بریل (بخش مشخصات درایور را ببینید). پیش‌فرض توکار auto است.
-c table (--contraction-table=): مسیر جدول انقباض‌ها (contraction table). مسیرهای نسبی نسبت به دایرکتوری /usr/share/brltty/Contraction سنجیده می‌شوند. پسوند .ctb اختیاری است.
-d device,... (--braille-device=): دستگاهی که نمایشگر بریل به آن متصل است. پیش‌فرض توکار usb:,bluetooth: است.

شکل کلی مشخصه دستگاه بریل به صورت qualifier:data است. برای سازگاری رو به عقب با نسخه‌های پیشین، در صورت حذف qualifier، مقدار serial: فرض می‌شود. انواع دستگاه‌های زیر پشتیبانی می‌شوند:

بلوتوث (Bluetooth): برای یک دستگاه بلوتوث، bluetooth:address را مشخص کنید. آدرس باید شش عدد هگزادسیمال دو رقمی باشد که با دو نقطه از هم جدا شده‌اند، مانند 01:23:45:67:89:AB.
سریال (Serial): برای یک دستگاه سریال، serial:device را مشخص کنید. شناسه serial: (برای سازگاری رو به عقب) اختیاری است. اگر یک مسیر نسبی داده شود، نسبت به /dev/ (محل معمول تعریف دستگاه‌ها در یک سیستم شبه‌یونیکس) سنجیده می‌شود. مشخصه‌های دستگاه زیر همگی به دستگاه سریال اصلی در لینوکس اشاره دارند: serial:ttyS0, serial:/dev/ttyS0, ttyS0, /dev/ttyS0.
یو‌اس‌بی (USB): برای یک دستگاه USB، مقدار usb: را مشخص کنید. دستور brltty اولین دستگاه USB را جستجو می‌کند که با درایور نمایشگر بریل در حال استفاده مطابقت دارد. اگر این ناکافی باشد، مثلاً اگر بیش از یک نمایشگر بریل USB دارید که به درایور یکسانی نیاز دارند، می‌توانید با افزودن شماره سریال نمایشگر به آن، مشخصه دستگاه را دقیق‌تر کنید، مانند usb:12345. نکته: قابلیت «شناسایی بر اساس شماره سریال» برای برخی مدل‌ها کار نمی‌کند زیرا برخی از سازندگان یا توصیف‌کننده شماره سریال USB را اصلاً تنظیم نمی‌کنند یا آن را روی مقداری غیریکتا تنظیم می‌کنند.

می‌توان فهرستی از دستگاه‌های بریل را که با کاما از هم جدا شده‌اند مشخص کرد. در این صورت، تشخیص خودکار روی هر یک از دستگاه‌های فهرست‌شده به ترتیب انجام می‌شود. این ویژگی به‌ویژه زمانی مفید است که نمایشگر بریل دارای بیش از یک رابط باشد، مانند پورت سریال و پورت USB به صورت همزمان.

-e (--standard-error): نوشتن لاگ‌ها در خطای استاندارد به جای لاگ سیستم (مفید برای اشکال‌زدایی).
-f file (--configuration-file=): مسیر فایل پیکربندی. مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند. پیش‌فرض توکار /etc/brltty.conf است.
-h (--help): چاپ خلاصه‌ای از نحوه استفاده در خط فرمان (تنها گزینه‌های پرکاربرد)، و سپس خروج.
-i name (--speech-input=): شیء فایل‌سیستمی (مانند FIFO، لوله نام‌گذاری‌شده، سوکت نام‌گذاری‌شده و غیره) که به سایر برنامه‌ها امکان دسترسی به درایور گفتار brltty را برای تبدیل متن به گفتار می‌دهد. این شیء در زمان راه‌اندازی ایجاد شده و هنگام خاتمه برنامه حذف می‌شود. مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند. پیش‌فرض توکار این است که شیء فایل‌سیستمی ایجاد نشود.
-k table (--keyboard-table=): مسیر جدول صفحه‌کلید. مسیرهای نسبی نسبت به دایرکتوری /usr/share/brltty/Keyboard سنجیده می‌شوند. پسوند .ktb اختیاری است.
-l level (--log-level=): حداقل سطح اهمیت پیام‌هایی که در لاگ نوشته می‌شوند. هر یک از اعداد زیر، یا اختصاری از نام‌های متناظر آن‌ها را می‌توان مشخص کرد:

0: emergency
1: alert
2: critical
3: error
4: warning
5: notice
6: information
7: debug

پیش‌فرض توکار notice است.

-m device (--midi-device=): دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود. برای ALSA به صورت client:port است، که هر یک می‌تواند یک عدد یا زیررشته‌ای حساس به حروف بزرگ و کوچک از نام آن باشد. برای سایر رابط‌ها، مسیر کامل به دستگاه سیستمی مناسب است. پیش‌فرض توکار عبارت است از:

Linux/ALSA: نخستین پورت خروجی MIDI در دسترس
Linux/OSS: /dev/sequencer

-n (--no-daemon): ماندن در پیش‌زمینه (مفید برای اشکال‌زدایی).
-o name=value,... (--override-preference=): بازنویسی یک تنظیم ترجیحی. برای مشاهده مکان فایل ترجیحات، به گزینه -F (--preferences-file) مراجعه کنید.
-p device (--pcm-device=): دستگاهی که برای صدای دیجیتال استفاده می‌شود. برای ALSA به صورت name[:argument,...] است. برای سایر رابط‌ها، مسیر کامل به دستگاه سیستمی مناسب است. پیش‌فرض توکار عبارت است از:

FreeBSD: /dev/dsp
Linux/ALSA: hw:0,0
Linux/OSS: /dev/dsp
NetBSD: /dev/audio
OpenBSD: /dev/audio
Qnx: دستگاه خروجی PCM ترجیحی
Solaris: /dev/audio

-q (--quiet): نادیده گرفتن و جلوگیری از نمایش پیام‌های راه‌اندازی. این کار با کاهش سطح پیش‌فرض لاگ (به گزینه -l (--log-level=) مراجعه کنید) به warning انجام می‌شود ( در صورتی که -v (--verify) یا -V (--version) نیز مشخص شده باشد، به information کاهش می‌یابد ).
-r (--release-device): رهاسازی دستگاهی که نمایشگر بریل به آن متصل است زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد.
-s driver,...|auto (--speech-driver=): درایور برای ترکیب‌کننده گفتار (بخش مشخصات درایور را ببینید). پیش‌فرض توکار auto است.
-t table (--text-table=): مسیر جدول متنی. مسیرهای نسبی نسبت به دایرکتوری /usr/share/brltty/Text سنجیده می‌شوند. پسوند .ttb اختیاری است. پیش‌فرض توکار en-nabcc.ttb (کد کامپیوتری بریل آمریکای شمالی) است.
-v (--verify): چاپ پیام‌های راه‌اندازی و سپس خروج. این پیام‌ها همیشه شامل نسخه خود brltty، سمت سرور رابط برنامه‌نویسی نرم‌افزار آن، و هر یک از درایورهای انتخاب‌شده بریل و گفتار است. اگر گزینه -q (--quiet) نیز مشخص نشده باشد، شامل مقادیر گزینه‌ها پس از بررسی تمام منابع نیز خواهد بود. اگر بیش از یک درایور بریل یا بیش از یک دستگاه بریل مشخص شده باشد، تشخیص خودکار نمایشگر بریل انجام می‌شود. اگر بیش از یک درایور گفتار مشخص شده باشد، تشخیص خودکار ترکیب‌کننده گفتار انجام می‌شود.
-x driver (--screen-driver=): درایور صفحه نمایش. پیش‌فرض توکار متناسب با سیستم‌عامل انتخاب می‌شود.
-A name=value,... (--api-parameters=): پارامترهای رابط برنامه‌نویسی نرم‌افزار. اگر یک پارامتر بیش از یک بار مشخص شود، مشخصه سمت راست‌ترین استفاده می‌شود. نام پارامترها را می‌توان به صورت اختصاری مشخص کرد.
-B [driver:]name=value,... (--braille-parameters=): پارامترهای درایور نمایشگر بریل. اگر یک پارامتر بیش از یک بار مشخص شود، مشخصه سمت راست‌ترین استفاده می‌شود. نام پارامترها را می‌توان به صورت اختصاری مشخص کرد. اگر انتساب یک پارامتر با یک کد شناسایی درایور مقید شده باشد، تنها در صورتی پردازش می‌شود که آن درایور نمایشگر بریل در حال استفاده باشد.
-D directory (--drivers-directory=): مسیر دایرکتوری حاوی شیءهای درایور که به صورت پویا قابل بارگذاری هستند. پیش‌فرض توکار /usr/lib/brltty است.
-E (--environment-variables): شناسایی متغیرهای محیطی.
-F file (--preferences-file=): مسیر فایل ترجیحات. مسیرهای نسبی نسبت به دایرکتوری /var/lib/brltty سنجیده می‌شوند. پیش‌فرض توکار brltty.prefs است.
-H (--full-help): چاپ خلاصه نحوه استفاده در خط فرمان (تمام گزینه‌ها)، و سپس خروج.
-I (--install-service): (تنها در ویندوز) نصب brltty به عنوان سرویس BrlAPI تا هنگام بوت شدن سیستم به صورت خودکار راه‌اندازی شود، و برنامه‌ها بتوانند متوجه شوند که یک سرور BrlAPI در حال اجرا است.
-K arg (--keyboard-properties=): ویژگی‌های صفحه‌کلید.
-L file (--log-file=): فایلی که پیام‌های لاگ در آن نوشته می‌شوند. مسیرهای نسبی نسبت به دایرکتوری کاری فعلی سنجیده می‌شوند. پیش‌فرض این است که پیام‌های لاگ به لاگ سیستم ارسال شوند.
-M csecs (--message-delay=): زمان نگه‌داشتن پیام بر حسب صدم ثانیه. پیش‌فرض توکار 400 (۴ ثانیه) است.
-N (--no-api): رابط برنامه‌نویسی نرم‌افزار راه‌اندازی نشود.
-P file (--pid-file=): مسیر کامل فایل شناسه پردازه (PID). اگر این گزینه مشخص شود، brltty شناسه پردازه خود (PID) را در زمان راه‌اندازی درون فایل مشخص‌شده می‌نویسد. این فایل هنگام پایان یافتن کار brltty حذف می‌شود.
-R (--remove-service): (تنها در ویندوز) حذف سرویس BrlAPI تا brltty هنگام بوت شدن سیستم به طور خودکار شروع به کار نکند، و برنامه‌ها بتوانند متوجه شوند که هیچ سرور BrlAPI در حال اجرا نیست.
-S [driver:]name=value,... (--speech-parameters=): پارامترهای درایور ترکیب‌کننده گفتار. اگر یک پارامتر بیش از یک بار مشخص شود، مشخصه سمت راست‌ترین استفاده می‌شود. نام پارامترها را می‌توان به صورت اختصاری مشخص کرد. اگر انتساب یک پارامتر با یک کد شناسایی درایور مقید شده باشد، تنها در صورتی پردازش می‌شود که آن درایور ترکیب‌کننده گفتار در حال استفاده باشد.
-T directory (--tables-directory=): مسیر دایرکتوری حاوی جدول‌های متنی، انقباض‌ها، مشخصه‌ها، صفحه‌کلید و ورودی. پیش‌فرض توکار /usr/share/brltty است.
-U directory (--updatable-directory=): مسیر دایرکتوری حاوی فایل‌هایی که می‌توانند به‌روزرسانی شوند. پیش‌فرض توکار /var/lib/brltty است.
-V (--version): چاپ نسخه خود brltty، سمت سرور رابط برنامه‌نویسی نرم‌افزار آن، و درایورهایی که در زمان ساخت در آن پیکربندی شده‌اند، و سپس خروج. اگر گزینه -q (--quiet) مشخص نشده باشد، اطلاعات حق نشر نیز چاپ می‌شود.
-W directory (--writable-directory=): مسیر دایرکتوری با قابلیت نوشتن. پیش‌فرض توکار /run/brltty است.
-X name=value,... (--screen-parameters=): پارامترهای درایور صفحه نمایش. اگر یک پارامتر بیش از یک بار مشخص شود، مشخصه سمت راست‌ترین استفاده می‌شود. نام پارامترها را می‌توان به صورت اختصاری مشخص کرد.
-Y text (--start-message=): متنی که هنگام شروع به کار درایور بریل نمایش داده می‌شود و متنی که هنگام شروع به کار درایور گفتار خوانده می‌شود. پیش‌فرض توکار BRLTTY 6.9.1 است.
-Z text (--stop-message=): متنی که هنگام توقف درایور بریل نمایش داده می‌شود. پیش‌فرض توکار BRLTTY stopped است.

متغیرهای محیطی

در صورت مشخص شدن گزینه -E (--environment-variables) متغیرهای محیطی زیر شناسایی می‌شوند:

BRLTTY_API_PARAMETERS=name=value,...: پارامترهای رابط برنامه‌نویسی نرم‌افزار. برای جزئیات به گزینه -A (--api-parameters=) مراجعه کنید.
BRLTTY_ATTRIBUTES_TABLE=table: جدول مشخصه‌ها. برای جزئیات به گزینه -a (--attributes-table=) مراجعه کنید.
BRLTTY_BRAILLE_DEVICE=device,...: دستگاهی که نمایشگر بریل به آن متصل است. برای جزئیات به گزینه -d (--braille-device=) مراجعه کنید.
BRLTTY_BRAILLE_DRIVER=driver,...|auto: درایور نمایشگر بریل. برای جزئیات به گزینه -b (--braille-driver=) مراجعه کنید.
BRLTTY_BRAILLE_PARAMETERS=[driver:]name=value,...: پارامترهای درایور نمایشگر بریل. برای جزئیات به گزینه -B (--braille-parameters=) مراجعه کنید.
BRLTTY_CONFIGURATION_FILE=file: فایل پیکربندی. برای جزئیات به گزینه -f (--configuration-file=) مراجعه کنید.
BRLTTY_CONTRACTION_TABLE=table: جدول انقباض‌ها. برای جزئیات به گزینه -c (--contraction-table=) مراجعه کنید.
BRLTTY_MIDI_DEVICE=device: دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود. برای جزئیات به گزینه -m (--midi-device=) مراجعه کنید.
BRLTTY_PCM_DEVICE=device: دستگاهی که برای صدای دیجیتال استفاده می‌شود. برای جزئیات به گزینه -p (--pcm-device=) مراجعه کنید.
BRLTTY_PREFERENCES_FILE=file: فایل ترجیحات. برای جزئیات به گزینه -F (--preferences-file=) مراجعه کنید.
BRLTTY_RELEASE_DEVICE=on|off: رهاسازی دستگاهی که نمایشگر بریل به آن متصل است زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد. برای جزئیات به گزینه -r (--release-device) مراجعه کنید.
BRLTTY_SCREEN_DRIVER=driver: درایور صفحه نمایش. برای جزئیات به گزینه -x (--screen-driver=) مراجعه کنید.
BRLTTY_SCREEN_PARAMETERS=name=value,...: پارامترهای درایور صفحه نمایش. برای جزئیات به گزینه -X (--screen-parameters=) مراجعه کنید.
BRLTTY_SPEECH_DRIVER=driver,...|auto: درایور ترکیب‌کننده گفتار. برای جزئیات به گزینه -s (--speech-driver=) مراجعه کنید.
BRLTTY_SPEECH_INPUT=name: شیء فایل‌سیستمی که به سایر برنامه‌ها امکان دسترسی به درایور گفتار brltty را برای تبدیل متن به گفتار می‌دهد. برای جزئیات به گزینه -i (--speech-input=) مراجعه کنید.
BRLTTY_SPEECH_PARAMETERS=[driver:]name=value,...: پارامترهای درایور ترکیب‌کننده گفتار. برای جزئیات به گزینه -S (--speech-parameters=) مراجعه کنید.
BRLTTY_TEXT_TABLE=table: جدول متنی. برای جزئیات به گزینه -t (--text-table=) مراجعه کنید.

فایل پیکربندی

خطوط خالی نادیده گرفته می‌شوند. اگر نویسه # در هر خطی بیاید، تمام نویسه‌ها از آن تا انتهای آن خط به عنوان کامنت در نظر گرفته می‌شوند.

دستورالعمل‌های پیکربندی زیر پشتیبانی می‌شوند:

api-parameters name=value,...: پارامترهای رابط برنامه‌نویسی نرم‌افزار. برای جزئیات به گزینه -A (--api-parameters=) مراجعه کنید.
attributes-table table: جدول مشخصه‌ها. برای جزئیات به گزینه -a (--attributes-table=) مراجعه کنید.
braille-device device,...: دستگاهی که نمایشگر بریل به آن متصل است. برای جزئیات به گزینه -d (--braille-device=) مراجعه کنید.
braille-driver driver,...|auto: درایور نمایشگر بریل. برای جزئیات به گزینه -b (--braille-driver=) مراجعه کنید.
braille-parameters [driver:]name=value,...: پارامترهای درایور نمایشگر بریل. برای جزئیات به گزینه -B (--braille-parameters=) مراجعه کنید.
contraction-table table: جدول انقباض‌ها. برای جزئیات به گزینه -c (--contraction-table=) مراجعه کنید.
midi-device device: دستگاهی که برای رابط دیجیتالی سازهای موسیقی (MIDI) استفاده می‌شود. برای جزئیات به گزینه -m (--midi-device=) مراجعه کنید.
pcm-device device: دستگاهی که برای صدای دیجیتال استفاده می‌شود. برای جزئیات به گزینه -p (--pcm-device=) مراجعه کنید.
preferences-file file: فایل ترجیحات. برای جزئیات به گزینه -F (--preferences-file=) مراجعه کنید.
release-device on|off: رهاسازی دستگاهی که نمایشگر بریل به آن متصل است زمانی که صفحه یا پنجره فعلی قابل خواندن نباشد. برای جزئیات به گزینه -r (--release-device) مراجعه کنید.
screen-driver driver: درایور صفحه نمایش. برای جزئیات به گزینه -x (--screen-driver=) مراجعه کنید.
screen-parameters name=value,...: پارامترهای درایور صفحه نمایش. برای جزئیات به گزینه -X (--screen-parameters=) مراجعه کنید.
speech-driver driver,...|auto: درایور ترکیب‌کننده گفتار. برای جزئیات به گزینه -s (--speech-driver=) مراجعه کنید.
speech-input name: شیء فایل‌سیستمی که به سایر برنامه‌ها امکان دسترسی به درایور گفتار brltty را برای تبدیل متن به گفتار می‌دهد. برای جزئیات به گزینه -i (--speech-input=) مراجعه کنید.
speech-parameters [driver:]name=value,...: پارامترهای درایور ترکیب‌کننده گفتار. برای جزئیات به گزینه -S (--speech-parameters=) مراجعه کنید.
text-table table: جدول متنی. برای جزئیات به گزینه -t (--text-table=) مراجعه کنید.

مشخصات درایور

درایور نمایشگر بریل یا ترکیب‌کننده گفتار باید با کد شناسایی آن مشخص شود:

al: Alva
an: Android
at: Albatross
ba: BrlAPI
bc: BrailComm
bd: Braudi
bl: BrailleLite
bm: Baum
bn: BrailleNote
cb: CombiBraille
ce: Cebra
cn: Canute
dp: DotPad
ec: EcoBraille
en: eSpeak-NG
es: eSpeak
eu: EuroBraille
fa: FrankAudiodata
fl: FestivalLite
fs: FreedomScientific
fv: Festival
gs: GenericSay
hd: Hedo
hm: HIMS
ht: HandyTech
hw: HumanWare
ir: Iris
ic: Inceptor
lb: Libbraille
lt: LogText
mb: MultiBraille
md: MDV
mm: BrailleMemo
mn: MiniBraille
mp: Mikropuhe
mt: Metec
no: بدون درایور (no driver)
np: NinePoint
pg: Pegasus
pm: Papenmeier
sd: SpeechDispatcher
sk: Seika
sw: Swift
th: Theta
tn: TechniBraille Systems Inc.
ts: Telesensory Systems Inc.
vd: VideoBraille
vo: Voyager, Part232 (مبدل سریال), BraillePen/EasyLink
vs: VisioBraille
vv: ViaVoice
xs: ExternalSpeech

می‌توان فهرستی از درایورها را که با کاما از هم جدا شده‌اند مشخص کرد. در این صورت، تشخیص خودکار با استفاده از هر یک از درایورهای فهرست‌شده به ترتیب انجام می‌شود. ممکن است برای تعیین قابل‌اعتمادترین ترتیب نیاز به آزمایش داشته باشید، زیرا برخی درایورها بهتر از دیگران عمل تشخیص خودکار را انجام می‌دهند.

اگر واژه مفرد auto مشخص شود، تشخیص خودکار تنها با استفاده از درایورهایی انجام می‌شود که به قابلیت اطمینان برای این منظور شناخته شده‌اند.

همچنین ببینید (SEE ALSO)

برای دریافت مستندات کامل، به راهنمای برخط brltty در [http://brltty.app/documentation.html] مراجعه کنید.