.\" Copyright (C) 2005-2009 Sun Microsystems Inc.
.\"
.\" This is free software; you may redistribute it and/or modify
.\" it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2,
.\" or (at your option) any later version.
.\"
.\" This is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this; if not write to the Free Software Foundation, Inc.
.\" 51 Franklin Street, Fifth Floor, Boston MA 02110-1301 USA
'\"
.TH orca 1 "19 February 2026" "GNOME"
.SH "نام (NAME)"
orca \- صفحه‌خوان اسکریپت‌پذیر
.SH "خلاصه دستور (SYNOPSIS)"
.B orca
.RI [ گزینه... ]
.SH "توضیحات (DESCRIPTION)"
.B orca
یک صفحه‌خوان برای افراد دارای آسیب‌های بینایی است که با استفاده از سنتز گفتار و خط بریل، امکان دسترسی جایگزین به میزکار را فراهم می‌سازد.
.P
.B orca
با برنامه‌ها و جعبه‌ابزارهایی کار می‌کند که از رابط ارائه‌دهنده خدمات فناوری کمکی (AT-SPI) پشتیبانی می‌کنند؛ رابطی که زیرساخت اصلی فناوری‌های کمکی در لینوکس است. برنامه‌ها و جعبه‌ابزارهایی که از AT-SPI پشتیبانی می‌کنند شامل جعبه‌ابزار GTK گنوم، جعبه‌ابزار Swing در پلتفرم جاوا، LibreOffice، Gecko، WebKitGTK و Qt هستند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h, \-\-help
نمایش پیام راهنما و خروج.
.TP
.B \-v, \-\-version
چاپ اطلاعات نسخه و خروج.
.TP
.B \-r, \-\-replace
جایگزینی یک فرایند در حال اجرای
.BR orca .
به‌طور پیش‌فرض، اگر
.B orca
فرایند موجودی از
.B orca
را برای همان نشست تشخیص دهد، فرایند جدیدی از
.B orca
را آغاز نخواهد کرد. این گزینه هرگونه فرایند موجود
.B orca
را خاتمه داده (kill)، پاک‌سازی کرده و سپس یک
.B orca
جدید را به جای آن اجرا می‌کند.
.TP
.B \-s, \-\-setup
پیکربندی ترجیحات کاربر با استفاده از رابط گرافیکی (GUI). اگر
.B orca
از قبل در حال اجرا باشد، پنجرهٔ تنظیمات در نمونهٔ در حال اجرا نمایش داده خواهد شد.
.TP
.B \-l, \-\-list\-apps
چاپ برنامه‌های در حال اجرای شناخته‌شده. این گزینه عمدتاً برای اهداف اشکال‌زدایی استفاده می‌شود تا بررسی شود آیا
.B orca
می‌تواند با زیرساخت دسترسی‌پذیری ارتباط برقرار کند یا خیر. توجه داشته باشید که اگر
.B orca
از قبل در حال اجرا باشد، این کار فرایند دیگر
.B orca
را متوقف نخواهد کرد؛ بلکه تنها برنامه‌های در حال اجرای فعلی را فهرست می‌کند و
.B orca
دو بار فهرست خواهد شد: یک بار برای
.B orca
موجود و بار دیگر برای این نمونه.
.TP
.BI "\-p, \-\-profile " NAME
بارگذاری نمایهٔ کاربری مشخص‌شده.
.TP
.BI "\-i, \-\-import\-dir " DIR
وارد کردن تنظیمات از
.I DIR
به dconf و بازنویسی تنظیمات فعلی. این گزینه در درجه اول برای اهداف مهاجرت در نظر گرفته شده است.
.TP
.BI "\-\-speech\-system " NAME
استفاده از سیستم گفتار مشخص‌شده.
.TP
.B \-\-debug
فعال‌سازی خروجی اشکال‌زدایی برای
.B orca
و ارسال تمامی خروجی‌های اشکال‌زدایی به فایلی با نامی به فرمت \(aqdebug\-YYYY\-MM\-DD\-HH:MM:SS.out\(aq در دایرکتوری جاری. بخش YYYY\-MM\-DD\-HH:MM:SS با تاریخ و زمان فعلی جایگزین خواهد شد.
.TP
.BI "\-\-debug\-file " FILE
فعال‌سازی خروجی اشکال‌زدایی برای
.B orca
و ارسال تمامی خروجی‌های اشکال‌زدایی به
.I FILE
داده‌شده.

.SH "تنظیمات صفحه‌کلید (KEYBOARD SETTINGS)"
برنامه Orca دو حالت چیدمان صفحه‌کلید رومیزی (Desktop) و لپ‌تاپ (Laptop) را ارائه می‌دهد.
.B Orca
از کلیدهای میان‌بر پیش‌فرض میزکار برای پیمایش و تعامل با برنامه‌ها استفاده می‌کند. از حالت یادگیری (learn mode) برای کشف تمام دستورهای موجود استفاده کنید.
.P
ترکیب کلیدهای زیر از کلید
.B Orca_Modifier
استفاده می‌کنند، که در چیدمان صفحه‌کلید رومیزی کلید
.B Insert
و در چیدمان صفحه‌کلید لپ‌تاپ کلید
.B Caps_Lock
است.
.TP
.B Orca_Modifier+H
ورود به حالت یادگیری. برای خروج، کلید Escape را فشار دهید.
.TP
.B Orca_Modifier+Space
باز کردن پنجرهٔ تنظیمات ترجیحات.
.TP
.B Orca_Modifier+Ctrl+Space
باز کردن پنجرهٔ تنظیمات ترجیحات برای برنامهٔ جاری.

.SH "فایل‌ها (FILES)"
.TP
.I ~/.local/share/orca/
دایرکتوری ترجیحات کاربر.
.TP
.I ~/.local/share/orca/orca\-customizations.py
فایل پیکربندی سفارشی‌سازی‌های کاربر.
.TP
.I ~/.local/share/orca/orca\-scripts/
دایرکتوری اسکریپت‌های کاربر.

.SH "نویسندگان (AUTHORS)"
.B Orca
در ابتدا به عنوان تلاشی جمعی به رهبری دفتر برنامه‌های دسترسی‌پذیریِ Sun Microsystems Inc. و با مشارکت بسیاری از اعضای جامعه شکل گرفت.
.SH "همچنین ببینید (SEE ALSO)"
.IP \(bu 2
.B مخزن و سامانه ردیابی اشکالات Orca
.UR https://gitlab.gnome.org/GNOME/orca
<https://gitlab.gnome.org/GNOME/orca>
.UE