.\" .\" This file is part of the Detox package. .\" .\" Copyright (c) Doug Harple .\" .\" For the full copyright and license information, please view the LICENSE .\" file that was distributed with this source code. .\" .Dd March 31, 2024 .Dt INLINE-DETOX 1 .Os .Sh "نام (NAME)" .Nm inline-detox .Nd پاکسازی نام پرونده‌ها (مبتنی بر جریان) .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Op Fl f Pa configfile .Op Fl s Ar sequence .Op Fl v .Nm .Op Fl f Pa configfile .Op Fl s Ar sequence .Op Fl v .Ar .Nm .Op Fl L .Op Fl f Pa configfile .Op Fl v .Nm .Op Fl h | -help .Nm .Op Fl V .Sh "توضیحات (DESCRIPTION)" ابزار .Nm نام‌های جدیدی برای پرونده‌ها ایجاد می‌کند تا کار با آن‌ها در لینوکس و سایر سیستم‌عامل‌های شبه‌یونیکس ساده‌تر شود. این ابزار نویسه‌هایی را که تایپ نام پرونده را دشوار می‌کنند، با خط تیره و زیرخط جایگزین می‌کند. همچنین فیلترهای مبتنی بر تبدیل کدگذاری را فراهم می‌آورد که ISO-8859-1 یا CP-1252 را به UTF-8 تبدیل می‌کنند. یک فیلتر اضافی نیز نام پرونده‌های فرار داده‌شده به شیوه CGI را واگردانی (unescape) می‌کند. .Pp .Nm نام پرونده‌ها را از جریان ورودی خوانده و نام‌های به‌روزشده را در جریان خروجی می‌نویسد. .Pp اگر نام پرونده‌ای در خط فرمان فرستاده شود، .Nm این پرونده را می‌خواند و هر خط را پیش از نوشتن در جریان خروجی پردازش می‌کند. .Pp اجرای .Cm detox .Fl -inline دقیقاً هم‌ارز با اجرای .Nm است. .Ss توالی‌ها (Sequences) .Nm توسط مجموعه‌ای پیکربندی‌پذیر از فیلترها به نام توالی (sequence) هدایت می‌شود. توالی‌ها با جزئیات بیشتر در .Xr detoxrc 5 توضیح داده شده‌اند و با گزینه .Fl L قابل بررسی و مشاهده هستند. توالی پیش‌فرض، فیلترهای .Ar safe و .Ar wipeup را اجرا می‌کند. نمونه‌های دیگر از توالی‌های از پیش پیکربندی‌شده شامل .Ar iso8859_1 و .Ar iso8859_1-legacy هستند که هر دو تبدیل به UTF-8 را انجام داده و سپس با فیلترهای .Ar safe و .Ar wipeup به پایان می‌رسند. .Ss گزینه‌ها (Options) .Bl -tag -width Fl .It Fl f Pa configfile استفاده از .Pa configfile به‌جای پرونده‌های پیکربندی پیش‌فرض برای بارگذاری توالی‌های تبدیل. هیچ پرونده پیکربندی دیگری پردازش نخواهد شد. .It Fl h , -help نمایش اطلاعات راهنما. .It Fl L فهرست کردن توالی‌های موجود فعلی. هنگام استفاده به همراه .Fl v این گزینه نشان می‌دهد چه فیلترهایی در هر توالی استفاده شده‌اند و چه ویژگی‌هایی روی فیلترها اعمال شده است. .It Fl s Ar sequence استفاده از .Ar sequence به‌جای .Cm default . .It Fl v نمایش اطلاعات با جزئیات کامل درباره پرونده‌هایی که تغییر نام می‌یابند. .It Fl V نمایش نسخه فعلی .Nm . .El .Sh "فایل‌ها (FILES)" .Bl -tag -width Fl .It Pa /etc/detoxrc پرونده سراسری detoxrc در سطح سیستم. .It Pa ~/.detoxrc پرونده شخصی detoxrc کاربر. به‌طور معمول این پرونده .Pa detoxrc سراسری سیستم را گسترش می‌دهد، مگر اینکه .Fl f مشخص شده باشد که در این صورت نادیده گرفته می‌شود. .It Pa /usr/share/detox/cp1252.tbl جدول ارائه‌شده برای تبدیل کدگذاری CP-1252. .It Pa /usr/share/detox/iso8859_1.tbl جدول ارائه‌شده برای تبدیل کدگذاری ISO-8859-1. .It Pa /usr/share/detox/safe.tbl جدول ارائه‌شده برای ترجمه نویسه‌های امن (safe). .It Pa /usr/share/detox/unicode.tbl جدول ارائه‌شده برای فیلتر کردن نویسه‌های کنترلی یونیکد، مورد استفاده توسط فیلتر UTF-8. .El .Sh "مثال‌ها (EXAMPLES)" .Bl -tag -width Fl .It echo "Foo Bar" | Nm Fl s Ar lower Fl v توالی .Ar lower را اجرا می‌کند، هرگونه تغییر را فهرست کرده و نتیجه را به جریان خروجی بازمی‌گرداند. .El .Sh "همچنین ببینید (SEE ALSO)" .Xr detox 1 , .Xr detox.tbl 5 , .Xr detoxrc 5 , .Xr ascii 7 , .Xr iso_8859-1 7 , .Xr unicode 7 , .Xr utf-8 7 .Sh "تاریخچه (HISTORY)" .Nm در ابتدا برای پاکسازی پرونده‌هایی طراحی شده بود که از دوستان دریافت می‌کردم و با استفاده از سیستم‌عامل‌های دیگر ایجاد شده بودند. ایجاد نام پرونده با فاصله، پرانتز، براکت و علامت آمپرسند در برخی سیستم‌عامل‌ها امری متداول است. این نویسه‌ها در .Fx و لینوکس معنای خاصی دارند و هنگام دسترسی به آن‌ها مشکل ایجاد می‌کنند. من .Nm را برای پاکسازی این پرونده‌ها ساختم. .Pp در نسخه 2.0 از تبدیل نویسه‌ها (transliteration) به‌صورت پیش‌فرض کاسته شد و در عوض بر سهولت استفاده تمرکز گردید. در نسخه 3.0 با حذف بخش عمده تبدیل نویسه‌ها از جدول‌ها، این رویکرد بیش از پیش تغییر یافت. انگیزه‌های اصلی این کار، بازخوردهای کاربران و این واقعیت بود که بسیاری از سیستم‌عامل‌های مدرن شبه‌یونیکس از UTF-8 به‌عنوان مجموعه نویسه‌های اصلی خود استفاده می‌کنند. تبدیل نویسه‌ها از UTF-8 به ASCII در این شرایط همراه با افت اطلاعات و بی‌فایده است. .Sh "نویسندگان (AUTHORS)" .Nm توسط .An Doug Harple نوشته شده است.