'\" t .\" Copyright (c) 2001-2017, Nadav Har'El and Dan Kenigsberg .TH hspell 1 "24 June 2017" "Hspell 1.4" "دستورات کاربر" .SH "نام (NAME)" hspell \- غلط‌یاب املایی زبان عبری .SH "خلاصه دستور (SYNOPSIS)" .B hspell [ .B \-acDhHilnsvV ] .BI [\| file\|.\|.\|. \|] .SH "توضیحات (DESCRIPTION)" دستور .B hspell تلاش می‌کند تا کلمات با املای نادرست عبری را در فایل‌های ورودی خود پیدا کند. .PP مشابه با دستور سنتی spell(1) در یونیکس، .B hspell فهرست مرتب‌شده‌ای از کلمات نادرست را در خروجی نمایش می‌دهد و فاقد رابطی کاربرپسندتر برای اعمال خودکار تصحیحات برای شما است. با این حال، بر خلاف spell(1)، .B hspell می‌تواند تصحیحات احتمالی را برای برخی خطاهای املایی پیشنهاد دهد. چنین پیشنهادهایی را می‌توان با گزینه‌های .B \-c (تصحیح) و .B \-n (یادداشت‌ها) فعال کرد. .PP در حال حاضر .B Hspell انتظار دارد فایل‌های ورودی با کدگذاری ISO-8859-8 باشند. کاراکترهای غیرعبری در فایل‌های ورودی نادیده گرفته می‌شوند، که امکان غلط‌یابی املایی آسان متن‌های دوزبانه عبری-انگلیسی و همچنین فایل‌های HTML یا TeX را فراهم می‌آورد. اگر قرار است فایل‌هایی با کدگذاری متفاوت (مانند UTF-8) بررسی شوند، ابتدا باید به ISO-8859-8 تبدیل شوند (برای نمونه، iconv(1) و recode(1) را ببینید). .PP خروجی نیز با کدگذاری ISO-8859-8 و در اصطلاح به ترتیب منطقی (logical order) خواهد بود، بنابراین معمولاً سودمند است که پیش از مشاهده، آن را به bidiv(1) هدایت (pipe) کنید، مانند: .PP .RS .B "hspell -c filename | bidiv | less" .RE .PP اگر هیچ فایل ورودی مشخص نشود، .B hspell از ورودی استاندارد خود می‌خواند. .SH "گزینه‌ها (OPTIONS)" .TP .B \-v اگر گزینه .B \-v مشخص شود، .B hspell اطلاعات نسخه مناسب برای emacs را چاپ کرده و خارج می‌شود. .TP .B \-vv تکرار گزینه .B \-v باعث می‌شود که .B hspell اطلاعاتی درباره اینکه کدام ویژگی‌های اختیاری در زمان کامپایل فعال شده‌اند نیز نمایش دهد. .TP .B \-V با گزینه .B \-V دستور .B hspell اطلاعات نسخه واقعی و خوانا برای انسان را چاپ کرده و خارج می‌شود. .TP .B \-c اگر گزینه .B \-c مشخص شود، .B hspell هر زمان که بتواند تصحیحاتی بیابد، اصلاحات پیشنهادی برای کلمات با املای نادرست را ارائه می‌دهد. سازوکار تصحیح در این نسخه به ویژه در یافتن اصلاحات برای املای نادرست بدون حرکت (بدون niqqud)، با 'immot-qri'a جاافتاده یا اضافه بسیار خوب عمل می‌کند. .TP .B \-n گزینه .B \-n چند "یادداشت" طولانی‌تر درباره برخی خطاهای املایی ارائه می‌دهد و توضیح می‌دهد که چرا این موارد واقعاً خطا هستند (یا در چه مواردی استفاده از این کلمه در واقع درست است). توصیه می‌شود برای دریافت حداکثر کمک تصحیحی از .BR hspell ، دو گزینه را با هم ترکیب کنید: .BR \-cn . .TP .B \-l گزینه .B \-l (اطلاعات زبان‌شناختی) برای هر کلمه .I درست توضیح می‌دهد که چرا شناخته شده است (اسم پایه، فعل و غیره‌ای را که این تصریف به آن مربوط می‌شود، و زمان، جنسیت، Kinnuy وابسته به آن یا سایر اطلاعات مرتبط را نشان می‌دهد). .PP اگر Hspell بدون پشتیبانی از تحلیل صرفی (مورفولوژیکی) ساخته شده باشد، این گزینه تنها تفکیک‌های صحیح کلمه داده‌شده به پیشوند + کلمه را نشان می‌دهد، زیرا اطلاعات کامل باعث افزایش ۴ برابری در حجم نصب برنامه می‌شود. .PP مشخص کردن گزینه .B \-c علاوه بر .B \-l منجر به رفتار ویژه‌ای می‌شود. در این حالت .B hspell برای هر کلمه (صرف‌نظر از اینکه در لغت‌نامه باشد یا نه) "تصحیحات" پیشنهاد می‌دهد و اطلاعات زبان‌شناختی را برای تمام آن کلمات نشان می‌دهد. این می‌تواند برای یک برنامه خواننده مفید باشد که همچنین ممکن است بخواهد غلط‌های املایی و معانی احتمالی آن‌ها را درک کند. .TP .B \-s به طور معمول، کلماتی که غلط املایی تشخیص داده شده‌اند به ترتیب الفبایی نمایش داده می‌شوند. گزینه .B \-s آن‌ها را بر اساس .IR شدت ، یعنی خطاهایی که با بیشترین بسامد در سند تکرار شده‌اند، ابتدا نمایش می‌دهد. این گزینه بیش از همه برای افرادی مفید است که در ساخت فهرست واژگان .B hspell کمک می‌کنند و به دنبال کلمات درست رایجی هستند که .B hspell هنوز نمی‌شناسد. .TP .B \-a با گزینه .B \-a دستور .B hspell تلاش می‌کند تا رابط لوله (pipe) ابزار .B ispell را (تا حد ممکن محدود) شبیه‌سازی کند. این به برنامه‌هایی مانند .B Lyx, Emacs, Geresh و .B KDE امکان می‌دهد تا از .B hspell به عنوان یک غلط‌یاب املایی بیرونی استفاده کنند. .TP .B \-i این گزینه تنها زمانی اثر دارد که همراه با گزینه .B \-a استفاده شود. به طور معمول، .B hspell \-a تنها املای کلمات عبری را بررسی می‌کند. اگر فایل داده‌شده حاوی کلمات غیرعبری (مانند کلمات انگلیسی) نیز باشد، آن‌ها به سادگی نادیده گرفته می‌شوند. افزودن گزینه .B \-i به .B hspell می‌گوید که کلمات غیرعبری را به .BR ispell (1) ارسال کند و پاسخ آن را به عنوان پاسخی از سوی .B hspell بازگرداند. این امکان غلط‌یابی املایی آسان اسناد ترکیبی عبری-انگلیسی را فراهم می‌کند. .PP اجرای .B hspell با نام برنامه .B hspell-i نیز گزینه .B -i را فعال می‌کند. این یک ترفند مفید است زمانی که یک برنامه فقط نام یک برنامه غلط‌یاب املایی را می‌پذیرد و تنها گزینه "\-a" را به آن اضافه می‌کند (بدون دادن امکان افزودن "\-i" به کاربر). اسکریپت .B multispell همراه با .B hspell هدف مشابهی را با کنترل بیشتر بر کدگذاری‌ها و اینکه کدام غلط‌یاب برای کلمات غیرعبری اجرا شود، برآورده می‌کند. .TP .B \-H به‌طور پیش‌فرض، Hspell پیشوند He Ha-sh'ela را مجاز نمی‌داند. این به این دلیل است که این پیشوند معمولاً در عبری مدرن استفاده نمی‌شود و موارد منفی کاذب زیادی ایجاد می‌کند (خطاها، مانند He به دنبال اسمی که دارای مالکیت است، درست پنداشته می‌شوند). گزینه .B \-H با این وجود به Hspell می‌گوید این پیشوند را مجاز بداند. .TP .B \-D base بارگذاری فهرست‌های کلمات از مسیر پایه مشخص‌شده، به جای مسیر پیش‌فرض کامپایل‌شده در برنامه. این گزینه بیشتر برای آزمودن Hspell استفاده می‌شود، زمانی که لغت‌نامه‌ها در دایرکتوری جاری کامپایل شده‌اند و hspell به صورت "hspell \-Dhebrew.wgz" اجرا می‌شود. .TP .B \-d, \-B, \-m, \-T, \-C, \-S, \-P, \-p, \-w, and \-W این گزینه‌ها توسط .B lyx یا سایر برنامه‌ها با این تصور که در حال ارتباط با ispell هستند، به .B hspell ارسال می‌شوند. این گزینه‌ها با احترام نادیده گرفته می‌شوند. .SH "استاندارد املایی (SPELLING STANDARD)" برنامه Hspell طوری طراحی شده است که ۱۰۰٪ و به طور دقیق با قواعد املایی رسمی بدون حرکت ("Ha-ktiv Khasar Ha-niqqud" که در گفتار عامیانه با نام "Ktiv Male" شناخته می‌شود) منتشرشده توسط فرهنگستان زبان عبری مطابقت داشته باشد. .PP بسته به دیدگاه شما، این موضوع هم یک مزیت و هم یک عیب است. این یک مزیت است زیرا سبک املایی .B صحیح و یکدستی را در سرتاسر نوشته‌های شما ترویج می‌دهد. و یک عیب است زیرا تعداد کمی از تصمیمات املایی رسمی فرهنگستان برای عموم مردم نسبتاً ناشناخته است. .PP کاربران Hspell (و در واقع تمامی نویسندگان عبری) تشویق می‌شوند قواعد رسمی املای بدون حرکت فرهنگستان را بخوانند (که در پایان اکثر فرهنگ‌های لغت عبری مدرن چاپ شده است، و یک نسخه خلاصه‌شده از آن در در دسترس است). کاربران همچنین تشویق می‌شوند به فرهنگ‌های لغت عبری که از املای بدون حرکت استفاده می‌کنند مراجعه کنند (مانند Millon Ha-hove، Rav Milim، و Even Shoshan جدید). .PP بسته توزیع Hspell (و وب‌سایت آن) همچنین شامل سندی به نام .BR niqqudless.odt است که استاندارد املایی Hspell را به تفصیل (به زبان عبری) توضیح می‌دهد. این سند هم اصول کلی و هم چرایی املای خاص برخی کلمات را تشریح می‌کند. .PP یک نسخه در آینده ممکن است شامل گزینه‌ای برای استانداردهای املایی جایگزین باشد. .SH "پشت صحنه (BEHIND THE SCENES)" خود برنامه .B hspell عمدتاً یک برنامه ساده (اما کارآمد) است که کلمات ورودی را در برابر یک فهرست طولانی از کلمات معتبر بررسی می‌کند. "مغز متفکر" واقعی پشت آن، فهرست‌های واژگان (فرهنگ لغت) ارائه‌شده توسط پروژه Hspell است. .PP به منظور اینکه این فرهنگ لغت کاملاً عاری از محدودیت‌های حق نشر دیگران باشد، پروژه Hspell یک پیاده‌سازی مستقل و از پایه (clean-room) است که بر اساس فهرست‌های کلمات یا غلط‌یاب‌های املایی از پیش موجود یا کپی‌برداری از لغت‌نامه‌های چاپی ساخته نشده است. .PP همچنین فهرست واژگان بر اساس اسکن خودکار اسناد در دسترس عبری (مانند روزنامه‌های آنلاین) نیست، زیرا هیچ راهی وجود ندارد که تضمین کند چنین فهرستی صحیح، کامل، یا در استاندارد املایی خود یکدست خواهد بود. .PP در عوض، ایده ما نوشتن برنامه‌هایی بود که می‌دانند چگونه اسم‌های عبری را به درستی تصریف و افعال عبری را صرف کنند. ورودی این برنامه‌ها فهرستی از ریشه‌های اسمی و ریشه‌های فعلی، به همراه راهنمایی‌های لازم برای صرف صحیح در مواردی است که نمی‌توان آن‌ها را به صورت خودکار محاسبه کرد. بیشتر تلاشی که صرف پروژه Hspell شد، صرف ساخت این فایل‌های ورودی گردید. سپس، "تولیدکننده‌های فهرست کلمات" (نوشته‌شده به زبان Perl، که آن‌ها نیز بخشی از پروژه Hspell هستند) فهرست کامل کلمات صرف‌شده را تولید می‌کنند که توسط برنامه غلط‌یاب املایی، hspell، استفاده خواهد شد. این فرآیند تولید تنها یک بار هنگام ساخت .B hspell از سورس انجام می‌شود. .PP این فهرست‌ها، قبل و بعد از صرف، ممکن است برای مواردی بسیار فراتر از غلط‌یابی املایی مفید باشند. تحلیل صرفی (که .B hspell با گزینه .B \-l ارائه می‌دهد) یک نمونه است. برای ایده‌های بیشتر، به وب‌سایت پروژه Hspell در مراجعه کنید. .SH "فایل‌ها (FILES)" .TP ~/.hspell_words, ./hspell_words این فایل‌ها در صورت وجود، باید حاوی فهرستی از کلمات عبری باشند که .B hspell آن‌ها را نیز به عنوان کلمات صحیح می‌پذیرد. .PP توجه داشته باشید که تنها .I دقیقاً همین کلمات اضافه خواهند شد - آن‌ها صرف نمی‌شوند و پیشوندها به طور خودکار مجاز نخواهند بود. .TP /usr/local/share/hspell/* فهرست‌های استاندارد کلمات عبری مورد استفاده توسط .BR hspell . .SH "وضعیت خروج (EXIT STATUS)" در حال حاضر همیشه 0 است. .SH "نسخه (VERSION)" نسخه .B hspell توصیف‌شده در این صفحه راهنما ۱.۴ است. .SH "حق نشر (COPYRIGHT)" حق نشر (C) 2000-2017، متعلق به Nadav Har'El و Dan Kenigsberg . .PP نرم‌افزار Hspell یک نرم‌افزار آزاد است که تحت مجوز عمومی همگانی آفرو گنو (AGPL) نسخه ۳ منتشر شده است. توجه داشته باشید که نه تنها برنامه‌های موجود در بسته توزیع، بلکه فایل‌های فرهنگ لغت و فهرست‌های کلمات تولیدشده نیز تحت مجوز AGPL هستند. هیچ‌گونه ضمانتی از هیچ نوعی وجود ندارد. .PP برای اطلاعات بیشتر و شرایط دقیق مجوز به فایل LICENSE مراجعه کنید. .PP جدیدترین نسخه این نرم‌افزار را می‌توان در یافت. .SH "قدردانی (ACKNOWLEDGMENTS)" ابزار hspell و پایگاه‌های داده زبان‌شناختی پشت آن (که در مجموع "پروژه Hspell" نامیده می‌شوند) توسط Nadav Har'El و Dan Kenigsberg ایجاد شده‌اند. .PP اگرچه ما تمام کدهای Hspell را خودمان نوشتیم، اما واقعاً مدیون پیشگامان سبک قدیمی "متن‌باز" هستیم - افرادی که به جای پنهان کردن دانش خود در نرم‌افزارهای مالکیتی، کتاب نوشتند. برای تصریف صحیح اسم‌ها، "کتاب جامع اسم" اثر دکتر Shaul Barkali کمک بزرگی بوده است. جزوه پروفسور Uzzi Ornan با عنوان "صرف فعل در نمودارهای جریان" در پیاده‌سازی صرف فعل بسیار اثرگذار بوده و "کتاب جامع فعل" اثر Barkali نیز استفاده شد. .PP در طول کار خود از تعدادی فرهنگ لغت عبری از جمله Even Shoshan، Millon Ha-hove و Rav-Milim به طور گسترده برای اطمینان از صحت کلمات خاص استفاده کرده‌ایم. روزنامه‌ها و کتاب‌های مختلف عبری، چه چاپی و چه آنلاین، برای الهام‌بخشی و یافتن کلماتی که هنوز نمی‌شناسیم استفاده شدند. .PP مایلیم از Cilla Tuviana و دکتر Zvi Har'El برای کمک‌هایشان در پاسخ به برخی پرسش‌های دستور زبان تشکر کنیم. .PP چندین نفر دیگر نیز در نسخه‌های مختلف با پیشنهادات، اصلاحات یا وصله‌ها به ما کمک کردند - نام آن‌ها در فایل WHATSNEW در بسته توزیع فهرست شده است. .SH "همچنین ببینید (SEE ALSO)" .BR hspell (3), .BR spell (1), .BR ispell (1), .BR bidiv (1), .BR iconv (1), .BR recode (1) .SH "اشکالات (BUGS)" این صفحه راهنما در اصل به زبان انگلیسی نوشته شده است. .PP برای دوستداران رابط کاربری گرافیکی (GUI)، رابط کاربری .B hspell یک کابوس است. با این حال، همان‌طور که برنامه‌های بیشتر و بیشتری یاد می‌گیرند که با .B hspell ارتباط برقرار کنند، و همان‌طور که داده‌های Hspell در غلط‌یاب‌های املایی چندزبانه (مانند aspell و hunspell) در دسترس قرار می‌گیرد، این دیگر یک مشکل نخواهد بود. برای دستورالعمل‌های نحوه استفاده از Hspell در انواع برنامه‌ها به مراجعه کنید. .PP محدود بودن .B hspell به کدگذاری ISO-8859-8 و عدم شناسایی UTF-8 یا حتی CP1255 (شامل اعراب/niqqud)، امروزه یک نابهنگامی زمانی (anachronism) است.