OPENSEARCH-GENQUERY(1) User Contributed Perl Documentation نام (NAME) opensearch-genquery - خروجی دادن نشانی وب (URL) پرسمان تولیدشده از توصیف OpenSearch خلاصه دستور (SYNOPSIS) opensearch-genquery [-q] [-H] [-A] [-R] [-c COUNT] [-i INDEX] [-p PAGENUM] [-l LANG] [-O ENC] [-I ENC] URL SEARCH TERMS... توضیحات (DESCRIPTION) خروجی دادن نشانی وب (URL) یک پرسمان تولیدشده از فایل توصیف OpenSearch در URL، همراه با تکمیل SEARCH TERMS (عبارات جستجو) و سایر گزینه‌های مشخص‌شده. اگر چندین نوع جستجو در دسترس باشد، می‌توان از -H، -A و -R برای تعیین نوع مورد نظر استفاده کرد. برای نمونه، -A -R می‌تواند برای درخواست پاسخ Atom، یا در صورت در دسترس نبودن، عقب‌گرد (fallback) به RSS استفاده شود. به‌طور پیش‌فرض نخستین URL یافت‌شده در فایل توصیف استفاده می‌شود. همه وبگاه‌ها تمام (یا هیچ‌یک از) پارامترهای اختیاری OpenSearch را پیاده‌سازی نکرده‌اند. هنگام استفاده با این‌گونه وبگاه‌ها، گزینه‌های متناظر بدون اعلام اخطار نادیده گرفته خواهند شد. گزینه‌ها (OPTIONS) -q در صورت بروز خطا هیچ خروجی ندهد. در این حالت، برای تشخیص خطاها کد خروج را بررسی کنید (بخش «خطاها (DIAGNOSTICS)» را ببینید). -H درخواست پاسخ HTML. -A درخواست پاسخ Atom. -R درخواست پاسخ RSS. گزینه‌های -H، -A، و -R را می‌توان برای تعیین اولویت نوع پاسخ و مشخص کردن انواع جایگزین با یکدیگر ترکیب کرد. -c COUNT, --count=COUNT درخواست COUNT نتیجه. پارامتر OpenSearch: count. -i INDEX, --startindex=INDEX درخواست شروع نتایج از آفست INDEX. پارامتر OpenSearch: startIndex. -p PAGENUM, --startpage=PAGENUM درخواست صفحه نتایج PAGENUM. پارامتر OpenSearch: pageIndex. -l LANG, --language=LANG درخواست نتایج به زبان LANG. مقدار LANG باید یک کد کشور دو حرفی ISO باشد (مانند en یا de). پارامتر OpenSearch: language. -O ENC, --outputencoding=ENC درخواست نتایج با کدگذاری ENC (پیش‌فرض: UTF-8). پارامتر OpenSearch: outputEncoding. -I ENC, --inputencoding=ENC مشخص کردن اینکه عبارات جستجو با ENC کدگذاری شده‌اند (پیش‌فرض: UTF-8). پارامتر OpenSearch: inputEncoding. -h, --help نمایش یک پیام راهنمای کوتاه. -- پایان گزینه‌ها. خطاها (DIAGNOSTICS) برای تعیین خطاها می‌توان کد وضعیت خروج را به‌صورت زیر بررسی کرد: 0 - موفقیت. 1 - خطا در دریافت URL توصیف OpenSearch. 2 - خطا در تجزیه توصیف OpenSearch. 3 - هیچ نوع جستجوی منطبقی پیدا نشد. 4 - پودمان پرل WWW::OpenSearch پیدا نشد. 5 - خطای مدیریت‌نشده از WWW::OpenSearch. وابستگی‌ها (DEPENDENCIES) نیازمند ماژول WWW::OpenSearch است (بسته دبیان libwww-opensearch-perl). گزارش باگ‌ها (BUGS) تنها از پرسمان‌های GET پشتیبانی می‌کند. لطفاً هرگونه باگ یافت‌شده را به ianb@erislabs.net گزارش دهید. همچنین ببینید (SEE ALSO) opensearch(1), opensearch-discover(1), surfraw(1), WWW::OpenSearch(3pm), نویسندگان (AUTHORS) Ian Beckwith کپی‌رایت و تکثیر (COPYRIGHT) Copyright 2006 Ian Beckwith تحت همان شرایط surfraw مجوزدهی شده است. perl v5.40.0 2024-09-09 OPENSEARCH-GENQUERY(1)