.\" Automatically generated by Pandoc 3.9.0.2
.\"
.TH "CHA-URIMETHODMAP" "5"
.SH "نام (NAME)"
cha\-urimethodmap \- پشتیبانی از نگاشت روش‌های URI در مرورگر وب Chawan
.SH "توضیحات (DESCRIPTION)"
مرورگر Chawan می‌تواند برای نگاشت پروتکل‌های ناشناخته به پروتکل‌های شناخته‌شده با استفاده از قالب \f[I]urimethodmap\f[R] به کار رود.
.PP
کاربرد اصلی این قابلیت، پیاده‌سازی گرداننده‌ها برای پروتکل‌های ناشناخته برای Chawan از طریق پروتکلی است که مرورگر درک می‌کند.
.SS "مسیر جستجو (Search path)"
مسیر جستجوی فایل‌های urimethodmap را می‌توان با استفاده از متغیر پیکربندی \f[CR]external.urimethodmap\f[R] بازنویسی کرد.
.PP
مسیر پیش‌فرض جستجو برای فایل‌های urimethodmap عبارت است از:
.IP
.EX
$CHA_DIR/urimethodmap:$HOME/.urimethodmap:/etc/urimethodmap
.EE
.SS "قالب (Format)"
قالب urimethodmap به‌طور ۱:۱ از w3m اقتباس شده است، با برخی اصلاحات در تفسیر الگوها.
.PP
تلاشی تقریبی برای توصیف رسمی این ساختار:
.IP
.EX
URIMethodMap\-File = *URIMethodMap\-line

URIMethodMap\-Line = Comment / URIMethodMap\-Entry

URIMethodMap\-Entry = Protocol *WHITESPACE Template *WHITESPACE CR

Protocol = 1*CHAR COLON

Template = [see below]

Comment = *WHITESPACE CR / \(dq#\(dq *CHAR CR
.EE
.PP
توجه داشته باشید که یک علامت دونقطه اسکی (:) باید پس از نام پروتکل وجود داشته باشد.
با این حال، می‌توان از فاصله خالی صرف‌نظر کرد.
.PP
مثال‌ها:
.IP
.EX
# این مورد صحیح است:
protocol:	/cgi\-bin/interpret\-protocol?%s
# این مورد نیز صحیح است:
protocol:/cgi\-bin/interpret\-protocol?%s
# فاصله‌ها و تب‌ها هر دو مجاز هستند، بنابراین این نیز صحیح است:
protocol:	/cgi\-bin/interpret\-protocol?%s
# اما این مورد نادرست است، زیرا علامت دونقطه وجود ندارد:
protocol	/cgi\-bin/interpret\-protocol?%s
.EE
.PP
الگوی بازهدایت همان نشانی وب (URL) مقصد است.
اگر رشته \f[CR]%s\f[R] در الگو گنجانده شده باشد، با نشانی وب مقصد جایگزین خواهد شد.
.PP
برای سازگاری با w3m، الگوهایی که با \f[CR]/cgi\-bin/\f[R] و \f[CR]file:/cgi\-bin/\f[R] آغاز می‌شوند وضعیت خاص دارند و رشته ابتدایی با \f[CR]cgi\-bin:\f[R] جایگزین می‌شود.
بنابراین برای مثال، الگوی \f[CR]/cgi\-bin/w3mdict.cgi\f[R] همانند \f[CR]cgi\-bin:w3mdict.cgi\f[R] است (و همچنین مانند \f[CR]file:/cgi\-bin/w3mdict.cgi\f[R]).
.PP
مثال:
.IP
.EX
# موارد زیر در Chawan یکسان هستند:
protocol:	/cgi\-bin/interpret\-protocol?%s
protocol:	file:/cgi\-bin/interpret\-protocol?%s
# نکته: این مدخل آخر در w3m کار نمی‌کند.
protocol:	cgi\-bin:interpret\-protocol?%s
.EE
.PP
با این حال توجه داشته باشید که مسیرهای مطلق به اسکریپت‌های cgi وضعیت خاص در نظر گرفته نمی‌شوند؛ بنابراین برای نمونه \f[CR]file:///usr/local/libexec/w3m/cgi\-bin/w3mdict.cgi\f[R] صرفاً w3mdict.cgi را در نمایش‌دهنده پرونده باز خواهد کرد.
(برخلاف w3m که در آن ممکن بود بسته به پیکربندی کاربر، \f[CR]w3mdict.cgi\f[R] اجرا شود.)
.SH "مثال‌ها (EXAMPLES)"
سطرهای زیر باید در \f[CR]$CHA_DIR/urimethodmap\f[R] مشخص شوند
(که در آن \f[CR]$CHA_DIR\f[R] بسته به مکان config.toml شما، یا \(ti/.chawan است یا \(ti/.config/chawan).
.SS magnet.cgi
.IP
.EX
# استفاده از اسکریپت شل CGI به نام \(gamagnet.cgi\(ga برای ارسال پیوندهای مگنت به Transmission.
magnet:		/cgi\-bin/magnet.cgi?%s
.EE
.PP
فایل \f[CR]magnet.cgi\f[R] را می‌توان در دایرکتوری \f[CR]bonus/\f[R] یافت.
همچنین می‌توانید یک لفاف (wrapper) محلی CGI بنویسید تا پیوندها را به کلاینت بیت‌تورنت دلخواه شما منتقل کند.
.SS dict
در w3m، از urimethodmap معمولاً برای تعریف میان‌برها (shorthands) برای اسکریپت‌های CGI سوءاستفاده می‌شود.
.PP
این قابلیت در Chawan نیز کار می‌کند؛ برای نمونه، می‌توانید یک میان‌بر \f[CR]tl:\f[R] را به این شکل تعریف کنید:
.IP
.EX
# (اسکریپت trans.cgi را می‌توانید در دایرکتوری bonus/ بیابید و بررسی کنید.)
tl:		/cgi\-bin/trans.cgi?%s
.EE
.PP
سپس، می‌توانید ترجمه هر کلمه‌ای را با استفاده از \f[CR]tl:word\f[R] باز کنید.
.PP
با این حال توجه داشته باشید که Chawan امکانات قدرتمندتری را برای چنین میان‌برهای جایگزینی در قالب قوانین همه‌منظوره (omni\-rules) ارائه می‌دهد.
بنابراین اگر می‌خواهید با tl:word به یک سایت لغت‌نامه آنلاین هدایت شوید به جای اینکه یک رابط محلی CGI فراهم کنید، استفاده از omni\-rules به جای ترکیب urimethodmap و بازهدایت محلی CGI آسان‌تر است.
.SH "همچنین ببینید (SEE ALSO)"
\f[B]cha\f[R](1)، \f[B]cha\-cgi\f[R](5)