.\"
.\" This file is part of the Detox package.
.\"
.\" Copyright (c) Doug Harple <detox.dharple@gmail.com>
.\"
.\" For the full copyright and license information, please view the LICENSE
.\" file that was distributed with this source code.
.\"
.Dd February 24, 2021
.Dt DETOX.TBL 5
.Os
.Sh "نام (NAME)"
.Nm detox.tbl
.Nd جدول ترجمه برای
.Xr detox 1
.Sh "نمای کلی (OVERVIEW)"
دستور
.Cm detox
امکان پیکربندی نحوه عملکرد فیلترهای safe، ISO-8859-1 و UTF-8 (Unicode) را فراهم می‌کند.
با استفاده از جدول‌های ترجمه مبتنی بر متن، می‌توان نحوه تفسیر این مجموعه‌های نویسه را تنظیم کرد.
.Sh "نحو (SYNTAX)"
قالب جدول‌های ترجمه ساده است.
دو سطح وجود دارد: یک سطح شامل متادیتا (داده‌های فراداده) و دیگری شامل ترجمه‌های واقعی.
.Bl -tag -width 0.25i
.It Cm default Ar _
گزینه default ترجمه پیش‌فرض را برای یک نویسه مشخص می‌کند.
یک مقدار پیش‌فرض خالی یا ناموجود نشان می‌دهد که هر نویسه ناشناخته باید به فیلتر بعدی واگذار شود.
به این ترتیب، امکان اتصال چندین جدول ترجمه به‌صورت متوالی و زنجیره‌ای فراهم می‌شود.
.It Cm start
نشان‌دهنده شروع یک فهرست مقادیر در جدول ترجمه است.
.It Cm start Ar lang
نشان‌دهنده شروع یک فهرست مقادیر ویژه یک زبان خاص در جدول ترجمه است.
.It Cm end
نشان‌دهنده پایان یک فهرست مقادیر در جدول ترجمه است.
.It Ar value translation
مقدار (value) را می‌توان در مبنای ده (1)، مبنای شانزده (0x01) یا مبنای هشت (01) مشخص کرد.
همان قوانینی که برای sscanf اعمال می‌شوند، در اینجا نیز برقرار هستند.
.Pp
ترجمه (translation) می‌تواند یک رشته ساده یا یک رشته درون نقل‌قول، با استفاده از کوتیشن تکی یا دوتایی باشد.
.El
.Sh "مثال‌ها (EXAMPLES)"
مثال زیر بخشی از یک جدول
.Ar safe
را نشان می‌دهد که در آن تنها جایگزینی چند نویسه مشخص شده است.
.Bd -literal
#
# This is a simple example of a "safe" table.  It only translates 4 characters.
#
# The default is commented out, so any character that is not in this table will
# be ignored.
#

# default   _

#
# This is the main replacement block.  Each line specifies a character and a
# string to replace it with.
#

start
0x09	_tab_		# comments work on lines, too
0x24	_dollar_	# $$$
0x26	_and_		# ampersand
end

#
# Starts an optional, language-specific translation block.  detox will read
# your locale and load the block if the word after start matches the language
# portion of your locale.
#
# In the example here, the character $ will be replaced with "_money_" if the
# user is working in English.  If the user is using a different language, $
# will be replaced with the value configured in the previous block, "_dollar_".
#

start en
0x24	_money_		# money money
end

# EOF
.Ed
.Pp
سپس می‌توانید این جدول را همراه با سایر فیلترها در فایل
.Pa ~/.detoxrc
خود فعال کنید.
.Bd -literal
.\" START SAMPLE
# Sample detoxrc

sequence default {
	safe {
		filename "/home/MYUSERNAME/.local/share/detox/safe.tbl";
	};
	safe;
	wipeup;
};

# EOF
.\" END SAMPLE
.Ed
.Pp
هنگامی که
.Cm detox
اجرا می‌شود، ابتدا فیلتر safe سفارشی را اجرا می‌کند، سپس فیلتر پیش‌فرض
.Ar safe
و در نهایت فیلتر
.Ar wipeup
را اجرا خواهد کرد.
برای جزئیات بیشتر در مورد انواع مختلف فیلترها، به
.Xr detoxrc 5
مراجعه کنید.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr detox 1 ,
.Xr detoxrc 5 ,
.Xr ascii 7 ,
.Xr iso_8859-1 7 ,
.Xr unicode 7 ,
.Xr utf-8 7
.Sh "نویسندگان (AUTHORS)"
برنامه detox توسط
.An "Doug Harple"
نوشته شده است.