.TH "DDGR" "1" "29 Dec 2023" "Version 2.2" "User Commands" .SH "نام (NAME)" ddgr \- جستجو در DuckDuckGo از طریق خط فرمان .SH "خلاصه دستور (SYNOPSIS)" .B ddgr [OPTIONS] [KEYWORD [KEYWORD ...]] .SH "توضیحات (DESCRIPTION)" .B ddgr یک ابزار خط فرمانی برای جستجو در DuckDuckGo (نسخه html) است. \fBddgr\fR عنوان، URL و متن زمینه را برای هر نتیجه نمایش می‌دهد. نتایج به صورت صفحه‌بندی‌شده دریافت می‌شوند. کلیدهای میانبر صفحه‌کلید برای پیمایش بین صفحات در دسترس هستند. نتایج شماره‌گذاری (نمایه‌گذاری) شده‌اند و URL هر نتیجه را می‌توان با استفاده از شماره نمایه در یک مرورگر باز کرد. هیچ فایل پیکربندی وجود ندارد زیرا نام‌های مستعار (alias) برای این ابزار همان هدف را برآورده می‌کنند. همچنین از جستجوهای متوالی در یک نمونهٔ اجرایی واحد پشتیبانی می‌کند. .PP .B ویژگی‌ها .PP * سریع و تمیز؛ رنگ‌بندی سفارشی * طراحی‌شده برای بیشترین خوانایی در کمترین فضا * پاسخ‌های فوری (پشتیبانی‌شده توسط نسخه html در DDG) * تعداد سفارشی نتایج در هر صفحه * پیمایش و یکپارچگی با مرورگر * اسکریپت‌های تکمیل خودکار جستجو و گزینه‌ها (Bash، Fish، Zsh) * قابلیت Bangs در DuckDuckGo (به همراه تکمیل خودکار) * باز کردن نخستین نتیجه در مرورگر (I'm Feeling Ducky) * محیط تعاملی (REPL) برای جستجوهای پیوسته * کلیدواژه‌ها (مانند `filetype:mime`، `site:somesite.com`) * محدود کردن جستجو بر اساس زمان، تعیین منطقه جغرافیایی، غیرفعال‌سازی جستجوی ایمن * پشتیبانی از پراکسی HTTPS، امکان غیرفعال‌سازی اختیاری User Agent * فعال بودن پیش‌فرض قابلیت «ردیابی نکن» (Do Not Track) * پشتیبانی از اسکریپت سفارشی یا ابزار خط فرمانی برای مدیریت URL * مستندسازی کامل، دارای صفحه راهنما همراه با مثال‌ها * وابستگی‌های نرم‌افزاری حداقلی .SH "گزینه‌ها (OPTIONS)" .TP .BI "-h, --help" نمایش متن راهنما و خروج. .TP .BI "-n, --num=" N نمایش N نتیجه در هر صفحه (پیش‌فرض ۱۰ است). N باید بین ۰ تا ۲۵ باشد. مقدار N=0 صفحه‌بندی ثابت را غیرفعال کرده و تعداد واقعی نتایج دریافت‌شده در هر صفحه را نمایش می‌دهد. .TP .BI "-r, --reg=" REG جستجوی مختص به منطقه، مثلاً 'us-en' برای ایالات متحده (پیش‌فرض)؛ به https://duckduckgo.com/params مراجعه کنید. .TP .BI "-C, --nocolor" غیرفعال‌سازی خروجی رنگی. .TP .BI "--colors=" COLORS تنظیم رنگ‌های خروجی. برای جزئیات به بخش \fBCOLORS\fR در ادامه مراجعه کنید. .TP .BI "-j, --ducky" باز کردن نخستین نتیجه در مرورگر وب؛ گزینهٔ \fB--noprompt\fR را نیز در بر دارد. احساس خوش‌شانسی می‌کنید؟ (Feeling Ducky). .TP .BI "-t, --time=" SPAN محدود کردن زمانی جستجو [d=روز گذشته، w=هفته گذشته، m=ماه گذشته، y=سال گذشته] (پیش‌فرض=هر زمانی). .TP .BI "-w, --site=" SITE جستجو در یک وبگاه با استفاده از DuckDuckGo. .TP .BI "-x, --expand" گسترش دادن URLها به جای نمایش تنها نام دامنه (پیش‌فرض). .TP .BI "-p, --proxy=" URI تونل کردن ترافیک از طریق یک پراکسی HTTP. مقدار \fIURI\fR به صورت \fI[http[s]://][user:pwd@]host[:port]\fR است. سرور پراکسی باید از تونل‌زنی HTTP CONNECT پشتیبانی کند و نباید پورت ۴۴۳ را برای میزبان‌های مربوطهٔ DuckDuckGo مسدود کرده باشد. اگر پراکسی صریحاً مشخص نشده باشد، متغیر محیطی \fIhttps_proxy\fR یا \fIHTTPS_PROXY\fR (در صورت در دسترس بودن) به جای آن استفاده می‌شود. .TP .BI "--unsafe" غیرفعال‌سازی جستجوی ایمن (safe search). .TP .BI "--noua" غیرفعال‌سازی عامل کاربر (user agent). نتایج سریع‌تر دریافت می‌شوند. .TP .BI "--json" خروجی با قالب JSON؛ گزینهٔ \fB--noprompt\fR را نیز در بر دارد. .TP .BI "--gb, --gui-browser" باز کردن مستقیم یک bang در مرورگر گرافیکی (GUI). .TP .BI "--np, --noprompt" انجام جستجو و خروج؛ برای تعاملات بعدی اعلان نمایش داده نمی‌شود. .TP .BI "--rev, --reverse" فهرست کردن مدخل‌ها با ترتیب معکوس. .TP .BI "--url-handler=" UTIL اسکریپت سفارشی یا ابزار خط فرمانی برای باز کردن URLها با آن. .TP .BI "--show-browser-logs" جلوگیری نکردن از نمایش خروجی مرورگر هنگام باز کردن نتیجه در مرورگر؛ به این معنی که stdout و stderr مرورگر به جای /dev/null به stdout و stderr برنامهٔ ddgr متصل می‌شوند. به طور پیش‌فرض، خروجی مرورگر سرکوب می‌شود (به دلیل اینکه برخی مرورگرهای گرافیکی پیام‌هایی را در کنسول چاپ می‌کنند)، مگر اینکه متغیر محیطی \fBBROWSER\fR یک مرورگر متنی شناخته‌شده باشد: elinks، links، lynx، w3m یا www-browser. .TP .BI "-v, --version" نمایش شماره نسخه و خروج. .TP .BI "-d, --debug" فعال‌سازی اشکال‌زدایی. .SH "کلیدهای خط فرمان تعاملی (OMNIPROMPT KEYS)" .TP .BI "n, p, f" دریافت مجموعه نتایج بعدی، قبلی یا اول. .TP .BI "index" باز کردن نتیجه متناظر با شماره نمایه در مرورگر. .TP .BI o " [index|range|a ...]" باز کردن نمایه‌های جداشده با فاصله، بازه‌های عددی، یا همهٔ نمایه‌ها در صورت تعیین 'a'، در مرورگر. .TP .BI O " [index|range|a ...]" مشابه کلید 'o' کار می‌کند، اما سعی می‌کند مرورگرهای متنی را نادیده بگیرد (حتی اگر BROWSER تنظیم شده باشد) و پیوندها را در یک مرورگر گرافیکی باز کند. .TP .BI d " keywords" شروع یک جستجوی جدید در DuckDuckGo برای \fIkeywords\fR با گزینه‌های اولیه. از این کلید باید برای جستجوی کلیدهای omniprompt (شامل خودش) و نمایه‌ها استفاده شود. .TP .BI "x" تغییر وضعیت گسترش URL. .TP .BI "c index" کپی کردن URL به کلیپ‌بورد. .TP .BI "q, ^D, double Enter" خروج از ddgr. .TP .BI "?" نمایش راهنمای omniprompt. .TP .BI * هر رشتهٔ دیگری یک جستجوی جدید را با گزینه‌های اولیه آغاز می‌کند. .SH "رنگ‌ها (COLORS)" \fBddgr\fR به شما امکان می‌دهد طرح رنگ‌بندی را از طریق یک رشتهٔ شش‌حرفی، مشابه با \fBLSCOLORS\fR در BSD، سفارشی‌سازی کنید. این شش حرف به ترتیب نشان‌دهندهٔ رنگ‌های زیر هستند: .IP - 2 نمایه‌ها .PD 0 \" Change paragraph spacing to 0 in the list .IP - 2 عنوان‌ها .IP - 2 نشانی‌های URL .IP - 2 فراداده/اطلاعات انتشار .IP - 2 چکیده‌ها .IP - 2 اعلان‌ها .PD 1 \" Restore paragraph spacing .TP به ترتیب. این رشته شش‌حرفی یا به عنوان آرگومان به گزینهٔ \fB--colors\fR فرستاده می‌شود، یا به عنوان مقدار متغیر محیطی \fBDDGR_COLORS\fR تعیین می‌گردد. .TP رنگ‌ها/سبک‌های زیر ارائه شده‌اند: .TS tab(;) box; l|l -|- l|l. Letter;Color/Style a;black b;red c;green d;yellow e;blue f;magenta g;cyan h;white i;bright black j;bright red k;bright green l;bright yellow m;bright blue n;bright magenta o;bright cyan p;bright white A-H;bold version of the lowercase-letter color I-P;bold version of the lowercase-letter bright color x;normal X;bold y;reverse video Y;bold reverse video .TE .TP .TP رشته رنگ‌های پیش‌فرض \fIoCdgxy\fR است که نشان‌دهندهٔ موارد زیر است: .IP - 2 نمایه‌های فیروزه‌ای روشن .PD 0 \" Change paragraph spacing to 0 in the list .IP - 2 عنوان‌های سبز برجسته .IP - 2 نشانی‌های URL زرد .IP - 2 فراداده/اطلاعات انتشار فیروزه‌ای .IP - 2 چکیده‌های عادی .IP - 2 اعلان‌های ویدئوی معکوس .PD 1 \" Restore paragraph spacing .TP توجه داشته باشید که .IP - 2 رنگ‌های روشن (پیاده‌سازی‌شده به صورت \ex1b[90m \- \ex1b[97m) ممکن است در تمام شبیه‌سازهای ترمینال با قابلیت رنگ در دسترس نباشند؛ .IP - 2 برخی از شبیه‌سازهای ترمینال، متن برجسته (bold) را به جای آن با رنگ‌های روشن رسم می‌کنند؛ .IP - 2 برخی از شبیه‌سازهای ترمینال تنها از طریق یک سوئیچ که به طور پیش‌فرض غیرفعال است، بین رنگ‌های برجسته و روشن تفاوت قائل می‌شوند. .TP لطفاً برای جزئیات بیشتر به دفترچه راهنمای شبیه‌ساز ترمینال خود و همچنین \fIhttps://en.wikipedia.org/wiki/ANSI_escape_code\fR مراجعه کنید. .SH "محیط (ENVIRONMENT)" .TP .BI BROWSER مرورگر پیش‌فرض را لغو می‌کند و تغییر می‌دهد. مرجع: .I http://docs.python.org/library/webbrowser.html .TP .BI DDGR_COLORS به بخش \fBCOLORS\fR مراجعه کنید. .TP .BI DISABLE_PROMPT_COLOR اگر در اعلان با رنگ‌ها مشکل دارید، یک اعلان ساده بدون رنگ را اجبار می‌کند. .TP .BI "HTTPS_PROXY, https_proxy" به گزینهٔ \fB--proxy\fR مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .PP .IP 1. 4 جستجوی \fBhello world\fR در DuckDuckGo: .PP .EX .IP .B ddgr hello world .EE .PP .IP 2. 4 جستجوی \fBI'm Feeling Ducky\fR: .PP .EX .IP .B ddgr -j lucky ducks .EE .PP .IP 3. 4 جستجوی عبارت 'hello world' در ویکی‌پدیا با \fBDuckDuckGo Bang\fR: .PP .EX .IP .B ddgr !w hello world .B ddgr \e!w hello world // bash-specific, need to escape ! on bash .EE .PP .IP "" 4 قابلیت Bangs در omniprompt نیز کار می‌کند. برای جستجوی bangها به https://duckduckgo.com/bang?#bangs-list مراجعه کنید. .PP .IP 4. 4 ایجاد \fBنام مستعار برای Bang\fR جهت اجرا از خط فرمان، باز کردن نتایج در مرورگر گرافیکی و سپس خروج: .PP .EX .IP .B alias bang='ddgr --gb --np' .IP .B bang !w hello world .B bang \e!w hello world // bash-specific, need to escape ! on bash .EE .PP .IP 5. 4 جستجوی \fBمختص به یک وبگاه\fR: .PP .EX .IP .B ddgr -w amazon.com digital camera .EE .PP .IP "" 4 جستجوی مختص به وبگاه در omniprompt ادامه می‌یابد. .EE .PP .IP 6. 4 جستجو برای یک \fBنوع فایل خاص\fR: .PP .EX .IP .B ddgr instrumental filetype:mp3 .EE .PP .IP 7. 4 دریافت نتایج مربوط به کریکت IPL از \fBهند\fR به زبان \fBانگلیسی\fR: .PP .EX .IP .B ddgr -r in-en IPL cricket .EE .PP .IP "" 4 برای یافتن شناسه پارامتر منطقه خود به https://duckduckgo.com/params مراجعه کنید. .PP .IP 8. 4 جستجوی \fBمتن داخل گیومه\fR: .PP .EX .IP .B ddgr it\(rs's a \(rs\(dqbeautiful world\(rs\(dq in spring .EE .PP .IP 9. 4 نمایش \fBنشانی‌های اینترنتی کامل\fR در نتایج جستجو (به جای فقط نام دامنه): .PP .EX .IP .B ddgr -x ddgr .EE .PP .IP 10. 4 استفاده از یک \fBطرح رنگ سفارشی\fR، برای مثال یک طرح رنگ گرم طراحی‌شده برای Solarized Dark: .PP .EX .IP .B ddgr --colors bjdxxy hello world .IP .B DDGR_COLORS=bjdxxy ddgr hello world .EE .PP .IP 11. 4 تونل کردن ترافیک از طریق یک \fBپراکسی HTTPS\fR، مثلاً یک نمونه محلی Privoxy که روی پورت ۸۱۱۸ گوش می‌دهد: .PP .EX .IP .B ddgr --proxy localhost:8118 hello world .EE .PP .IP "" 4 به صورت پیش‌فرض در صورت تعریف شدن متغیر محیطی \fIhttps_proxy\fR (یا \fIHTTPS_PROXY\fR)، از آن استفاده می‌شود. .EE .PP .IP 12. 4 جستجوی \fBn\fR، \fBp\fR، \fBo\fR، \fBO\fR، \fBq\fR، \fBd keywords\fR یا یک نمایه نتیجه در \fBomniprompt\fR: از آنجا که omniprompt این کلیدها یا رشته‌های نمایه را به عنوان دستور می‌شناسد، باید قبل از آن‌ها پیشوند \fBd\fR را اضافه کنید، به عنوان مثال: .PP .EX .PD 0 .IP .B d n .IP .B d d keywords .IP .B d 1 .PD .EE .SH "نویسندگان (AUTHORS)" Arun Prakash Jana .SH "صفحه اصلی (HOME)" .I https://github.com/jarun/ddgr .SH "گزارش باگ‌ها (BUGS)" .I https://github.com/jarun/ddgr/issues .SH "کپی‌رایت و تکثیر (COPYRIGHT)" حق نشر \(co 2016-2024 متعلق به Arun Prakash Jana است. .PP مجوز GPLv3+‎: گنو GPL ویرایش ۳ یا جدیدتر . .br این نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید. تا جایی که قانون اجازه می‌دهد، هیچ ضمانتی وجود ندارد.