نام (NAME)

detox.tbl — جدول ترجمه برای detox(1)

نمای کلی (OVERVIEW)

دستور detox امکان پیکربندی نحوه عملکرد فیلترهای safe، ISO-8859-1 و UTF-8 (Unicode) را فراهم می‌کند. با استفاده از جدول‌های ترجمه مبتنی بر متن، می‌توان نحوه تفسیر این مجموعه‌های نویسه را تنظیم کرد.

نحو (SYNTAX)

قالب جدول‌های ترجمه ساده است. دو سطح وجود دارد: یک سطح شامل متادیتا (داده‌های فراداده) و دیگری شامل ترجمه‌های واقعی.

default _

گزینه default ترجمه پیش‌فرض را برای یک نویسه مشخص می‌کند. یک مقدار پیش‌فرض خالی یا ناموجود نشان می‌دهد که هر نویسه ناشناخته باید به فیلتر بعدی واگذار شود. به این ترتیب، امکان اتصال چندین جدول ترجمه به‌صورت متوالی و زنجیره‌ای فراهم می‌شود.

start

نشان‌دهنده شروع یک فهرست مقادیر در جدول ترجمه است.

start lang

نشان‌دهنده شروع یک فهرست مقادیر ویژه یک زبان خاص در جدول ترجمه است.

end

نشان‌دهنده پایان یک فهرست مقادیر در جدول ترجمه است.

value translation

مقدار (value) را می‌توان در مبنای ده (1)، مبنای شانزده (0x01) یا مبنای هشت (01) مشخص کرد. همان قوانینی که برای sscanf اعمال می‌شوند، در اینجا نیز برقرار هستند.

ترجمه (translation) می‌تواند یک رشته ساده یا یک رشته درون نقل‌قول، با استفاده از کوتیشن تکی یا دوتایی باشد.

مثال‌ها (EXAMPLES)

مثال زیر بخشی از یک جدول safe را نشان می‌دهد که در آن تنها جایگزینی چند نویسه مشخص شده است.

#
# 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

سپس می‌توانید این جدول را همراه با سایر فیلترها در فایل ~/.detoxrc خود فعال کنید.

# Sample detoxrc

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

# EOF

هنگامی که detox اجرا می‌شود، ابتدا فیلتر safe سفارشی را اجرا می‌کند، سپس فیلتر پیش‌فرض safe و در نهایت فیلتر wipeup را اجرا خواهد کرد. برای جزئیات بیشتر در مورد انواع مختلف فیلترها، به detoxrc(5) مراجعه کنید.

همچنین ببینید (SEE ALSO)

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

نویسندگان (AUTHORS)

برنامه detox توسط Doug Harple نوشته شده است.