INLINE-DETOX(1) General Commands Manual INLINE-DETOX(1)

inline-detox — پاکسازی نام پرونده‌ها (مبتنی بر جریان)

inline-detox [-f configfile] [-s sequence] [-v] inline-detox [-f configfile] [-s sequence] [-v] file ... inline-detox [-L] [-f configfile] [-v] inline-detox [-h | --help] inline-detox [-V]

ابزار inline-detox نام‌های جدیدی برای پرونده‌ها ایجاد می‌کند تا کار با آن‌ها در لینوکس و سایر سیستم‌عامل‌های شبه‌یونیکس ساده‌تر شود. این ابزار نویسه‌هایی را که تایپ نام پرونده را دشوار می‌کنند، با خط تیره و زیرخط جایگزین می‌کند. همچنین فیلترهای مبتنی بر تبدیل کدگذاری را فراهم می‌آورد که ISO-8859-1 یا CP-1252 را به UTF-8 تبدیل می‌کنند. یک فیلتر اضافی نیز نام پرونده‌های فرار داده‌شده به شیوه CGI را واگردانی (unescape) می‌کند.

inline-detox نام پرونده‌ها را از جریان ورودی خوانده و نام‌های به‌روزشده را در جریان خروجی می‌نویسد.

اگر نام پرونده‌ای در خط فرمان فرستاده شود، inline-detox این پرونده را می‌خواند و هر خط را پیش از نوشتن در جریان خروجی پردازش می‌کند.

اجرای detox --inline دقیقاً هم‌ارز با اجرای inline-detox است.

inline-detox توسط مجموعه‌ای پیکربندی‌پذیر از فیلترها به نام توالی (sequence) هدایت می‌شود. توالی‌ها با جزئیات بیشتر در detoxrc(5) توضیح داده شده‌اند و با گزینه -L قابل بررسی و مشاهده هستند. توالی پیش‌فرض، فیلترهای safe و wipeup را اجرا می‌کند. نمونه‌های دیگر از توالی‌های از پیش پیکربندی‌شده شامل iso8859_1 و iso8859_1-legacy هستند که هر دو تبدیل به UTF-8 را انجام داده و سپس با فیلترهای safe و wipeup به پایان می‌رسند.

configfile
استفاده از configfile به‌جای پرونده‌های پیکربندی پیش‌فرض برای بارگذاری توالی‌های تبدیل. هیچ پرونده پیکربندی دیگری پردازش نخواهد شد.
, --help
نمایش اطلاعات راهنما.
فهرست کردن توالی‌های موجود فعلی. هنگام استفاده به همراه -v این گزینه نشان می‌دهد چه فیلترهایی در هر توالی استفاده شده‌اند و چه ویژگی‌هایی روی فیلترها اعمال شده است.
sequence
استفاده از sequence به‌جای default.
نمایش اطلاعات با جزئیات کامل درباره پرونده‌هایی که تغییر نام می‌یابند.
نمایش نسخه فعلی inline-detox.

/etc/detoxrc
پرونده سراسری detoxrc در سطح سیستم.
~/.detoxrc
پرونده شخصی detoxrc کاربر. به‌طور معمول این پرونده detoxrc سراسری سیستم را گسترش می‌دهد، مگر اینکه -f مشخص شده باشد که در این صورت نادیده گرفته می‌شود.
/usr/share/detox/cp1252.tbl
جدول ارائه‌شده برای تبدیل کدگذاری CP-1252.
/usr/share/detox/iso8859_1.tbl
جدول ارائه‌شده برای تبدیل کدگذاری ISO-8859-1.
/usr/share/detox/safe.tbl
جدول ارائه‌شده برای ترجمه نویسه‌های امن (safe).
/usr/share/detox/unicode.tbl
جدول ارائه‌شده برای فیلتر کردن نویسه‌های کنترلی یونیکد، مورد استفاده توسط فیلتر UTF-8.

echo Foo Bar | inline-detox -s lower -v
توالی lower را اجرا می‌کند، هرگونه تغییر را فهرست کرده و نتیجه را به جریان خروجی بازمی‌گرداند.

detox(1), detox.tbl(5), detoxrc(5), ascii(7), iso_8859-1(7), unicode(7), utf-8(7)

inline-detox در ابتدا برای پاکسازی پرونده‌هایی طراحی شده بود که از دوستان دریافت می‌کردم و با استفاده از سیستم‌عامل‌های دیگر ایجاد شده بودند. ایجاد نام پرونده با فاصله، پرانتز، براکت و علامت آمپرسند در برخی سیستم‌عامل‌ها امری متداول است. این نویسه‌ها در FreeBSD و لینوکس معنای خاصی دارند و هنگام دسترسی به آن‌ها مشکل ایجاد می‌کنند. من inline-detox را برای پاکسازی این پرونده‌ها ساختم.

در نسخه 2.0 از تبدیل نویسه‌ها (transliteration) به‌صورت پیش‌فرض کاسته شد و در عوض بر سهولت استفاده تمرکز گردید. در نسخه 3.0 با حذف بخش عمده تبدیل نویسه‌ها از جدول‌ها، این رویکرد بیش از پیش تغییر یافت. انگیزه‌های اصلی این کار، بازخوردهای کاربران و این واقعیت بود که بسیاری از سیستم‌عامل‌های مدرن شبه‌یونیکس از UTF-8 به‌عنوان مجموعه نویسه‌های اصلی خود استفاده می‌کنند. تبدیل نویسه‌ها از UTF-8 به ASCII در این شرایط همراه با افت اطلاعات و بی‌فایده است.

inline-detox توسط Doug Harple نوشته شده است.

March 31, 2024 Linux 6.12.107+deb13-amd64