NEWSBOAT(1)   NEWSBOAT(1)

newsboat - یک خوراک‌خوان RSS/Atom برای ترمینال‌های متنی

newsboat [-r] [-e] [-i opmlfile] [-u urlfile] [-c cachefile] [-C configfile] [-X] [-o] [-x command...] [-h]

برنامه Newsboat یک خوراک‌خوان RSS/Atom برای ترمینال‌های متنی است. RSS و Atom مجموعه‌ای از قالب‌های پرکاربرد XML برای انتقال، انتشار و هم‌رسانی مقالات، مانند اخبار یا مقالات وبلاگی هستند. Newsboat برای استفاده در ترمینال‌های متنی در سیستم‌های یونیکس یا شبه‌یونیکس مانند GNU/Linux، BSD یا macOS طراحی شده است.

-h, --help

نمایش راهنما

-r, --refresh-on-start

تازه‌سازی خوراک‌ها هنگام شروع

-e, --export-to-opml

برون‌بری خوراک‌ها به عنوان OPML به stdout. این گزینه در حال حاضر به صورت OPML 1.0 خروجی می‌دهد و تمام اطلاعات برچسب‌ها از بین می‌رود، اما در آینده ممکن است به 2.0 تغییر یابد.

--export-to-opml2

برون‌بری خوراک‌ها به صورت OPML 2.0، شامل برچسب‌ها، به stdout

-X, --vacuum

فشرده‌سازی حافظه نهان (cache) از طریق: ۱) بازپس‌گیری فضایی که پس از حذف داده‌ها خالی مانده بود؛ و ۲) یکپارچه‌سازی مدخل‌ها در حافظه نهان. این گزینه مدخل‌ها را حذف نمی‌کند؛ برای حذف به تنظیمات cleanup-on-quit، delete-read-articles-on-quit، keep-articles-days و max-items مراجعه کنید.

--cleanup

حذف مدخل‌های ارجاع‌نشده از حافظه نهان و خروج از Newsboat. اگر آدرس خوراک دیگر در فایل urls وجود نداشته باشد، خوراک‌ها و مقالات آن‌ها حذف خواهند شد.

علاوه بر این، اگر پیکربندی delete-read-articles-on-quit تنظیم شده باشد، تمام مقالات خوانده‌شده حذف خواهند شد (شامل مقالات خوراک‌هایی که هنوز در فایل urls هستند).

-v, -V, --version

دریافت اطلاعات نسخه Newsboat و کتابخانه‌های مورد استفاده آن

-i opmlfile, --import-from-opml=opmlfile

درون‌ریزی یک فایل OPML

-u urlfile, --url-file=urlfile

استفاده از یک فایل URL جایگزین

-c cachefile, --cache-file=cachefile

استفاده از یک فایل حافظه نهان جایگزین

-C configfile, --config-file=configfile

استفاده از یک فایل پیکربندی جایگزین

--queue-file=queuefile

استفاده از یک فایل صف جایگزین

--search-history-file=searchhistoryfile

استفاده از یک فایل تاریخچه جستجوی جایگزین

--cmdline-history-file=cmdlinehistoryfile

استفاده از یک فایل تاریخچه خط فرمان جایگزین

-x command ..., --execute=command...

اجرای یک یا چند دستور برای اجرای بدون مراقبت Newsboat. در حال حاضر دستورات موجود شامل reload و print-unread هستند.

-l loglevel, --log-level=loglevel

تولید یک فایل لاگ با loglevel معین (مقادیر معتبر: 1 تا 6، به ترتیب برای خطای کاربر، بحرانی، خطا، هشدار، اطلاعات و اشکال‌زدایی). نام فایل را می‌توان با استفاده از گزینه --log-file مشخص کرد. در صورت عدم تعیین، نام فایلی به شکل newsboat_<date-time>.log تولید می‌شود.

-d logfile, --log-file=logfile

استفاده از این logfile به عنوان خروجی هنگام ثبت پیام‌های اشکال‌زدایی. توجه داشته باشید که این گزینه فقط در صورت تعیین سطح لاگ کار می‌کند.

-E file, --export-to-file=file

برون‌بری فهرستی از مقالات خوانده‌شده (یا GUIDهای آن‌ها). این گزینه می‌تواند برای انتقال اطلاعات مقالات خوانده‌شده میان رایانه‌های مختلف استفاده شود.

-I file, --import-from-file=file

درون‌ریزی فهرستی از مقالات خوانده‌شده و علامت‌گذاری آن‌ها به عنوان خوانده‌شده در صورتی که در حافظه نهان موجود باشند. این گزینه باید همراه با پارامتر خط فرمان -E استفاده شود.

پس از نصب Newsboat، می‌توانید برای نخستین بار با تایپ newsboat در خط فرمان آن را اجرا کنید. با این کار پیام زیر نمایش داده می‌شود:

Error: no URLs configured. Please fill the file /home/ak/.newsboat/urls with RSS feed URLs or import an OPML file.
Newsboat 2.22
usage: ./newsboat [-i <file>|-e] [-u <urlfile>] [-c <cachefile>] [-x <command> ...] [-h]
    -e, --export-to-opml            export OPML feed to stdout
    -r, --refresh-on-start          refresh feeds on start
    -i, --import-from-opml=<file>   import OPML file
    -u, --url-file=<urlfile>        read RSS feed URLs from <urlfile>
    -c, --cache-file=<cachefile>    use <cachefile> as cache file
    -C, --config-file=<configfile>  read configuration from <configfile>
    -X, --vacuum                    compact the cache
    -x, --execute=<command>...      execute list of commands
    -q, --quiet                     quiet startup
    -v, --version                   get version information
    -l, --log-level=<loglevel>      write a log with a certain loglevel (valid values: 1 to 6)
    -d, --log-file=<logfile>        use <logfile> as output log file
    -E, --export-to-file=<file>     export list of read articles to <file>
    -I, --import-from-file=<file>   import list of read articles from <file>
    -h, --help                      this help
        --cleanup                   remove unreferenced items from cache

این پیام به این معناست که Newsboat نمی‌تواند بدون هیچ خوراک پیکربندی‌شده‌ای آغاز به کار کند.

برای افزودن خوراک‌ها به Newsboat، کافی است در هر سطر از فایل پیکربندی ~/.newsboat/urls نشانی URL یک خوراک را اضافه کنید:

http://rss.cnn.com/rss/cnn_topstories.rss
http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml

شما همچنین می‌توانید با اجرای دستور newsboat -i blogroll.opml یک فایل OPML را درون‌ریزی کنید.

افزودن توضیحات سطرهایی که با # آغاز می‌شوند می‌توانند هر متنی را در خود داشته باشند. توضیحات توسط Newsboat نادیده گرفته می‌شوند، اما می‌توانند به عنوان مستندسازی برای شما عمل کنند. لطفاً توجه داشته باشید که غیرفعال کردن URLها با کامنت‌گذاری به منظور خطایابی ممکن است باعث از دست رفتن غیرمنتظره داده‌ها شود؛ برای جزئیات بیشتر به تنظیم cleanup-on-quit مراجعه کنید.

خوراک‌های دارای دسترسی محدود

اگر نیاز به افزودن نشانی‌هایی دارید که دسترسی محدود دارند، کافی است نام کاربری/گذرواژه را در نشانی درج کنید:

در صورتی که در نام کاربری نویسه @ وجود داشته باشد، باید آن را به صورت %40 بنویسید.

به منظور محافظت از نام‌های کاربری و گذرواژه‌ها، حتماً دسترسی خواندن فایل ~/.newsboat/urls را تنها به خودتان و در صورت تمایل به گروهتان محدود کنید:

$ chmod u=rw,g=r,o= ~/.newsboat/urls

نرم‌افزار Newsboat اطمینان حاصل می‌کند که نام‌های کاربری و گذرواژه‌ها در رابط کاربری آن نمایش داده نشوند.

فایل‌های محلی به عنوان خوراک

همچنین می‌توانید با قرار دادن پیشوند file:// در ابتدای مسیر محلی و افزودن آن به فایل urls، فایل‌های محلی را به عنوان خوراک پیکربندی کنید:

file:///var/log/rss_eventlog.xml

رابط کاربری اصلی Newsboat شامل سه نما است:

نمای فهرست خوراک‌ها → نمای فهرست مقالات → نمای مقاله

با فشردن کلید Enter می‌توانید وارد این نماها شوید و با فشردن کلید Q به نمای قبلی بازگردید. فشردن Q در نمای فهرست خوراک‌ها — یا فشردن Shift + Q در هر کجای برنامه — موجب خروج از Newsboat می‌شود.

همچنین می‌توانید با فشردن کلید / در نمای فهرست خوراک‌ها یا نمای فهرست مقالات، در عنوان یا متن مقالات جستجو کنید. در نمای فهرست خوراک‌ها تمامی مقالاتِ همه خوراک‌ها جستجو می‌شوند. در نمای فهرست مقالات، تنها مقالات خوراک جاری بررسی می‌شوند. هنگام باز کردن مقاله‌ای از پنجره نتایج جستجو، عبارت جستجوشده به صورت برجسته (highlight) نمایش داده می‌شود.

تاریخچه جستجو تاریخچه تمام جستجوهای شما در سیستم فایل و در فایل history.search (در کنار فایل cache.db) ذخیره می‌شود. به صورت پیش‌فرض، ۱۰۰ عبارت جستجوی اخیر نگهداری می‌شود.

می‌توانید با پیکربندی تنظیم history-limit، تعداد عبارات جستجوی ذخیره‌شده را تغییر دهید.

نمای فهرست خوراک‌ها

هنگامی که Newsboat را آغاز می‌کنید، فهرستی از خوراک‌هایی که قبلاً اضافه کرده‌اید به شما نمایش داده می‌شود.

اکنون می‌توانید کارهای زیر را انجام دهید:

•فشردن کلیدهای Shift + R برای دانلود مقالات تمام خوراک‌ها.
•فشردن کلید R برای دانلود مقالات خوراک انتخاب‌شده.
•فشردن کلید / برای جستجو در تمام مقالاتِ همه خوراک‌ها.
•فشردن کلید Enter برای رفتن به فهرست مقالات خوراک انتخاب‌شده.
•فشردن کلید Q برای بستن Newsboat.

مقالات محلی برنامه Newsboat مقالاتی را که دانلود می‌کند ذخیره نگه می‌دارد. وقتی دوباره Newsboat را باز کرده و خوراکی را بازخوانی می‌کنید، مقالات قدیمی همچنان قابل خواندن هستند حتی اگر دیگر در خوراک‌های RSS جاری وجود نداشته باشند. حداکثر تعداد مقالات با تنظیم max-items کنترل می‌شود.

حافظه نهان (Caching) نرم‌افزار Newsboat با استفاده از دانلود مشروط بر بستر HTTP، تدابیری برای حفظ پهنای باند کاربران و ارائه‌دهندگان خوراک اتخاذ می‌کند. این برنامه مقادیر هدرهای پاسخ "Last-Modified" و "ETag" هر خوراک را (در صورت وجود) ذخیره می‌کند و به سرور HTTP خوراک اعلام می‌کند که تنها در صورت به‌روزرسانی خوراک داده‌ها را ارسال کند. این سازوکار نه تنها بارگیری خوراک‌های RSS فاقد به‌روزرسانی را سریع‌تر می‌سازد، بلکه حجم داده‌های منتقل‌شده در هر درخواست را نیز کاهش می‌دهد.

شما می‌توانید دانلود مشروط HTTP را برای هر خوراک با استفاده از تنظیم always-download غیرفعال کنید.

نمای فهرست مقالات

پس از ورود به یک خوراک، می‌توانید فهرست مقالات موجود را بر اساس عنوان آن‌ها مشاهده کنید. وجود حرف N در سمت چپ نشان می‌دهد که مقاله هنوز خوانده نشده است.

اکنون می‌توانید کارهای زیر را انجام دهید:

•فشردن کلید Q برای بازگشت به نمای فهرست خوراک‌ها.
•فشردن کلید / برای جستجو در تمام مقالات این خوراک.
•فشردن کلید Enter برای خواندن مقاله انتخاب‌شده.

نمای مقاله

در نمای مقاله می‌توانید در متن پیمایش کرده و آن را بخوانید. هر پیوند درون مقاله دارای یک شماره در کنار خود است.

اکنون می‌توانید کارهای زیر را انجام دهید:

•فشردن هر شماره برای باز کردن پیوند مقاله در مرورگر. برای شماره‌های بزرگتر از ۹، کلید # را فشرده و سپس شماره را وارد کرده و Enter را بزنید.
•فشردن کلید O برای باز کردن مقاله در مرورگر.
•فشردن کلید Q برای بازگشت به نمای فهرست مقالات.

نمای مرورگر گاهی اوقات محتوای یک مقاله خالی است یا تنها یک چکیده و توضیح کوتاه دارد. شما همیشه می‌توانید کلید O را فشار دهید تا مقاله کامل را در یک مرورگر مشاهده کنید. مرورگر پیش‌فرض lynx است.

می‌توانید با پیکربندی تنظیم browser، از مرورگر دلخواه خود استفاده کنید.

جنبه‌های گوناگون Newsboat را می‌توان از طریق یک فایل config که در کنار فایل urls ذخیره می‌شود پیکربندی کرد. یک خط پیکربندی به طور کلی به این صورت است:

<config-command> <arg1> ...

فایل پیکربندی می‌تواند شامل توضیحات باشد که با نویسه # آغاز شده و تا انتهای سطر ادامه می‌یابند.

مشارکت‌های کاربران (User contrib) نرم‌افزار Newsboat همچنین همراه با محتوای ارائه‌شده توسط کاربران مانند اسکریپت‌ها و پوسته‌های رنگی عرضه می‌شود. این محتوا را می‌توان در مسیر /usr/share/doc/newsboat/contrib/ یافت. به کاربران توصیه می‌شود نگاهی به آن‌ها بیندازند، زیرا ممکن است موارد مفیدی بیابند.

یک نمونه پیکربندی به این صورت است:

# یک توضیح
max-items&        100 # چنین توضیحاتی نیز امکان‌پذیر هستند
browser&          links
show-read-feeds&  no
unbind-key&       R
bind&             ^R feedlist reload-all

تنظیماتی مانند ماکروها و ignore-article می‌توانند بسیار طولانی باشند. یک سطر طولانی را می‌توان با استفاده از بک‌اسلش به چند سطر شکست. بک‌اسلش باید آخرین نویسه روی خط باشد و بلافاصله آن سطر را به سطر بعدی پیوند می‌دهد. مهم است که هیچ چیز پس از \ روی همان سطر قرار نگیرد، در غیر این صورت با نویسه \ به صورت یک نویسه معمولی رفتار می‌شود. برای مثال:

macro p open; \
reload; quit; \
quit;&         \
quit -- "Opens, reloads then makes sure to quit newsboat"

لطفاً توجه داشته باشید که بک‌اسلش تنها موجب می‌شود که Newsboat از خط جدید بعدی چشم‌پوشی کند. این کار هیچ اثر دیگری ندارد. برای مثال، این گزینه قالب‌بندی‌شده:

ignore-article \
    "*" \
    "author =~ \"(\
        John Doe| \
        Mary Sue \
    )\""

به این مورد تبدیل نمی‌شود:

ignore-article "*" "author =~ \"(John Doe|Mary Sue)\""

در عوض، از آنجا که تنها خطوط جدید حذف می‌شوند، به این شکل تبدیل می‌شود:

ignore-article&     "*"&     "author =~ \"(&        John Doe|&         Mary Sue&     )\""

به همین دلیل، هنگام شکستن خطوط دقت کافی داشته باشید، زیرا ممکن است فاصله‌ها اهمیت داشته باشند.

خلاصه (TL;DR) برای رشته‌هایی که حاوی فاصله یا دابل کوتیشن هستند از نقل‌قول دوتایی (double quote) استفاده کنید. دابل کوتیشن‌ها (با \") و بک‌اسلش‌ها (با \\) را escape کنید. عبارات بیرون از نقل‌قول را escape نکنید و از کوتیشن تکی استفاده نکنید — زیرا Newsboat از آن پشتیبانی نمی‌کند.

بسیاری از گزینه‌های Newsboat رشته‌ها را به عنوان آرگومان می‌پذیرند؛ از جمله دستورات، گذرواژه‌ها، عناوین پنجره‌ها، نشانی‌های URL و غیره. برخی گزینه‌ها حتی چندین رشته را به طور همزمان دریافت می‌کنند. این رشته‌ها می‌توانند حاوی فاصله باشند که ممکن است Newsboat را به اشتباه بیندازد، زیرا این برنامه از فاصله برای جداسازی نام گزینه‌ها از آرگومان‌ها استفاده می‌کند.

برای درک صحیح هدف شما توسط Newsboat، چنین رشته‌هایی را درون نقل‌قول دوتایی (دابل کوتیشن) قرار دهید:

browser "firefox --new-tab %u"

اگر به یک دابل کوتیشن درون رشته نیاز داشتید چطور؟ آن را با یک بک‌اسلش escape کنید:

ocnews-password "UnbalancedQuotes\"AreSoFun!"

و خود بک‌اسلش چطور؟ آن را نیز escape کنید! فرض کنید برنامه‌ای به نام my favourite pager دارید و می‌خواهید مقالات را با آن مشاهده کنید. برنامه Newsboat در نهایت دستورات را به شل ارسال می‌کند و اگر می‌خواهید فاصله‌ها حفظ شوند، شل انتظار دارد که فاصله‌ها escape شوند. اما از آنجا که خود Newsboat بک‌اسلش‌ها را تفسیر می‌کند، باید یک لایه دیگر از escape را اضافه کنید. بنابراین، دستوری مانند زیر خواهید داشت:

pager "/usr/bin/my\\ favourite\\ pager"

همچنین امکان ادغام خروجی دستورات خارجی در پیکربندی وجود دارد. متنی که بین دو علامت بک‌تیک ` قرار دارد به عنوان دستور شل ارزیابی شده و خروجی آن استفاده می‌شود. این قابلیت مانند ارزیابی بک‌تیک در شل‌های سازگار با Bourne کار می‌کند و به کاربران امکان می‌دهد از اطلاعات خارجی سیستم در پیکربندی استفاده کنند.

نویسه‌های بک‌تیک و # را می‌توان با استفاده از یک بک‌اسلش گریز داد (مانند \` و \#). در این حالت، آن‌ها با نویسه‌های لفظی ` یا # در پیکربندی جایگزین می‌شوند.

سبک جدید کلیدهای میانبر که در اینجا شرح داده شده است، از نسخه ۲٫۳۹ در Newsboat پشتیبانی می‌شود.

می‌توانید با استفاده از دستور پیکربندی bind، یک کلید (یا توالی از کلیدها) را به یک عملیات (یا فهرستی از عملیات) مقید کنید.

ساختار دستوری برای تعریف میانبر به صورت زیر است:

bind <key-sequence> <dialog>[,<dialog>] <operation-list> [-- "<description>"]

هشدار: محدودیت‌ها

میانبرهایی که پیشوند مشترک دارند باید همگی طول یکسانی داشته باشند؛ در غیر این صورت، تنها آخرین میانبر ایجاد می‌شود.

برای مثال:

bind ab everywhere …
bind abc everywhere …

تنها یک میانبر برای abc ایجاد می‌کند. تغییر ترتیب دستورات موجب ایجاد میانبر برای ab خواهد شد.

این امر از ابهام در زمانی که ab تایپ می‌شود و Newsboat نمی‌داند آیا باید میانبر ab را اجرا کند یا اینکه کاربر کلید c بعدی را فشار خواهد داد و میانبر دیگر را فرا می‌خواند، جلوگیری می‌کند.

برای داشتن هر دو میانبر، یا:

•آن‌ها را به گونه‌ای تغییر نام دهید که پیشوندهای متفاوتی داشته باشند (مثلاً ab و bcd)، یا
•طول آن‌ها را یکسان کنید (مثلاً ab را به abd تغییر دهید تا با طول abc همخوانی داشته باشد).

توالی کلیدها (Key Sequence)

کلیدهای کوچک، کلیدهای بزرگ و نویسه‌های خاص به صورت دقیق و لفظی نوشته می‌شوند.

ترکیب‌های کلیدی با Ctrl با استفاده از علامت هشتک (caret) ^ نوشته می‌شوند. برای نمونه، Ctrl + R معادل ^R است. لطفاً توجه داشته باشید که تمامی ترکیب‌های کلیدی مرتبط با Ctrl باید با حروف بزرگ نوشته شوند.

همچنین، کلیدهای ترکیبی شامل Shift یا Ctrl را می‌توان به صورت <S-a> و <C-a>، به ترتیب برای Shift + A و Ctrl + A نوشت. توجه داشته باشید که این ساختار جایگزین تنها با دستور bind کار می‌کند و در دستور قدیمی‌تر bind-key پشتیبانی نمی‌شود.

شناسه‌های زیر برای کلیدهای ویژه پشتیبانی می‌شوند:

•<ENTER> (کلید Enter)
•<BACKSPACE> (کلید Backspace)
•<LEFT> (مکان‌نمای چپ)
•<RIGHT> (مکان‌نمای راست)
•<UP> (مکان‌نمای بالا)
•<DOWN> (مکان‌نمای پایین)
•<PPAGE> (کلید Page Up)
•<NPAGE> (کلید Page Down)
•<HOME> (مکان‌نما به ابتدای فهرست/مقاله)
•<END> (مکان‌نما به انتهای فهرست/مقاله)
•<ESC> (کلید Esc)
•<TAB> (کلید Tab)
•<LT> (کلید <)
•<GT> (کلید >)
•<^> (کلید ^؛ در صورتی که بعد از آن حرفی نیاید می‌تواند به عنوان ^ خالی نیز تعیین شود)
•<F1> تا <F12> (کلیدهای F1 تا F12)

چندین کلید می‌توانند به صورت متوالی قرار گیرند. برای مثال gg به معنای فشردن دو بار کلید g و ^O<ENTER> به معنای فشردن Ctrl + O و سپس Enter است. فشردن Esc ورودی چندکلیدی را لغو می‌کند.

کادر گفتگو یا پنجره (Dialog)

یک پنجره (dialog) بستری است که میانبر کلیدی در آن فعال است. پنجره‌های موجود عبارتند از:

•everywhere (همه جا)
•feedlist (فهرست خوراک‌ها)
•filebrowser (مرورگر فایل)
•help (راهنما)
•articlelist (فهرست مقالات)
•article (مقاله)
•tagselection (انتخاب برچسب)
•filterselection (انتخاب فیلتر)
•urlview (نمای پیوند)
•podboat (پادکست‌خوان podboat)
•dirbrowser (مرورگر دایرکتوری)
•searchresultslist (فهرست نتایج جستجو)

چندین پنجره را می‌توان با کاما مشخص کرد. برای مثال:

bind k feedlist,articlelist,urlview up
bind j feedlist,articlelist,urlview down

یا با استفاده از everywhere برای اعمال میانبر در تمام پنجره‌ها:

bind k everywhere up
bind j everywhere down

فهرست عملیات (Operation List)

عملیات‌ها با فشردن توالی متناظر کلیدها اجرا می‌شوند. برای مشاهده فهرست کامل عملیات موجود به بخش‌های [_newsboat_operations] و [_podboat_operations] مراجعه کنید.

چندین عملیات را می‌توان با جدا کردن آن‌ها با نقطه ویرگول (;) تعیین کرد. برخی عملیات‌ها اجازه تعیین یک آرگومان را می‌دهند، به عنوان مثال دستور set <config option> <config value> می‌تواند برای تغییر یک گزینه پیکربندی استفاده شود.

یک توالی با دو خط تیره که به دنبال آن متنی در نقل‌قول دوتایی قرار دارد می‌تواند برای افزودن توضیحات به میانبر استفاده شود (مانند -- "some description"). در صورت وجود، این توضیحات در پنجره راهنما نمایش داده می‌شوند.

در ترکیب با یکدیگر، این موارد ممکن است به این شکل باشند:

bind of everywhere set browser "firefox" ; open-in-browser -- "Open in Firefox"

مثال بالا به این معناست که فشردن کلید o و به دنبال آن f، مرورگر پیکربندی‌شده را به firefox تغییر می‌دهد و سپس دستور open-in-browser را برای باز کردن خوراک/مقاله در مرورگر پیکربندی‌شده اجرا می‌کند.

دستور bind شبیه به ماکروهاست اما انعطاف‌پذیرتر است. ماکروها به صورت سراسری پیکربندی می‌شوند، در حالی که bind می‌تواند روی پنجره‌های خاص اعمال شود. علاوه بر این، ماکروها همیشه نیازمند فشردن ۲ کلید هستند (macro-prefix به دنبال کلید اختصاصی ماکرو)، در حالی که bind می‌تواند توالی کلیدی با هر طولی را مشخص کند.

می‌توانید با دستور پیکربندی bind-key یک کلید منفرد را به یک عملیات منفرد مقید کنید. این روش ساختاری قدیمی‌تر و محدودتر برای کلیدهای میانبر است. می‌توانید یک پنجره اختیاری را نیز مشخص کنید که بستری است که میانبر کلیدی در آن فعال خواهد بود.

ساختار دستوری برای میانبر کلیدی سبک قدیمی به این شکل است:

bind-key <key> <operation> [<dialog>]

کلید (Key)

کلیدهای کوچک، کلیدهای بزرگ و نویسه‌های خاص به صورت دقیق و لفظی نوشته می‌شوند.

ترکیب‌های کلیدی با Ctrl با استفاده از علامت هشتک (caret) ^ نوشته می‌شوند. برای نمونه، Ctrl + R معادل ^R است. لطفاً توجه داشته باشید که تمامی ترکیب‌های کلیدی مرتبط با Ctrl باید با حروف بزرگ نوشته شوند.

شناسه‌های زیر برای کلیدهای ویژه پشتیبانی می‌شوند:

•ENTER (کلید Enter)
•BACKSPACE (کلید Backspace)
•LEFT (مکان‌نمای چپ)
•RIGHT (مکان‌نمای راست)
•UP (مکان‌نمای بالا)
•DOWN (مکان‌نمای پایین)
•PPAGE (کلید Page Up)
•NPAGE (کلید Page Down)
•HOME (مکان‌نما به ابتدای فهرست/مقاله)
•END (مکان‌نما به انتهای فهرست/مقاله)
•ESC (کلید Esc)
•TAB (کلید Tab)
•F1 تا F12 (کلیدهای F1 تا F12)

عملیات (Operation)

یک عملیات با فشردن کلید مربوطه اجرا می‌شود. برای مشاهده فهرست کامل عملیات موجود به بخش‌های [_newsboat_operations] و [_podboat_operations] مراجعه کنید.

پنجره (Dialog)

یک پنجره (dialog) بستری است که میانبر کلیدی در آن فعال است. پنجره‌های موجود عبارتند از:

•all (پیش‌فرض در صورت عدم تعیین)
•feedlist
•filebrowser
•help
•articlelist
•article
•tagselection
•filterselection
•urlview
•podboat
•dirbrowser
•searchresultslist

پیکربندی تنظیمات رنگ سفارشی در Newsboat امکان‌پذیر است. ساختار پایه پیکربندی به صورت زیر است:

color <element> <foreground color> <background color> [<attribute> ...]

این به آن معناست که اگر رنگ‌ها را برای یک عنصر خاص پیکربندی می‌کنید، حداقل باید یک رنگ پیش‌زمینه و یک رنگ پس‌زمینه تعیین کنید. رنگ‌های زیر پشتیبانی می‌شوند:

•black (سیاه)
•red (قرمز)
•green (سبز)
•yellow (زرد)
•blue (آبی)
•magenta (ارغوانی)
•cyan (فیروزه‌ای)
•white (سفید)
•default (پیش‌فرض)
•color<n>، مثلاً color123

رنگ default به این معناست که از رنگ پیش‌فرض ترمینال استفاده خواهد شد. نام رنگ color<n> (که در آن <n> یک عدد ده‌دهی است که با صفر شروع نمی‌شود) در صورتی که ترمینال شما از ۲۵۶ رنگ پشتیبانی کند (مانند gnome-terminal یا xterm با متغیر TERM تنظیم‌شده روی xterm-256color) می‌تواند استفاده شود. نرم‌افزار Newsboat از نسخه ۲٫۱ از ترمینال‌های ۲۵۶ رنگ پشتیبانی می‌کند. برای جدول کامل رنگ‌ها و شماره‌های متناظر آن‌ها، لطفاً به پیوند زیر مراجعه کنید: https://www.calmar.ws/vim/256-xterm-24bit-rgb-color-chart.html.

همچنین می‌توانید به صورت اختیاری یک یا چند صفت را اضافه کنید. صفت‌های زیر پشتیبانی می‌شوند:

•standout
•underline
•reverse
•blink
•dim
•bold
•protect
•invis

در حال حاضر، عناصر زیر پشتیبانی می‌شوند:

•background: پس‌زمینه برنامه
•listnormal: یک آیتم معمولی فهرست
•listfocus: آیتم انتخاب‌شده جاری فهرست
•listnormal_unread: یک آیتم خوانده‌نشده فهرست
•listfocus_unread: آیتم خوانده‌نشده انتخاب‌شده جاری در فهرست
•title (افزوده‌شده در ۲٫۲۵): عنوان پنجره جاری، که معمولاً در بالای صفحه قرار دارد (اما به show-title-bar و swap-title-and-hints نیز مراجعه کنید). اگر سبکی برای این عنصر تعیین نکنید، از سبک info استفاده می‌شود
•info: نوار نکات، که معمولاً در پایین صفحه قرار دارد (اما به show-keymap-hint و swap-title-and-hints نیز مراجعه کنید)
•hint-key (افزوده‌شده در ۲٫۲۵): یک کلید در نوار نکات. اگر سبکی برای این عنصر تعیین نکنید، از سبک info استفاده می‌شود
•hint-keys-delimiter (افزوده‌شده در ۲٫۲۵): ویرگولی که کلیدها را در نوار نکات از هم جدا می‌کند. اگر سبکی برای این عنصر تعیین نکنید، از سبک info استفاده می‌شود
•hint-separator (افزوده‌شده در ۲٫۲۵): دونقطه‌ای که کلیدها را از توضیحاتشان در نوار نکات جدا می‌کند. اگر سبکی تعیین نکنید، از سبک info استفاده می‌شود
•hint-description (افزوده‌شده در ۲٫۲۵): توضیح یک کلید در نوار نکات. اگر سبکی تعیین نکنید، از سبک info استفاده می‌شود
•article: متن مقاله
•end-of-text-marker: خطوط پرکننده (~) در زیر بلوک‌های متن

پیکربندی پیش‌فرض رنگ Newsboat به این صورت است:

color background&          white&   black
color listnormal&          white&   black
color listfocus&           yellow&  blue&   bold
color listnormal_unread&   white&   black&  bold
color listfocus_unread&    yellow&  blue&   bold
color title&               yellow&  blue&   bold
color info&                yellow&  blue&   bold
color hint-key&            yellow&  blue&   bold
color hint-keys-delimiter white&   blue
color hint-separator&      white&   blue&   bold
color hint-description&    white&   blue
color article&             white&   black

always-display-description (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، توضیحات همیشه نمایش داده می‌شوند حتی اگر مثلاً تگ <content:encoded> یافت شده باشد. (مثال: always-display-description yes)

always-download (پارامترها: <url> [<url>...]؛ مقدار پیش‌فرض: n/a)

یک یا چند URL خوراک را مشخص می‌کند که باید همواره بدون توجه به برچسب زمانی Last-Modified و هدر ETag دانلود شوند. این گزینه می‌تواند چندین بار مشخص شود. (مثال: always-download "https://www.n-tv.de/23.rss")

article-sort-order (پارامترها: <sortfield>[-<direction>]؛ مقدار پیش‌فرض: date-asc)

پارامتر <sortfield> مشخص می‌کند کدام ویژگی مقاله برای مرتب‌سازی استفاده شود. موارد موجود در حال حاضر: date، title، flags، author، link، guid و random. پارامتر اختیاری <direction> می‌تواند asc برای صعودی، یا desc برای نزولی باشد. توجه داشته باشید که جهت بر مرتب‌سازی random تأثیری ندارد. برای date، ترتیب پیش‌فرض desc است (یعنی date همان date-desc است)؛ برای سایر موارد، asc پیش‌فرض است. همچنین، جهت‌ها برای date معکوس هستند: desc یعنی جدیدترین موارد در ابتدا می‌آیند، در حالی که asc یعنی قدیمی‌ترین موارد در ابتدا می‌آیند. این ناهماهنگی در نسخه‌های اصلی آینده Newsboat برطرف خواهد شد. (مثال: article-sort-order author-desc)

articlelist-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%4i %f %D %6L %?T?|%-17T| ?%t")

این متغیر قالب مدخل‌ها در فهرست مقالات را تعریف می‌کند. برای اطلاعات بیشتر به بخش FORMAT STRINGS در این مستندات مراجعه کنید. (مثال: articlelist-format "%4i %f %D %?T?|%-17T| ?%t")

articlelist-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Articles in feed '%T' (%u unread, %t total)%?F? matching filter '%F'&? - %U" (بومی‌سازی‌شده))

قالب عنوان در فهرست مقالات. برای جزئیات در مورد قالب‌های در دسترس به بخش FORMAT STRINGS راهنمای Newsboat مراجعه کنید. (مثال: articlelist-title-format "Articles in feed '%T' (%u unread)")

auto-reload (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام خوراک‌ها هنگام شروع به صورت خودکار و سپس به طور مداوم پس از گذشت زمانی مشخص (به reload-time مراجعه کنید) بازخوانی می‌شوند. همچنین برای بازخوانی خوراک‌ها تنها در هنگام شروع، به refresh-on-startup مراجعه کنید. فعال کردن suppress-first-reload از بازخوانی هنگام شروع صرف‌نظر می‌کند. (مثال: auto-reload yes)

bind (پارامترها: <key-sequence> <dialog>[,<dialog>] <command-list> [-- "<binding description>"]؛ مقدار پیش‌فرض: n/a)

توالی کلیدهای <key-sequence> را به <command-list> مقید می‌کند. این بدان معناست که هر زمان کلیدهای <key-sequence> به ترتیب فشرده شوند، فهرست دستورات در <command-list> اجرا می‌شود (اگر در پنجره جاری قابل اجرا باشد). برای اطلاعات بیشتر به بخش Key Bindings مراجعه کنید. به صورت اختیاری می‌توان یک توضیح اضافه کرد که در پنجره راهنما نشان داده می‌شود. همچنین برای حذف یک میانبر به unbind-key مراجعه کنید. (مثال: bind of everywhere set browser "firefox" ; open-in-browser)

bind-key (پارامترها: <key> <operation> [<dialog>]؛ مقدار پیش‌فرض: n/a)

کلید <key> را به عملیات <operation> مقید می‌کند. به این معنا که هر زمان <key> فشرده شود، عملیات <operation> اجرا می‌گردد (در صورت کاربرد در پنجره جاری). برای اطلاعات بیشتر به بخش Old Style Key Bindings مراجعه کنید. همچنین برای حذف میانبر به unbind-key مراجعه کنید. (مثال: bind-key ^R reload-all)

bookmark-autopilot (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، دستور نشانک‌گذاری پیکربندی‌شده بدون درخواست ورودی بیشتر از کاربر اجرا می‌شود، مگر اینکه نشانی URL یا عنوان یافت/حدس زده نشود. (مثال: bookmark-autopilot yes)

bookmark-cmd (پارامترها: <command>؛ مقدار پیش‌فرض: "")

در صورت تعیین، <command> به عنوان پلاگین نشانک‌گذاری استفاده خواهد شد. برای اطلاعات بیشتر به مستندات نشانک‌گذاری مراجعه کنید. (مثال: bookmark-cmd "~/bin/delicious-bookmark.sh")

bookmark-interactive (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، دستور نشانک‌گذاری پیکربندی‌شده یک برنامه تعاملی خواهد بود. (مثال: bookmark-interactive yes)

browser (پارامترها: <command>؛ مقدار پیش‌فرض: %BROWSER، در غیر این صورت lynx)

دستور مرورگر مورد استفاده هنگام باز کردن یک مقاله در مرورگر را تنظیم می‌کند. اگر متغیر محیطی BROWSER تنظیم شده باشد، به عنوان مرورگر پیش‌فرض استفاده می‌شود، در غیر این صورت lynx استفاده خواهد شد. برای اطلاعات بیشتر به Using Browser مراجعه کنید. (مثال: browser "w3m %u")

cache-file (پارامترها: <path>؛ مقدار پیش‌فرض: "~/.newsboat/cache.db" یا "~/.local/share/cache.db" (به بخش FILES مراجعه کنید))

این گزینه فایل حافظه نهان را تعیین می‌کند. این گزینه به‌ویژه زمانی مفید است که فایل‌سیستم دایرکتوری خانگی شما از قفل‌گذاری مناسب پشتیبانی نمی‌کند (مانند NFS). (مثال: cache-file "/tmp/testcache.db")

cleanup-on-quit (پارامترها: [yes/no/nudge]؛ مقدار پیش‌فرض: nudge)

در صورت تنظیم روی yes، حافظه نهان قفل شده و خوراک‌ها و آیتم‌های زائد حذف می‌شوند، مانند خوراک‌هایی که دیگر در فایل پیکربندی urls یافت نمی‌شوند. برای انجام دستی این کار newsboat --cleanup را اجرا کنید. اگر با هشداری مبنی بر یافت شدن خوراک‌های غیرقابل دسترس مواجه شدید، می‌توانید با ایجاد یک فایل لاگ از طریق گزینه error-log، نشانی‌های خوراک‌ها را مشاهده کنید. در حالت nudge، در صورت چاپ هشدار، Newsboat منتظر ورودی کاربر می‌ماند. (مثال: cleanup-on-quit yes)

color (پارامترها: <element> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیش‌فرض: n/a)

رنگ پیش‌زمینه، پس‌زمینه و صفت‌های اختیاری را برای یک عنصر معین تنظیم می‌کند. برای رنگ‌ها و صفت‌های موجود به بخش Colors مراجعه کنید. (مثال: color background white black)

confirm-delete-all-articles (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، برنامه Newsboat برای تأیید حذف تمامی مقالات از کاربر سؤال می‌پرسد. (مثال: confirm-delete-all-articles no)

confirm-exit (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، برنامه Newsboat برای تأیید خروج واقعی از برنامه سؤال می‌پرسد. (مثال: confirm-exit yes)

confirm-mark-all-feeds-read (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، برنامه Newsboat از کاربر برای تأیید علامت‌گذاری تمام خوراک‌ها به عنوان خوانده‌شده سؤال می‌پرسد. (مثال: confirm-mark-all-feeds-read no)

confirm-mark-feed-read (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، برنامه Newsboat از کاربر برای تأیید علامت‌گذاری یک خوراک به عنوان خوانده‌شده سؤال می‌پرسد. (مثال: confirm-mark-feed-read no)

cookie-cache (پارامترها: <path>؛ مقدار پیش‌فرض: "")

یک حافظه نهان برای کوکی‌ها تنظیم می‌کند. در صورت تنظیم، کوکی‌ها در این فایل با استفاده از قالب Netscape http://www.cookiecentral.com/faq/#3.5. ذخیره و خوانده می‌شوند. (مثال: cookie-cache "~/.newsboat/cookies.txt")

datetime-format (پارامترها: <date/time format>؛ مقدار پیش‌فرض: %b %d)

این قالب، شکل تاریخ/زمان را در فهرست مقالات مشخص می‌کند. برای مستندات دقیق درباره بیشتر قالب‌های مجاز، به صفحه راهنمای strftime(3) مراجعه کنید. %L یک قالب سفارشی ناموجود در strftime است که تعداد روزهای سپری‌شده از انتشار مقاله را فهرست می‌کند (مثلاً "2 days ago"). (مثال: datetime-format "%D, %R")

define-filter (پارامترها: <name> <filterexpr>؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید فیلترهایی را از پیش تعریف کنید تا بعداً از یک فهرست انتخاب کرده و پس از انتخاب اعمال شوند. این ویژگی به ویژه برای فیلترهایی که مکرراً به آن‌ها نیاز دارید و نمی‌خواهید هر بار آن‌ها را دوباره وارد کنید مفید است. (مثال: define-filter "all feeds with 'fun' tag" "tags # \"fun\"")

delete-read-articles-on-quit (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام مقالات خوانده‌شده هنگام خروج از Newsboat حذف خواهند شد. این گزینه تنها در صورتی اعمال می‌شود که cleanup-on-quit روی yes تنظیم شده باشد یا آرگومان —cleanup داده شود. (مثال: delete-read-articles-on-quit yes)

dialogs-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Dialogs" (بومی‌سازی‌شده))

قالب عنوان در فهرست پنجره‌ها. برای جزئیات درباره قالب‌های موجود به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: dialogs-title-format "%N %V - Dialogs")

dirbrowser-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - %?O?Open Directory&Save File? - %f" (بومی‌سازی‌شده))

قالب عنوان در مرورگر دایرکتوری. برای جزئیات درباره قالب‌های موجود به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: dirbrowser-file-format "%?O?Open Directory&Save File? - %f")

display-article-progress (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، درصد پیشرفت خواندن مقاله در نمای مقاله نمایش داده می‌شود. در غیر این صورت، پیشرفت خواندن نمایش داده نخواهد شد. (مثال: display-article-progress no)

download-full-page (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، برای تمام آیتم‌های خوراک که محتوایی ندارند اما دارای پیوند هستند، صفحه پیوند دانلود شده و نتیجه آن به عنوان محتوا استفاده می‌شود. این گزینه ممکن است زمان دانلود خوراک‌های «خالی» را به طور چشمگیری افزایش دهد. (مثال: download-full-page yes)

download-retries (پارامترها: <number>؛ مقدار پیش‌فرض: 1)

تعداد دفعاتی که Newsboat قبل از انصراف تلاش می‌کند تا یک خوراک را با موفقیت دانلود کند. این گزینه برای بهبود موفقیت دانلودها در اتصالات کند و ناپایدار (مانند پروکسی TOR) است. (مثال: download-retries 4)

download-timeout (پارامترها: <number>؛ مقدار پیش‌فرض: 30)

تعداد ثانیه‌هایی که Newsboat هنگام دانلود یک خوراک قبل از انصراف منتظر می‌ماند. این گزینه برای بهبود موفقیت دانلودها در اتصالات کند و ناپایدار (مانند پروکسی TOR) است. (مثال: download-timeout 60)

error-log (پارامترها: <path>؛ مقدار پیش‌فرض: "")

در صورت تنظیم، خطاهای کاربر (مانند خطاهای مربوط به خوراک‌های نامعتبر یا از کار افتاده RSS) در این فایل ثبت می‌شوند. (مثال: error-log "~/.newsboat/error.log")

external-url-viewer (پارامترها: <command>؛ مقدار پیش‌فرض: "")

در صورت تنظیم، دستور show-urls مقاله جاری را به جای استفاده از نمایش‌دهنده داخلی پیوند، به یک ابزار خارجی ارسال (pipe) می‌کند. این گزینه می‌تواند برای ادغام ابزارهایی مانند urlview استفاده شود. (مثال: external-url-viewer "urlview")

feed-sort-order (پارامترها: <sortfield>[-<direction>]؛ مقدار پیش‌فرض: none)

پارامتر <sortfield> مشخص می‌کند کدام ویژگی خوراک برای مرتب‌سازی استفاده شود؛ موارد موجود در حال حاضر عبارتند از: firsttag، title، articlecount، unreadarticlecount، lastupdated، latestunread و none. پارامتر اختیاری <direction> جهت مرتب‌سازی را مشخص می‌کند؛ asc برای صعودی و desc برای نزولی. مقدار پیش‌فرض desc است. (مثال: feed-sort-order firsttag)

feedbin-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Feedbin، مقالاتی که با این پرچم مشخص شده‌اند در Feedbin ستاره‌دار شده و در فهرست "Starred items" ظاهر می‌شوند. (مثال: feedbin-flag-star "b")

feedbin-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

این متغیر نام کاربری شما را برای پشتیبانی از Feedbin تنظیم می‌کند. (مثال: feedbin-login "your-login")

feedbin-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

این متغیر گذرواژه شما را برای پشتیبانی از Feedbin تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: feedbin-password "here_goesAquote:\"")

feedbin-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: feedbin-passwordeval "gpg --decrypt ~/.newsboat/feedbin-password.gpg")

feedbin-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

یک جایگزین دیگر، ذخیره گذرواژه متنی در جای دیگری از سیستم شماست. (مثال: feedbin-passwordfile "~/.newsboat/feedbin-pw.txt")

feedbin-url (پارامترها: <url>؛ مقدار پیش‌فرض: "https://api.feedbin.com")

نشانی اینترنتی محل استقرار نصب Feedbin مورد نظر را پیکربندی می‌کند. (مثال: feedbin-url "https://example.com/feedbin")

feedhq-flag-share (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از FeedHQ، مقالاتی که با پرچم مشخص‌شده علامت‌گذاری شده‌اند در FeedHQ به اشتراک گذاشته می‌شوند تا دنبال‌کنندگان شما بتوانند آن‌ها را ببینند. (مثال: feedhq-flag-share "a")

feedhq-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از FeedHQ، مقالاتی که با پرچم مشخص‌شده علامت‌گذاری شده‌اند در FeedHQ ستاره‌دار می‌شوند و در فهرست "Starred items" نمایش می‌یابند. (مثال: feedhq-flag-star "b")

feedhq-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

این متغیر نام کاربری شما را برای پشتیبانی از FeedHQ تنظیم می‌کند. (مثال: feedhq-login "your-login")

feedhq-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 20)

این متغیر تعداد مقالاتی را که به ازای هر خوراک از FeedHQ بارگیری می‌شوند تعیین می‌کند. (مثال: feedhq-min-items 100)

feedhq-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

این متغیر گذرواژه شما را برای پشتیبانی از FeedHQ تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: feedhq-password "here_goesAquote:\"")

feedhq-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از فایل رمزنگاری‌شده gpg یا دسته کلید سیستم استفاده شود. (مثال: feedhq-passwordeval "gpg --decrypt ~/.newsboat/feedhq-password.gpg")

feedhq-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

یک جایگزین دیگر، ذخیره گذرواژه متنی در جای دیگری از سیستم شما است. (مثال: feedhq-passwordfile "~/.newsboat/feedhq-pw.txt")

feedhq-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم و استفاده از FeedHQ، «خوراک‌های ویژه» مانند "People you follow" (مقالات به اشتراک گذاشته‌شده توسط افرادی که دنبال می‌کنید)، "Starred items" (مقالات ستاره‌دار شما) و "Shared items" (مقالات به اشتراک گذاشته‌شده شما) در فهرست اشتراک‌های شما ظاهر می‌شوند. (مثال: feedhq-show-special-feeds "no")

feedhq-url (پارامترها: <url>؛ مقدار پیش‌فرض: "https://feedhq.org")

نشانی URL محل استقرار نمونه FeedHQ شما را پیکربندی می‌کند. (مثال: feedhq-url "https://feedhq.example.com")

feedlist-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%4i %n %11u %t")

این متغیر قالب مدخل‌ها در فهرست خوراک‌ها را تعیین می‌کند. برای اطلاعات بیشتر به بخش FORMAT STRINGS در این مستندات مراجعه کنید. (مثال: feedlist-format " %n %4i - %11u -%> %t")

feedlist-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - %?F?Feeds&Your feeds? (%u unread, %t total)%?F? matching filter '%F'&?%?T? - tag '%T'&?" (بومی‌سازی‌شده))

قالب عنوان در فهرست خوراک‌ها. برای جزئیات در مورد قالب‌های در دسترس به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: feedlist-title-format "Feeds (%u unread, %t total)")

filebrowser-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - %?O?Open File&Save File? - %f" (بومی‌سازی‌شده))

قالب عنوان در مرورگر فایل. برای جزئیات درباره قالب‌های موجود به بخش FORMAT STRINGS راهنمای Newsboat مراجعه کنید. (مثال: filebrowser-title-format "%?O?Open File&Save File? - %f")

freshrss-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از FreshRSS، تمام مقالاتی که با این پرچم مشخص شده‌اند در FreshRSS ستاره‌دار می‌شوند و در فهرست "Starred items" ظاهر می‌شوند. (مثال: freshrss-flag-star "b")

freshrss-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

این متغیر نام کاربری شما را برای پشتیبانی از FreshRSS تنظیم می‌کند. (مثال: freshrss-login "your-login")

freshrss-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 20)

این متغیر تعداد مقالاتی را که به ازای هر خوراک از FreshRSS بارگیری می‌شوند تعیین می‌کند. (مثال: freshrss-min-items 100)

freshrss-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

این متغیر گذرواژه FreshRSS شما را تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: freshrss-password "here_goesAquote:\"")

freshrss-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: freshrss-passwordeval "gpg --decrypt ~/.newsboat/freshrss-password.gpg")

freshrss-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

یک جایگزین دیگر، ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما است. (مثال: freshrss-passwordfile "~/.newsboat/freshrss-pw.txt")

freshrss-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم و استفاده از پشتیبانی FreshRSS، یک خوراک "Starred items" (حاوی مقالات ستاره‌دار/مورد علاقه شما) در فهرست اشتراک‌های شما ظاهر می‌شود. (مثال: freshrss-show-special-feeds "no")

freshrss-url (پارامترها: <url>؛ مقدار پیش‌فرض: "")

نشانی URL مربوط به نقطه پایانی Google Reader API نمونه FreshRSS شما را پیکربندی می‌کند. (مثال: freshrss-url "https://freshrss.example.com/api/greader.php")

goto-first-unread (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، هر زمان که وارد یک خوراک شوید، نخستین مقاله خوانده‌نشده انتخاب خواهد شد. (مثال: goto-first-unread no)

goto-next-feed (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، اگر تمام مقالات خوراک جاری خوانده شده باشند، کلیدهای next-unread، prev-unread و random-unread در خوراک‌های دیگر به دنبال مقالات خوانده‌نشده می‌گردند. در صورت تنظیم روی no، این کلیدها در خوراک جاری متوقف می‌شوند. (مثال: goto-next-feed no)

help-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Help" (بومی‌سازی‌شده))

قالب عنوان در پنجره راهنما. برای جزئیات درباره قالب‌های موجود به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: help-title-format "%N %V - Help")

highlight (پارامترها: <target> <regex> <fgcolor> [<bgcolor> [<attribute> ...]]؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید بخش‌هایی از متن را در فهرست خوراک‌ها، فهرست مقالات و نمای مقاله برجسته (highlight) کنید. برای رنگ‌ها و صفت‌های موجود به بخش Colors مراجعه کنید. (مثال: highlight all "newsboat" red)

highlight-article (پارامترها: <filterexpr> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید مقالاتی را در فهرست مقالات که با یک عبارت فیلتر مطابقت دارند برجسته کنید. برای رنگ‌ها و صفت‌های موجود به بخش Colors مراجعه کنید. (مثال: highlight-article "author =~ \"Andreas Krennmair\"" white red bold)

highlight-feed (پارامترها: <filterexpr> <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید خوراک‌هایی را در فهرست خوراک‌ها که با یک عبارت فیلتر مطابقت دارند برجسته کنید. برای رنگ‌ها و صفت‌های موجود به بخش Colors مراجعه کنید. (مثال: highlight-feed unread › 100 white red bold)

history-limit (پارامترها: <number>؛ مقدار پیش‌فرض: 100)

حداکثر تعداد مدخل‌های تاریخچه خط فرمان یا تاریخچه جستجو را برای ذخیره‌سازی تعیین می‌کند. برای غیرفعال کردن ذخیره تاریخچه، آن را روی 0 تنظیم کنید. (مثال: history-limit 0)

html-renderer (پارامترها: <command>؛ مقدار پیش‌فرض: internal)

در صورت تنظیم روی internal، از رندرکننده داخلی HTML استفاده خواهد شد. در غیر این صورت، دستور مشخص‌شده اجرا می‌شود، کد HTML به ورودی استاندارد (stdin) آن دستور ارسال شده و خروجی برنامه نمایش داده می‌شود. این ویژگی استفاده از برنامه‌های خارجی مانند w3m، links یا lynx را برای رندر HTML ممکن می‌سازد. (مثال: html-renderer "w3m -dump -T text/html";)

http-auth-method (پارامترها: <method>؛ مقدار پیش‌فرض: any)

روش احراز هویت HTTP را تنظیم می‌کند. مقادیر مجاز عبارتند از: any، basic، digest، digest_ie (تنها با libcurl 7.19.3 و جدیدتر در دسترس است)، gssnegotiate، ntlm و anysafe. (مثال: http-auth-method digest)

ignore-article (پارامترها: <feed> <filterexpr>؛ مقدار پیش‌فرض: n/a)

اگر یک مقاله دانلودشده از <feed> با <filterexpr> مطابقت داشته باشد، نادیده گرفته شده و به کاربر نمایش داده نمی‌شود. این دستور در بخش KILLFILES در ادامه بیشتر توضیح داده شده است. (مثال: ignore-article "*" "title =~ \"Windows\"")

ignore-mode (پارامترها: [download/display]؛ مقدار پیش‌فرض: download)

این گزینه نحوه نادیده‌گرفتن مقاله را مشخص می‌کند (به ignore-article مراجعه کنید). اگر روی download تنظیم شود، مقاله در مرحله دانلود/تجزیه نادیده گرفته شده و هرگز در حافظه نهان نوشته نمی‌شود؛ اگر روی display تنظیم شود، هنگام نمایش مقالات نادیده گرفته می‌شود اما در حافظه نهان نگهداری خواهد شد. (مثال: ignore-mode "display")

include (پارامترها: <path>؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید فایل‌های دیگری را برای تفسیر به عنوان فایل‌های پیکربندی بگنجانید. این ویژگی به ویژه برای تفکیک پیکربندی به چندین فایل (مثلاً پیکربندی کلیدها، پیکربندی رنگ‌ها و...) مفید است. (مثال: include "~/.newsboat/colors")

inoreader-app-id (پارامترها: <string>؛ مقدار پیش‌فرض: "")

شناسه یکتای برنامه (App ID) صادرشده توسط Inoreader. به بخش "Inoreader" مراجعه کنید. (مثال: inoreader-app-id "123456789")

inoreader-app-key (پارامترها: <string>؛ مقدار پیش‌فرض: "")

کلید برنامه (App Key) صادرشده توسط Inoreader. به بخش "Inoreader" مراجعه کنید. (مثال: inoreader-app-key "TmV3c2JvYXQgcm9ja3MgOikK")

inoreader-flag-share (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Inoreader، مقالاتی که با این پرچم مشخص شده‌اند در Inoreader به اشتراک گذاشته می‌شوند تا دنبال‌کنندگان بتوانند آن‌ها را ببینند. (مثال: inoreader-flag-share "a")

inoreader-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Inoreader، مقالاتی که با این پرچم مشخص شده‌اند در Inoreader ستاره‌دار شده و در فهرست "Starred items" ظاهر می‌شوند. (مثال: inoreader-flag-star "b")

inoreader-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

این متغیر نام کاربری شما را برای پشتیبانی از Inoreader تنظیم می‌کند. (مثال: inoreader-login "your-login")

inoreader-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 20)

این متغیر تعداد مقالاتی را که به ازای هر خوراک از Inoreader بارگیری می‌شوند تعیین می‌کند. (مثال: inoreader-min-items 100)

inoreader-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

این متغیر گذرواژه Inoreader شما را تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: inoreader-password "here_goesAquote:\"")

inoreader-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. (مثال: inoreader-passwordeval "gpg --decrypt ~/.newsboat/inoreader-password.gpg")

inoreader-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، با ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما. (مثال: inoreader-passwordfile "~/.newsboat/inoreader-pw.txt")

inoreader-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم و استفاده از Inoreader، خوراک‌های ویژه مانند "Starred items" (مقالات ستاره‌دار شما) و "Shared items" (مقالات به اشتراک گذاشته‌شده شما) در فهرست اشتراک‌ها نمایش داده می‌شوند. (مثال: inoreader-show-special-feeds "no")

itemview-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Article '%T' (%u unread, %t total)" (بومی‌سازی‌شده))

قالب عنوان در نمای مقاله. برای جزئیات درباره قالب‌های موجود به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: itemview-title-format "Article '%T'")

keep-articles-days (پارامترها: <number>؛ مقدار پیش‌فرض: 0)

اگر روی عددی بزرگتر از 0 تنظیم شود، فقط مقالاتی که در طول <number> روز اخیر منتشر شده‌اند نگهداری می‌شوند و مقالات قدیمی‌تر حذف خواهند شد. اگر روی 0 تنظیم شود، این گزینه غیرفعال است. توجه داشته باشید که تغییر این تنظیم مقالاتی را که قبلاً حذف شده‌اند بازنمی‌گرداند؛ در حال حاضر راه مستقیمی برای بازیابی مقالات حذف‌شده وجود ندارد. (مثال: keep-articles-days 30)

macro (پارامترها: <macro key> <command list> [-- "<macro description>"]؛ مقدار پیش‌فرض: n/a)

با این دستور می‌توانید یک کلید ماکرو تعریف کرده و فهرستی از دستورات را مشخص کنید که هنگام فشردن پیشوند ماکرو و سپس کلید ماکرو اجرا شوند. به صورت اختیاری می‌توان یک توضیح نیز اضافه کرد. در صورت وجود، توضیح در پنجره راهنما نشان داده می‌شود. (مثال: macro k open; reload; quit -- "enter feed to reload it")

mark-as-read-on-hover (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام مقالاتی که در فهرست مقالات انتخاب می‌شوند به عنوان خوانده‌شده علامت‌گذاری خواهند شد. (مثال: mark-as-read-on-hover yes)

max-browser-tabs (پارامترها: <number>؛ مقدار پیش‌فرض: 10)

حداکثر تعداد مقالاتی را که هنگام استفاده از دستورات open-all-unread-in-browser یا open-all-unread-in-browser-and-mark-read در مرورگر باز می‌شوند تنظیم می‌کند. (مثال: max-browser-tabs 4)

max-download-speed (پارامترها: <number>؛ مقدار پیش‌فرض: 0)

اگر روی عددی بزرگتر از 0 تنظیم شود، سرعت بارگیری برای هر دانلود به این سقف (بر حسب کیلوبایت بر ثانیه) محدود می‌شود. (مثال: max-download-speed 50)

max-items (پارامترها: <number>؛ مقدار پیش‌فرض: 0)

حداکثر تعداد مقالاتی را که یک خوراک می‌تواند شامل شود تعیین می‌کند. با عبور از این آستانه، مقالات قدیمی‌تر حذف می‌شوند. اگر روی 0 تنظیم شود، تمام مقالات نگهداری می‌شوند. (مثال: max-items 100)

miniflux-flag-save (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Miniflux، مقالاتی که با این پرچم مشخص شده‌اند در سرویس خارجی پیکربندی‌شده روی نمونه Miniflux ذخیره می‌شوند. (مثال: miniflux-flag-save "b")

miniflux-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Miniflux، تمام مقالاتی که با پرچم مشخص‌شده علامت‌گذاری شده‌اند در Miniflux ستاره‌دار شده و در فهرست "Starred items" ظاهر می‌شوند. (مثال: miniflux-flag-star "b")

miniflux-login (پارامترها: <username>؛ مقدار پیش‌فرض: "")

نام کاربری مورد استفاده با Miniflux را تنظیم می‌کند. (مثال: miniflux-login "admin")

miniflux-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 100)

تعداد مقالاتی را که به ازای هر خوراک از Miniflux بارگیری می‌شوند تنظیم می‌کند. (مثال: miniflux-min-items 20)

miniflux-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

گذرواژه مورد استفاده با Miniflux را پیکربندی می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: miniflux-password "here_goesAquote:\"")

miniflux-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: miniflux-passwordeval "gpg --decrypt ~/.newsboat/miniflux-password.gpg")

miniflux-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما است. (مثال: miniflux-passwordfile "~/.newsboat/miniflux-pw.txt")

miniflux-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم و استفاده از پشتیبانی Miniflux، خوراک "Starred items" (شامل مقالات ستاره‌دار یا برگزیده شما) در فهرست اشتراک‌ها نمایش می‌یابد. (مثال: miniflux-show-special-feeds "no")

miniflux-token (پارامترها: <API Token>؛ مقدار پیش‌فرض: "")

توکن API را برای استفاده با Miniflux تنظیم می‌کند. (مثال: miniflux-token "E-uTqU8r55KucuHz26tJbXfrZVRndwY_mZAsEfcC8Bg=")

miniflux-tokeneval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

جایگزین امن‌تر، دریافت توکن API از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. (مثال: miniflux-tokeneval "gpg --decrypt ~/.newsboat/miniflux-token.gpg")

miniflux-tokenfile (پارامترها: <API Token>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، ذخیره توکن متنی در فایلی در سیستم شما است. (مثال: miniflux-tokenfile "~/.newsboat/miniflux-token.txt")

miniflux-url (پارامترها: <url>؛ مقدار پیش‌فرض: "")

نشانی URL محل نصب Miniflux را پیکربندی می‌کند. (مثال: miniflux-url "https://example.com/miniflux")

newsblur-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

این متغیر نام کاربری شما را برای پشتیبانی از NewsBlur تنظیم می‌کند. (مثال: newsblur-login "your-login")

newsblur-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 20)

این متغیر تعداد مقالاتی را که به ازای هر خوراک از NewsBlur بارگیری می‌شوند تعیین می‌کند. (مثال: newsblur-min-items 100)

newsblur-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

این متغیر گذرواژه NewsBlur شما را تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: newsblur-password "here_goesAquote:\"")

newsblur-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر، دریافت گذرواژه از یک دستور خارجی هنگام ورود است. (مثال: newsblur-passwordeval "gpg --decrypt ~/.newsboat/newsblur-password.gpg")

newsblur-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما است. (مثال: newsblur-passwordfile "~/.newsboat/newsblur-pw.txt")

newsblur-url (پارامترها: <url>؛ مقدار پیش‌فرض: "https://newsblur.com")

نشانی URL نمونه NewsBlur را پیکربندی می‌کند. (مثال: newsblur-url "https://localhost")

notify-always (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی no، اعلان‌ها فقط در صورت وجود خوراک‌ها یا مقالات جدید ارسال می‌شوند. اگر روی yes تنظیم شود، اعلان‌ها در هر حالتی ارسال خواهند شد. (مثال: notify-always yes)

notify-beep (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، بلندگوی سیستم هنگام رسیدن مقالات جدید بوق می‌زند. (مثال: notify-beep yes)

notify-format (پارامترها: <string>؛ مقدار پیش‌فرض: "Newsboat: finished reload, %f unread feeds (%n unread articles total)" (بومی‌سازی‌شده))

رشته قالبی که برای ساخت اعلان‌ها استفاده می‌شود. (مثال: notify-format "%d new articles (%n unread articles, %f unread feeds)")

notify-program (پارامترها: <command>؛ مقدار پیش‌فرض: "")

در صورت تنظیم، برنامه پیکربندی‌شده هنگام رسیدن مقالات جدید (از طریق بازخوانی) یا در صورت فعال بودن notify-always اجرا خواهد شد. نخستین پارامتر برنامه فراخوانی‌شده شامل پیام اعلان است. برای ارسال آرگومان‌های دیگر به برنامه، یک اسکریپت پوششی شل بنویسید و از آن استفاده کنید. (مثال: notify-program "~/bin/my-notifier")

notify-screen (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، یک «پیام حریم خصوصی» حاوی پیام اعلان مقالات جدید به ترمینال ارسال می‌شود. این ویژگی به‌ویژه زمانی که از شبیه‌سازهای ترمینال مانند GNU screen استفاده می‌کنید که پیام‌های حریم خصوصی را پیاده‌سازی کرده‌اند، مفید است. (مثال: notify-screen yes)

notify-xterm (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، عنوان پنجره xterm روی پیام اعلان مقالات جدید تنظیم خواهد شد. (مثال: notify-xterm yes)

ocnews-flag-star (پارامترها: <character>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از ownCloud News، مقالاتی که با این پرچم مشخص شده‌اند در ownCloud News ستاره‌دار می‌شوند. (مثال: ocnews-flag-star "s")

ocnews-login (پارامترها: <username>؛ مقدار پیش‌فرض: "")

نام کاربری مورد استفاده برای نمونه ownCloud را تنظیم می‌کند. (مثال: ocnews-login "user")

ocnews-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

گذرواژه نمونه ownCloud را تعیین می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: ocnews-password "here_goesAquote:\"")

ocnews-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: ocnews-passwordeval "gpg --decrypt ~/.newsboat/ocnews-password.gpg")

ocnews-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، با ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما. (مثال: ocnews-passwordfile "~/.newsboat/ocnews-pw.txt")

ocnews-url (پارامترها: <url>؛ مقدار پیش‌فرض: "")

نشانی URL محل استقرار نمونه ownCloud را پیکربندی می‌کند. (مثال: ocnews-url "https://localhost/owncloud")

oldreader-flag-share (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از The Old Reader، تمام مقالاتی که با پرچم مشخص‌شده علامت‌گذاری شوند در The Old Reader به اشتراک گذاشته می‌شوند تا دنبال‌کنندگان شما بتوانند آن‌ها را ببینند. (مثال: oldreader-flag-share "a")

oldreader-flag-star (پارامترها: <flag>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از The Old Reader، تمام مقالاتی که با پرچم مشخص‌شده علامت‌گذاری شوند در The Old Reader ستاره‌دار شده و در فهرست "Starred items" ظاهر می‌شوند. (مثال: oldreader-flag-star "b")

oldreader-login (پارامترها: <login>؛ مقدار پیش‌فرض: "")

نام کاربری شما برای پشتیبانی از The Old Reader را تنظیم می‌کند. (مثال: oldreader-login "your-login")

oldreader-min-items (پارامترها: <number>؛ مقدار پیش‌فرض: 20)

تعداد مقالاتی که به ازای هر خوراک از The Old Reader بارگیری می‌شوند را تعیین می‌کند. (مثال: oldreader-min-items 100)

oldreader-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

گذرواژه شما را برای پشتیبانی از The Old Reader تنظیم می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: oldreader-password "here_goesAquote:\"")

oldreader-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر، دریافت گذرواژه از یک دستور خارجی در هنگام ورود است. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: oldreader-passwordeval "gpg --decrypt ~/.newsboat/oldreader-password.gpg")

oldreader-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، ذخیره گذرواژه متنی ساده در فایل. (مثال: oldreader-passwordfile "~/.newsboat/oldreader-pw.txt")

oldreader-show-special-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم و استفاده از The Old Reader، خوراک‌های ویژه مانند "People you follow" (مقالات به اشتراک گذاشته‌شده توسط افرادی که دنبال می‌کنید)، "Starred items" (مقالات ستاره‌دار شما) و "Shared items" (مقالات اشتراک‌گذاری‌شده شما) در فهرست اشتراک‌های شما نمایش می‌یابند. (مثال: oldreader-show-special-feeds "no")

openbrowser-and-mark-jumps-to-next-unread (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، وقتی مقاله‌ای در مرورگر باز شده و به عنوان خوانده‌شده علامت‌گذاری می‌شود، به آیتم خوانده‌نشده بعدی پرش می‌کند. (مثال: openbrowser-and-mark-jumps-to-next-unread yes)

opml-url (پارامترها: <url> ...؛ مقدار پیش‌فرض: "")

اگر حالت اشتراک آنلاین OPML فعال باشد، فهرست خوراک‌ها از فایل OPML موجود در این نشانی گرفته می‌شود. به صورت اختیاری می‌توانید بیش از یک نشانی تعیین کنید. تمام نشانی‌های لیست‌شده در هنگام بارگیری فهرست خوراک‌ها لحاظ می‌شوند. (مثال: opml-url "https://host.domain.tld/blogroll.opml" "https://example.com/anotheropmlfile.opml")

pager (پارامترها: [<command>/internal]؛ مقدار پیش‌فرض: internal)

در صورت تنظیم روی internal، از پیجر (صفحه‌بندی‌کننده) داخلی استفاده می‌شود. در غیر این صورت، مقاله در یک فایل موقت رندر شده و با پیجر پیکربندی‌شده نمایش می‌یابد. اگر دستور خالی باشد، از مقدار متغیر محیطی PAGER استفاده می‌شود. اگر دستور حاوی جانگهدار %f باشد، با نام فایل موقت جایگزین خواهد شد. (مثال: pager "less %f")

podcast-auto-enqueue (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام نشانی‌های پادکست موجود در مقالات به صف دانلود پادکست اضافه می‌شوند. برای اطلاعات بیشتر به بخش PODCAST SUPPORT در مستندات مراجعه کنید. (مثال: podcast-auto-enqueue yes)

prepopulate-query-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام خوراک‌های پرس‌وجو (query feeds) هنگام شروع برنامه با مقالات پر می‌شوند. (مثال: prepopulate-query-feeds yes)

proxy (پارامترها: <server:port>؛ مقدار پیش‌فرض: n/a)

پروکسی مورد استفاده برای دانلود خوراک‌های RSS را تعیین می‌کند. (فراموش نکنید که پروکسی را با use-proxy yes فعال کنید.) توجه داشته باشید که متغیر محیطی NO_PROXY می‌تواند پروکسی را برای برخی سایت‌ها غیرفعال کند. (مثال: proxy localhost:3128)

proxy-auth (پارامترها: <auth>؛ مقدار پیش‌فرض: n/a)

رشته احراز هویت پروکسی را تعیین می‌کند. (مثال: proxy-auth user:password)

proxy-auth-method (پارامترها: <method>؛ مقدار پیش‌فرض: any)

روش احراز هویت پروکسی را تعیین می‌کند. مقادیر مجاز: any، basic، digest، digest_ie (فقط با libcurl 7.19.3 و جدیدتر)، gssnegotiate، ntlm و anysafe. (مثال: proxy-auth-method ntlm)

proxy-type (پارامترها: <type>؛ مقدار پیش‌فرض: http)

نوع پروکسی را تعیین می‌کند. مقادیر مجاز: http، socks4، socks4a، socks5 و socks5h. (مثال: proxy-type socks5)

refresh-on-startup (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، تمام خوراک‌ها هنگام شروع برنامه بازخوانی می‌شوند. این معادل گزینه خط فرمان -r است. برای بازخوانی مداوم خوراک‌ها به auto-reload مراجعه کنید. (مثال: refresh-on-startup yes)

reload-only-visible-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، بازخوانی دستی تمام خوراک‌ها تنها خوراک‌های قابل‌مشاهده فعلی (مثلاً هنگام اعمال فیلتر یا برچسب) را بازخوانی می‌کند. (مثال: reload-only-visible-feeds yes)

reload-threads (پارامترها: <number>؛ مقدار پیش‌فرض: 1)

تعداد نخ‌های (threads) موازی که هنگام بازخوانی تمام خوراک‌ها آغاز می‌شوند. (مثال: reload-threads 3)

reload-time (پارامترها: <number>؛ مقدار پیش‌فرض: 60)

تعداد دقایق بین بازخوانی‌های خودکار. (مثال: reload-time 120)

reset-unread-on-update (پارامترها: <url> [<url>...]؛ مقدار پیش‌فرض: n/a)

یک یا چند نشانی URL خوراک را مشخص می‌کند که در صورت به‌روزرسانی محتوای مقاله، پرچم خوانده‌نشده بودن آن بازنشانی می‌شود. این ویژگی برای خوراک‌هایی که پس از انتشار به‌روزرسانی می‌شوند مفید است. این گزینه می‌تواند چندین بار مشخص شود. (مثال: reset-unread-on-update "https://blog.fefe.de/rss.xml?html")

restrict-filename (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی no، برنامه Newsboat نام فایل‌های ذخیره‌شده مقالات را به نویسه‌های ASCII محدود نمی‌کند. (مثال: restrict-filename no)

run-on-startup (پارامترها: <list of operations>؛ مقدار پیش‌فرض: n/a)

یک یا چند عملیات Newsboat را که با نقطه ویرگول (;) از هم جدا شده‌اند، مشخص می‌کند تا در هنگام آغاز به کار Newsboat اجرا شوند. (مثال: run-on-startup next-unread; open; random-unread; open)

save-path (پارامترها: <path-to-directory>؛ مقدار پیش‌فرض: ~/)

مسیر پیش‌فرض برای ذخیره مقالات. در صورت تعیین مسیر نامعتبر، از دایرکتوری جاری استفاده می‌شود. (مثال: save-path "~/Saved Articles")

scrolloff (پارامترها: <number>؛ مقدار پیش‌فرض: 0)

تعداد خطوط پیکربندی‌شده بالا و پایین آیتم انتخاب‌شده در فهرست‌ها را حفظ می‌کند. برای نگه‌داشتن آیتم انتخاب‌شده در مرکز صفحه، عدد بالایی تعیین کنید. (مثال: scrolloff 5)

search-highlight-colors (پارامترها: <fgcolor> <bgcolor> [<attribute> ...]؛ مقدار پیش‌فرض: black yellow bold)

رنگ‌های برجسته‌سازی را هنگام جستجوی متن در نمای مقاله مشخص می‌کند. برای رنگ‌ها و صفت‌های موجود به بخش Colors مراجعه کنید. (مثال: search-highlight-colors white black bold)

searchresult-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Search results for '%s' (%u unread, %t total)%?F? matching filter '%F'&?" (بومی‌سازی‌شده))

قالب عنوان در نتایج جستجو. برای جزئیات به بخش FORMAT STRINGS مراجعه کنید. (مثال: searchresult-title-format "Search result")

selectfilter-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Select Filter" (بومی‌سازی‌شده))

قالب عنوان در کادر انتخاب فیلتر. برای جزئیات به بخش FORMAT STRINGS راهنمای Newsboat مراجعه کنید. (مثال: selectfilter-title-format "Select Filter")

selecttag-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%4i %T (%u)")

قالب خطوط در کادر "Select tag". برای اطلاعات بیشتر به بخش FORMAT STRINGS در مستندات مراجعه کنید. (مثال: selecttag-format "[%2i] %T (%n unread articles in %f feeds, %u feeds total)")

selecttag-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - Select Tag" (بومی‌سازی‌شده))

قالب عنوان در کادر انتخاب برچسب. برای جزئیات به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: selecttag-title-format "Select Tag")

show-keymap-hint (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی no، نکات کلیدهای میانبر نمایش داده نخواهند شد. (این نکات معمولاً در پایین صفحه قرار دارند، اما به تنظیم swap-title-and-hints نیز مراجعه کنید.) (مثال: show-keymap-hint no)

show-read-articles (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، تمام مقالات یک خوراک در فهرست مقالات فهرست می‌شوند. اگر روی no تنظیم شود، تنها مقالات خوانده‌نشده فهرست می‌شوند. (مثال: show-read-articles no)

show-read-feeds (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، تمام خوراک‌ها حتی آن‌هایی که فاقد مقاله خوانده‌نشده هستند فهرست می‌شوند. اگر روی no تنظیم شود، تنها خوراک‌های دارای یک یا چند مقاله خوانده‌نشده فهرست می‌شوند. (مثال: show-read-feeds no)

show-title-bar (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی no، نوار عنوان نمایش داده نمی‌شود. (نوار عنوان معمولاً در بالای صفحه است، اما به تنظیم swap-title-and-hints نیز مراجعه کنید.) (مثال: show-title-bar no)

ssl-verifyhost (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی no، از اعتبارسنجی تطابق نام گواهی با هاست صرف‌نظر می‌شود. (مثال: ssl-verifyhost no)

ssl-verifypeer (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی no، از اعتبارسنجی گواهی SSL طرف مقابل صرف‌نظر می‌شود. (مثال: ssl-verifypeer no)

suppress-first-reload (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، در صورت فعال بودن auto-reload، نخستین بازخوانی خودکار هنگام راه‌اندازی برنامه لغو می‌شود. (مثال: suppress-first-reload yes)

swap-title-and-hints (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، جای عنوان (معمولاً در بالای صفحه) و نوار نکات کلیدی (معمولاً در پایین صفحه) جا‌به‌جا می‌شود. این نوارها را می‌توان به طور کامل از طریق تنظیمات show-keymap-hint و show-title-bar پنهان کرد. (مثال: swap-title-and-hints yes)

text-width (پارامترها: <number>؛ مقدار پیش‌فرض: 0)

اگر روی عددی بزرگتر از 0 تنظیم شود، تمام HTML به این حداکثر طول خط یا عرض ترمینال (هرکدام کوچکتر باشد) رندر می‌شود. اگر روی 0 باشد، همیشه از عرض ترمینال در نمای مقاله استفاده می‌شود، در حالی که pipe-to، save و save-all در 80 ستون پیچیده (wrap) خواهند شد. این گزینه هنگام استفاده از رندرکننده خارجی یا مشاهده سورس مقاله اعمال نمی‌شود. همچنین هدر "Link" و بخش "Links" تحت تأثیر قرار نمی‌گیرند، چرا که حاوی آدرس‌های اینترنتی هستند که بهتر است شکسته نشوند. (مثال: text-width 72)

toggleitemread-jumps-to-next (پارامترها: [yes/no]؛ مقدار پیش‌فرض: yes)

در صورت تنظیم روی yes، هنگام تغییر وضعیت خوانده‌شدن یک مقاله در فهرست مقالات، به آیتم بعدی می‌رود. اگر روی no باشد، مکان‌نما روی آیتم جاری باقی می‌ماند. (مثال: toggleitemread-jumps-to-next no)

toggleitemread-jumps-to-next-unread (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، هنگام تغییر وضعیت خوانده‌شدن یک مقاله، به آیتم خوانده‌نشده بعدی پرش می‌کند. اگر روی no باشد، رفتار توسط تنظیم toggleitemread-jumps-to-next تعیین می‌شود. (مثال: toggleitemread-jumps-to-next-unread yes)

ttrss-flag-publish (پارامترها: <character>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Tiny Tiny RSS، مقالاتی که با این پرچم مشخص شوند در Tiny Tiny RSS به عنوان "published" علامت‌گذاری می‌شوند. (مثال: ttrss-flag-publish "b")

ttrss-flag-star (پارامترها: <character>؛ مقدار پیش‌فرض: "")

در صورت تنظیم و استفاده از Tiny Tiny RSS، مقالاتی که با این پرچم مشخص شوند در Tiny Tiny RSS ستاره‌دار می‌شوند. (مثال: ttrss-flag-star "a")

ttrss-login (پارامترها: <username>؛ مقدار پیش‌فرض: "")

نام کاربری مورد استفاده برای Tiny Tiny RSS را تنظیم می‌کند. (مثال: ttrss-login "admin")

ttrss-mode (پارامترها: [multi/single]؛ مقدار پیش‌فرض: multi)

حالت استفاده از Tiny Tiny RSS را پیکربندی می‌کند. در حالت تک‌کاربره (single)، نام کاربری و گذرواژه برای احراز هویت HTTP استفاده می‌شوند، در حالی که در حالت چندکاربره (multi) برای احراز هویت با Tiny Tiny RSS به کار می‌روند. (مثال: ttrss-mode "single")

ttrss-password (پارامترها: <password>؛ مقدار پیش‌فرض: "")

گذرواژه مورد استفاده با Tiny Tiny RSS را پیکربندی می‌کند. نقل‌قول‌های دوتایی و بک‌اسلش‌های درون آن باید escape شوند. (مثال: ttrss-password "here_goesAquote:\"")

ttrss-passwordeval (پارامترها: <command>؛ مقدار پیش‌فرض: "")

یک جایگزین امن‌تر برای مورد بالا، ارائه گذرواژه از یک دستور خارجی است که هنگام ورود ارزیابی می‌شود. این گزینه می‌تواند برای خواندن گذرواژه از یک فایل رمزنگاری‌شده با gpg یا دسته کلید سیستم استفاده شود. (مثال: ttrss-passwordeval "gpg --decrypt ~/.newsboat/ttrss-password.gpg")

ttrss-passwordfile (پارامترها: <path>؛ مقدار پیش‌فرض: "")

جایگزین دیگر، با ذخیره گذرواژه متنی ساده در جای دیگری از سیستم شما است. (مثال: ttrss-passwordfile "~/.newsboat/ttrss-pw.txt")

ttrss-url (پارامترها: <url>؛ مقدار پیش‌فرض: "")

نشانی URL محل نصب Tiny Tiny RSS را پیکربندی می‌کند. (مثال: ttrss-url "https://example.com/ttrss")

unbind-key (پارامترها: <key> [<dialog>]؛ مقدار پیش‌فرض: n/a)

کلید <key> را لغو پیوند (unbind) می‌کند. این بدان معناست که هنگام فشردن <key> هیچ عملیاتی فراخوانی نمی‌شود. این دستور از نحو کلیدهای ویژه تعیین‌شده در بخش کلید (Key) از کلیدهای میانبر سبک قدیمی استفاده می‌کند. اگر "-a" به عنوان <key> ارائه شود، تمام کلیدهای مقید لغو می‌شوند. به صورت اختیاری می‌توان یک پنجره را تعیین کرد تا کلید فقط در آن پنجره لغو پیوند شود. (مثال: unbind-key R)

urls-source (پارامترها: <source>؛ مقدار پیش‌فرض: "local")

این دستور پیکربندی، منبع واکشی آدرس‌های URL را مشخص می‌کند. به طور پیش‌فرض، فایل urls است. به عنوان جایگزین می‌توانید آن را روی opml (حالت اشتراک آنلاین OPML)، ttrss (پشتیبانی Tiny Tiny RSS)، oldreader (پشتیبانی The Old Reader)، newsblur (پشتیبانی NewsBlur)، feedbin برای Feedbin، feedhq برای FeedHQ، freshrss برای FreshRSS، ocnews برای ownCloud News، inoreader برای Inoreader، یا miniflux برای Miniflux تنظیم کنید. مشخصات خوراک‌های پرس‌وجو صرف‌نظر از این تنظیم همیشه از فایل محلی urls خوانده خواهند شد. (مثال: urls-source "oldreader")

urlview-title-format (پارامترها: <format>؛ مقدار پیش‌فرض: "%N %V - URLs" (بومی‌سازی‌شده))

قالب عنوان در نمای پیوندها. برای جزئیات در مورد قالب‌های در دسترس به بخش FORMAT STRINGS در راهنمای Newsboat مراجعه کنید. (مثال: urlview-title-format "URLs")

use-proxy (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، از پروکسی پیکربندی‌شده برای دانلود خوراک‌های RSS استفاده خواهد شد. (مثال: use-proxy yes)

user-agent (پارامترها: <string>؛ مقدار پیش‌فرض: "")

در صورت تنظیم روی یک رشته غیرخالی، این مقدار به عنوان هدر HTTP User-Agent برای تمام درخواست‌های HTTP استفاده خواهد شد. (مثال: user-agent "Lynx/2.8.5rel.1 libwww-FM/2.14")

wrap-scroll (پارامترها: [yes/no]؛ مقدار پیش‌فرض: no)

در صورت تنظیم روی yes، حرکت به پایین در آخرین آیتم یک فهرست به بالای فهرست بازمی‌گردد و برعکس. (مثال: wrap-scroll yes)

open (کلید پیش‌فرض: ENTER)

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

quit (کلید پیش‌فرض: Q)

خروج از برنامه یا بازگشت به پنجره قبلی (بسته به بافت).

hard-quit (کلید پیش‌فرض: Shift + Q)

خروج از برنامه بدون درخواست تأیید.

reload (کلید پیش‌فرض: R)

بازخوانی خوراک انتخاب‌شده فعلی.

reload-all (کلید پیش‌فرض: Shift + R)

بازخوانی تمام خوراک‌ها.

mark-feed-read (کلید پیش‌فرض: Shift + A)

علامت‌گذاری تمام مقالات موجود در خوراک جاری به عنوان خوانده‌شده.

mark-all-feeds-read (کلید پیش‌فرض: Shift + C)

علامت‌گذاری مقالات در تمام خوراک‌ها به عنوان خوانده‌شده.

mark-all-above-as-read (کلید پیش‌فرض: n/a)

علامت‌گذاری تمام موارد بالاتر به عنوان خوانده‌شده.

save (کلید پیش‌فرض: S)

برون‌بری مقاله انتخاب‌شده فعلی به یک فایل متنی ساده، همراه با شکستن خطوط بر اساس تنظیم text-width.

save-all (کلید پیش‌فرض: n/a)

برون‌بری تمام مقالات از خوراک انتخاب‌شده فعلی به فایل‌های متنی ساده، همراه با شکستن خطوط بر اساس تنظیم text-width.

next-unread (کلید پیش‌فرض: N)

پرش به مقاله خوانده‌نشده بعدی.

prev-unread (کلید پیش‌فرض: P)

پرش به مقاله خوانده‌نشده قبلی.

next (کلید پیش‌فرض: Shift + J)

پرش به مدخل بعدی فهرست.

prev (کلید پیش‌فرض: Shift + K)

پرش به مدخل قبلی فهرست.

random-unread (کلید پیش‌فرض: Ctrl + K)

پرش به یک مقاله خوانده‌نشده تصادفی.

open-in-browser (کلید پیش‌فرض: O)

استفاده از مرورگر برای باز کردن نشانی اینترنتی مرتبط با مقاله، خوراک، یا مدخل در نمای پیوندها.

open-in-browser-noninteractively (کلید پیش‌فرض: n/a)

استفاده از مرورگر برای باز کردن نشانی مرتبط با مقاله جاری، خوراک، یا مدخل در نمای URL به صورت غیرتعاملی. این عملیات مشابه open-in-browser کار می‌کند، اما خروجی مرورگر (stdout و stderr) نمایش داده نمی‌شود و مرورگر ورودی صفحه‌کلید را دریافت نمی‌کند. برای انتقال آن به پس‌زمینه می‌توانید یک & در انتهای دستور browser اضافه کنید.

open-in-browser-and-mark-read (کلید پیش‌فرض: Shift + O)

استفاده از مرورگر برای باز کردن نشانی مرتبط با مقاله یا مدخل در نمای URL. هنگام استفاده در فهرست مقالات، مقاله را به عنوان خوانده‌شده نیز علامت‌گذاری می‌کند.

open-all-unread-in-browser (کلید پیش‌فرض: n/a)

باز کردن تمام آدرس‌های اینترنتی خوانده‌نشده در خوراک جاری.

open-all-unread-in-browser-and-mark-read (کلید پیش‌فرض: n/a)

باز کردن تمام نشانی‌های اینترنتی خوانده‌نشده در خوراک جاری و علامت‌گذاری آن‌ها به عنوان خوانده‌شده.

help (کلید پیش‌فرض: ?)

اجرای صفحه راهنما.

toggle-source-view (کلید پیش‌فرض: Ctrl + U)

جابه‌جایی میان نمای HTML و نمای سورس در نمای مقاله.

toggle-article-read (کلید پیش‌فرض: Shift + N)

تغییر وضعیت پرچم خوانده‌شدن برای مقاله انتخاب‌شده فعلی، و پاک کردن پرچم حذف در صورت تنظیم بودن.

toggle-show-read-feeds (کلید پیش‌فرض: L)

تغییر وضعیت نمایش خوراک‌های خوانده‌شده در فهرست خوراک‌ها.

show-urls (کلید پیش‌فرض: U)

نمایش تمام نشانی‌های اینترنتی موجود در مقاله به صورت فهرست (مشابه urlview).

clear-tag (کلید پیش‌فرض: Ctrl + T)

پاک کردن برچسب جاری.

set-tag (کلید پیش‌فرض: T)

انتخاب برچسب.

open-search (کلید پیش‌فرض: /)

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

goto-url (کلید پیش‌فرض: #)

باز کردن کادر گفتگوی URL و سپس باز کردن نشانی مشخص‌شده در مرورگر.

one (کلید پیش‌فرض: 1)

باز کردن نشانی ۱ در مرورگر.

two (کلید پیش‌فرض: 2)

باز کردن نشانی ۲ در مرورگر.

three (کلید پیش‌فرض: 3)

باز کردن نشانی ۳ در مرورگر.

four (کلید پیش‌فرض: 4)

باز کردن نشانی ۴ در مرورگر.

five (کلید پیش‌فرض: 5)

باز کردن نشانی ۵ در مرورگر.

six (کلید پیش‌فرض: 6)

باز کردن نشانی ۶ در مرورگر.

seven (کلید پیش‌فرض: 7)

باز کردن نشانی ۷ در مرورگر.

eight (کلید پیش‌فرض: 8)

باز کردن نشانی ۸ در مرورگر.

nine (کلید پیش‌فرض: 9)

باز کردن نشانی ۹ در مرورگر.

zero (کلید پیش‌فرض: 0)

باز کردن نشانی ۱۰ در مرورگر.

cmd-one (کلید پیش‌فرض: 1)

شروع خط فرمان با ۱.

cmd-two (کلید پیش‌فرض: 2)

شروع خط فرمان با ۲.

cmd-three (کلید پیش‌فرض: 3)

شروع خط فرمان با ۳.

cmd-four (کلید پیش‌فرض: 4)

شروع خط فرمان با ۴.

cmd-five (کلید پیش‌فرض: 5)

شروع خط فرمان با ۵.

cmd-six (کلید پیش‌فرض: 6)

شروع خط فرمان با ۶.

cmd-seven (کلید پیش‌فرض: 7)

شروع خط فرمان با ۷.

cmd-eight (کلید پیش‌فرض: 8)

شروع خط فرمان با ۸.

cmd-nine (کلید پیش‌فرض: 9)

شروع خط فرمان با ۹.

enqueue (کلید پیش‌فرض: E)

افزودن نشانی اینترنتی دانلود پادکست مقاله جاری (در صورت یافت شدن) به صف دانلود پادکست. برای اطلاعات بیشتر به بخش PODCAST SUPPORT مراجعه کنید.

edit-urls (کلید پیش‌فرض: Shift + E)

ویرایش فهرست URLهای اشتراک‌ها. در صورت مشخص شدن یک دستور، Newsboat جانگهدارها را جایگزین کرده و دستور را اجرا می‌کند. این جانگهدارها پشتیبانی می‌شوند: %f (مسیر فایل urls)، %L (شماره سطر خوراک جاری یا خوراک مقاله انتخاب‌شده در فایل urls، یا 0 در صورت قرار داشتن خارج از فایل urls). در صورت عدم تعیین دستور، ویرایشگر تنظیم‌شده در متغیر محیطی VISUAL یا EDITOR (پیش‌فرض: vi) آغاز می‌شود. پس از پایان ویرایش، Newsboat فایل URLs را دوباره بارگیری می‌کند. نمونه پیکربندی: bind E feedlist,articlelist,searchresultslist edit-urls "vim +%L %f"

reload-urls (کلید پیش‌فرض: Ctrl + R)

بارگیری مجدد فایل پیکربندی URLs.

redraw (کلید پیش‌فرض: Ctrl + L)

بازترسیم صفحه نمایش.

cmdline (کلید پیش‌فرض: :)

باز کردن خط فرمان در حالی که رشته اختیاری از پیش پر شده است. نمونه پیکربندی: bind c everywhere cmdline "source ~/.newsboat/config"

set-filter (کلید پیش‌فرض: Shift + F)

تنظیم یک فیلتر.

select-filter (کلید پیش‌فرض: F)

انتخاب یک فیلتر از پیش تعریف‌شده.

clear-filter (کلید پیش‌فرض: Ctrl + F)

پاک کردن فیلتر جاری.

bookmark (کلید پیش‌فرض: Ctrl + B)

نشانک‌گذاری مقاله یا نشانی URL انتخاب‌شده فعلی.

edit-flags (کلید پیش‌فرض: Ctrl + E)

ویرایش پرچم‌های مقاله انتخاب‌شده فعلی.

next-unread-feed (کلید پیش‌فرض: Ctrl + N)

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

prev-unread-feed (کلید پیش‌فرض: Ctrl + P)

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

next-feed (کلید پیش‌فرض: J)

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

prev-feed (کلید پیش‌فرض: K)

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

delete-article (کلید پیش‌فرض: Shift + D)

حذف مقاله انتخاب‌شده فعلی.

delete-all-articles (کلید پیش‌فرض: Ctrl + D)

حذف تمام مقالات در فهرست مقالات. توجه داشته باشید که فهرست مقالات ممکن است شامل زیرمجموعه‌ای از مقالات خوراک باشد (به دلیل فیلترها یا show-read-articles no)، یا ممکن است ترکیبی از مقالات خوراک‌های گوناگون باشد (اگر در حال مشاهده یک خوراک پرس‌وجو هستید) — در هر دو حالت، delete-all-articles تنها همان مقالات را تحت تأثیر قرار می‌دهد، نه تمام مقالات خوراک(های) مربوطه را.

purge-deleted (کلید پیش‌فرض: $)

پاکسازی نهایی تمام مقالاتی که به عنوان حذف‌شده از فهرست مقالات علامت‌گذاری شده‌اند.

view-dialogs (کلید پیش‌فرض: V)

مشاهده فهرست پنجره‌های باز.

close-dialog (کلید پیش‌فرض: Ctrl + X)

بستن پنجره انتخاب‌شده فعلی.

next-dialog (کلید پیش‌فرض: Ctrl + V)

رفتن به پنجره بعدی.

prev-dialog (کلید پیش‌فرض: Ctrl + G)

رفتن به پنجره قبلی.

pipe-to (کلید پیش‌فرض: |)

ارسال مقاله به دستور (pipe). متن بر اساس تنظیم text-width در انتهای سطرها شکسته خواهد شد.

sort (کلید پیش‌فرض: G)

مرتب‌سازی خوراک‌ها/مقالات با انتخاب تعاملی روش مرتب‌سازی.

rev-sort (کلید پیش‌فرض: Shift + G)

مرتب‌سازی معکوس خوراک‌ها/مقالات با انتخاب تعاملی روش مرتب‌سازی.

up (کلید پیش‌فرض: UP)

رفتن به اندازه یک آیتم به بالا در فهرست.

down (کلید پیش‌فرض: DOWN)

رفتن به اندازه یک آیتم به پایین در فهرست.

pageup (کلید پیش‌فرض: PPAGE)

رفتن به اندازه یک صفحه به بالا در فهرست.

pagedown (کلید پیش‌فرض: NPAGE)

رفتن به اندازه یک صفحه به پایین در فهرست.

halfpageup (کلید پیش‌فرض: n/a)

رفتن به اندازه نیم صفحه به بالا.

halfpagedown (کلید پیش‌فرض: n/a)

رفتن به اندازه نیم صفحه به پایین.

home (کلید پیش‌فرض: HOME)

رفتن به نخستین آیتم در فهرست.

end (کلید پیش‌فرض: END)

رفتن به آخرین آیتم در فهرست.

macro-prefix (کلید پیش‌فرض: ,)

آغاز اجرای ماکرو. فشردن کلید بعدی ماکروی اصلی را انتخاب و اجرا می‌کند.

switch-focus (کلید پیش‌فرض: TAB)

جابه‌جایی فوکوس میان ویجت‌ها. این مورد در حال حاضر تنها در بافت‌های filebrowser و dirbrowser کاربرد دارد.

goto-title (کلید پیش‌فرض: n/a)

رفتن به آیتمی که عنوان آن شامل رشته مشخص‌شده باشد (بدون حساسیت به بزرگی و کوچکی حروف).

prevsearchresults (کلید پیش‌فرض: Z)

بازگشت به نتایج جستجوی قبلی (در صورت وجود). این عملیات تنها از پنجره searchresultslist کار می‌کند.

article-feed (کلید پیش‌فرض: n/a)

رفتن به خوراک مربوط به مقاله انتخاب‌شده فعلی.

نیوزبوت شامل یک سیستم قدرتمند رشته قالب‌بندی است که به کاربر امکان می‌دهد قالب بخش‌های گوناگون برنامه را پیکربندی کند، مانند قالب مدخل‌ها در فهرست خوراک‌ها یا در فهرست مقالات.

رشته‌های قالب‌بندی مشابه مواردی هستند که در تابع printf در زبان برنامه‌نویسی C یافت می‌شوند. یک توالی قالب با نویسه % آغاز می‌شود و به دنبال آن نشانه تراز اختیاری می‌آید: اعداد مثبت نشان می‌دهند متنی که برای توالی درج می‌شود از سمت چپ تا رسیدن به عرض کلی مشخص‌شده با عدد فاصله‌گذاری (pad) می‌شود، در حالی که اعداد منفی فاصله‌گذاری در سمت راست را مشخص می‌کنند. پس از نشانه فاصله‌گذاری، شناسه توالی واقعی می‌آید که معمولاً یک حرف تکی است. %=[width][identifier] توالی را در مرکز تراز می‌کند، که اگر w=0 باشد کل عرض پنجره استفاده می‌شود.

علاوه بر این، نیوزبوت توالی‌های دیگری و قدرتمندتری ارائه می‌دهد، مانند %>[char]، که نشان می‌دهد متن سمت راست توالی در سمت راست صفحه تراز خواهد شد، و نویسه‌های میان متن سمت چپ و متن سمت راست با [char] پر می‌شوند. قالب قدرتمند دیگر، توالی شرطی است: %?[char]?[format 1]&[format 2]?: اگر متن شناسه توالی [char] شامل هرگونه نویسه غیرفضای‌خالی باشد، آن‌گاه [format 1] ارزیابی و درج می‌شود، در غیر این صورت [format 2] ارزیابی و درج خواهد شد. بخش‌های & و [format 2] اختیاری هستند، یعنی اگر متن شناسه خالی باشد، یک رشته خالی درج می‌شود.

جدول‌های زیر نشان می‌دهند چه شناسه‌های توالی برای کدام قالب در دسترس هستند:

جدول ۱. شناسه‌های موجود برای feedlist-format

شناسه معنی
d شرح خوراک
i نمایه خوراک
l پیوند خوراک
L نشانی URL خوراک RSS
n فیلد پرچم "خوانده‌نشده"
S وضعیت بارگیری
t عنوان خوراک
T نخستین برچسب خوراک در فایل URLs
u فیلد "خوانده‌نشده/مجموع"
U فیلد "خوانده‌نشده"
c فیلد "مجموع"

هنگامی که عملیات reload-all در حال اجرا است، وضعیت بارگیری وضعیت دانلود یک خوراک را نشان می‌دهد که می‌تواند "در انتظار بارگیری" (با "_" نشان داده می‌شود)، "در حال حاضر در حال بارگیری" (با "." نشان داده می‌شود)، با موفقیت بارگیری‌شده (با " " نشان داده می‌شود) و "خطای بارگیری" (با "x" نشان داده می‌شود) باشد.

جدول ۲. شناسه‌های موجود برای articlelist-format

شناسه معنی
a نویسنده مقاله
D تاریخ انتشار. این مورد می‌تواند با datetime-format بیشتر سفارشی‌سازی شود
f دو نویسه: ۱) "N" اگر مقاله خوانده‌نشده باشد، "D" اگر مقاله حذف شده باشد، در غیر این صورت یک فاصله؛ ۲) "!" اگر مقاله دارای پرچم باشد، در غیر این صورت یک فاصله.
n فیلد "خوانده‌نشده"
d فیلد "حذف‌شده"
F پرچم‌های مقاله
i نمایه مقاله
t عنوان مقاله
T اگر فهرست مقالات، مقاله‌هایی از خوراک‌های مختلف را نمایش دهد، آن‌گاه این شناسه شامل عنوان خوراکی است که مقاله به آن تعلق دارد.
L طول مقاله
e نشانی URL ضمیمه مقاله

جدول ۳. شناسه‌های موجود برای selecttag-format

شناسه معنی
i نمایه خط در فهرست
T برچسبی که این خط متناظر با آن است
f تعداد خوراک‌های خوانده‌نشده زیر این برچسب
n تعداد مقالات خوانده‌نشده در خوراک‌های برچسب‌گذاری‌شده با این برچسب
u تعداد خوراک‌های برچسب‌گذاری‌شده با این برچسب

جدول ۴. شناسه‌های موجود برای notify-format

شناسه معنی
n تعداد مقالات خوانده‌نشده
f تعداد خوراک‌های خوانده‌نشده
d تعداد مقالات خوانده‌نشده جدید (یعنی آن‌هایی که در آخرین بازنشانی اضافه شده‌اند)
D تعداد خوراک‌های خوانده‌نشده جدید (یعنی آن‌هایی که در آخرین بازنشانی اضافه شده‌اند)

جدول ۵. شناسه‌های موجود برای podlist-format

شناسه معنی
i نمایه بارگیری
d اندازه بارگیری‌شده فعلی به مگابایت، با یک رقم دقت اعشار نمایش داده می‌شود
t اندازه کل بارگیری به مگابایت، با یک رقم دقت اعشار نمایش داده می‌شود
p درصد بارگیری‌شده، با یک رقم دقت اعشار نمایش داده می‌شود
k سرعت بارگیری، با دو رقم دقت اعشار، همیشه به صورت KB/s (شامل متن "KB/s" نمی‌شود)
K سرعت بارگیری، با دو رقم دقت اعشار، خوانا برای انسان (به صورت خودکار بین KB/s، MB/s و GB/s تغییر می‌کند)
S وضعیت بارگیری، یکی از موارد زیر را نمایش می‌دهد: "queued"، "downloading"، "ready"، "canceled"، "deleted"، "missing"، "played"، "finished" یا "failed"
u نشانی URL بارگیری
F نام فایل مطلق بارگیری از دایرکتوری ریشه (مانند ‎~/downloads/podcast.mp3 → /home/name/downloads/podcast.mp3)
b نام پایه (basename) بارگیری (مانند ‎/home/name/downloads/podcast.mp3 → podcast.mp3)

جدول ۶. شناسه‌های موجود برای download-path و download-filename-format

شناسه معنی
u بخش نام فایل از نشانی URL بارگیری. ممکن است خالی باشد. ممکن است شامل یک رشته پرس‌وجو https://en.wikipedia.org/wiki/Query_string باشد.
n نام خوراک پادکست
N نام خوراک پادکست. حتی اگر از طریق یک خوراک پرس‌وجو انتخاب شده باشد، شامل نام خوراک اصلی است
h نام هاست (hostname) خوراک پادکست
t عنوان قسمت پادکست
e پسوند قسمت پادکست
F تاریخ انتشار قسمت پادکست قالب‌بندی‌شده به صورت yyyy-mm-dd
m ماهی که قسمت پادکست در آن منتشر شد
b نام اختصاری ماهی که قسمت پادکست در آن منتشر شد
d روزی که قسمت پادکست در آن منتشر شد
H ساعتی که قسمت پادکست در آن منتشر شد
M دقیقه‌ای که قسمت پادکست در آن منتشر شد
S ثانیه‌ای که قسمت پادکست در آن منتشر شد
y سال انتشار قسمت پادکست قالب‌بندی‌شده به صورت yy
Y سال انتشار قسمت پادکست قالب‌بندی‌شده به صورت yyyy

مثال‌ها:

feedlist-format     "%4i %n %11u %t"
articlelist-format  "%4i %f %D   %?T?|%-17T|  ?%t"
notify-format       "%d new articles (%n unread articles, %f unread feeds)"
podlist-format      "%4i [%-5p %%] %-12S %F"

شما می‌توانید قالب عنوان تمام کادرهای محاوره (دیالوگ‌های) موجود را سفارشی‌سازی کنید. در اینجا فهرستی از کادرهای محاوره به همراه متغیرهای پیکربندی قالب عنوان مربوط به آن‌ها، و فهرستی از قالب‌های موجود و معانی آن‌ها آورده شده است. لطفاً توجه داشته باشید که قالب‌های عنوان بومی‌سازی شده‌اند، بنابراین اگر با زبان یا محلی‌سازی (locale) دیگری کار می‌کنید که توسط نیوزبوت پشتیبانی می‌شود، متن عنوان نمایش‌داده‌شده ممکن است تفاوت داشته باشد مگر اینکه آن را سفارشی کنید.

جدول ۷. قالب‌های عنوان کادرهای محاوره

کادر محاوره متغیر پیکربندی مقدار پیش‌فرض
فهرست خوراک‌ها feedlist-title-format %N %V - %?F?Feeds&Your feeds? (%u unread, %t total)%?F? matching filter '%F'&?%?T? - tag '%T'&?

فهرست مقالات articlelist-title-format %N %V - Articles in feed '%T' (%u unread, %t total)%?F? matching filter '%F'&? - %U

نتیجه جستجو searchresult-title-format %N %V - Search results for '%s' (%u unread, %t total)%?F? matching filter '%F'&?

مرورگر فایل filebrowser-title-format %N %V - %?O?Open File&Save File? - %f

مرورگر دایرکتوری dirbrowser-title-format %N %V - %?O?Open Directory&Save File? - %f

راهنما help-title-format %N %V - Help

کادر انتخاب برچسب selecttag-title-format %N %V - Select Tag

کادر انتخاب فیلتر selectfilter-title-format %N %V - Select Filter

نمای مقاله itemview-title-format %N %V - Article '%T' (%u unread, %t total)

نمای پیوندها urlview-title-format %N %V - URLs

فهرست کادرهای محاوره dialogs-title-format %N %V - Dialogs

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

شناسه معنی
N نام برنامه، یعنی "Newsboat"
V نسخه برنامه

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

شناسه معنی
T برچسب انتخاب‌شده فعلی (اگر هیچ برچسبی انتخاب نشده باشد خالی است)
t تعداد کل خوراک‌ها
u تعداد خوراک‌های خوانده‌نشده
U تعداد مقالات خوانده‌نشده
F عبارت فیلتر فعلی (اگر فیلتری فعال نباشد خالی است)

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

شناسه معنی
T عنوان خوراک
U نشانی URL خوراک
u تعداد مقالات خوانده‌نشده
t تعداد کل مقالات
F عبارت فیلتر فعلی (اگر فیلتری فعال نباشد خالی است)

جدول ۱۱. شناسه‌های قالب عنوان نتیجه جستجو

شناسه معنی
s عبارت جستجو
به‌علاوه تمام مواردی که توسط articlelist-title-format پشتیبانی می‌شوند (جدول بالا را ببینید)

جدول ۱۲. شناسه‌های قالب عنوان مرورگر فایل

شناسه معنی
f مسیر فعلی
O غیرخالی در صورتی که مرورگر فایل در حالت باز کردن باشد، خالی در صورت قرار داشتن در حالت ذخیره

جدول ۱۳. شناسه‌های قالب عنوان مرورگر دایرکتوری

شناسه معنی
f مسیر فعلی
O غیرخالی در صورتی که مرورگر دایرکتوری در حالت باز کردن باشد، خالی در صورت قرار داشتن در حالت ذخیره

جدول ۱۴. شناسه‌های قالب عنوان نمای مقاله

شناسه معنی
T عنوان مقاله
F عنوان خوراک
u تعداد مقالات خوانده‌نشده
t تعداد کل مقالات

نیوزبوت امکان دسته‌بندی یا به اصطلاح "برچسب‌گذاری" خوراک‌های RSS را فراهم می‌کند. به هر خوراک RSS می‌توان ۰ یا چند برچسب اختصاص داد. در نیوزبوت، می‌توانید انتخاب کنید که فقط خوراک‌های RSS منطبق با یک برچسب خاص نمایش داده شوند. این امر دسته‌بندی خوراک‌های شما را به روشی انعطاف‌پذیر و قدرتمند آسان می‌سازد.

معمولاً فایل urls شامل یک نشانی URL خوراک RSS در هر خط است. برای اختصاص دادن یک برچسب به یک خوراک RSS، به سادگی آن را به صورت یک کلمه منفرد، با فاصله‌گذاری مانند فاصله (space) یا تب (tab) اضافه کنید. اگر برچسب نیاز به فاصله داشته باشد، باید از نقل‌قول (") در اطراف برچسب استفاده کنید (مثال زیر را ببینید). یک فایل نمونه urls ممکن است شبیه به این باشد:

https://blog.fefe.de/rss.xml?html interesting conspiracy news "cool stuff"
https://rss.orf.at/news.xml news orf
https://www.heise.de/newsticker/heise.rdf news interesting

وقتی اکنون نیوزبوت را با این پیکربندی آغاز می‌کنید، می‌توانید با فشردن T یک برچسب را انتخاب کنید. هنگامی که برچسب "news" را انتخاب می‌کنید، هر سه خوراک RSS را خواهید دید. با فشردن مجدد T و مثلاً انتخاب برچسب "conspiracy"، فقط خوراک RSS مربوط به https://blog.fefe.de/rss.xml?html را خواهید دید. فشردن Ctrl + T برچسب فعلی را پاک می‌کند و دوباره تمام خوراک‌های RSS را بدون در نظر گرفتن برچسب‌های اختصاص‌یافته آن‌ها نمایش می‌دهد.

نوع خاصی از برچسب‌ها، برچسب‌هایی هستند که با نویسه تیلده (~) آغاز می‌شوند. وقتی چنین برچسبی یافت شود، عنوان خوراک برابر با نام برچسب (به جز نویسه ~) تنظیم می‌شود. این نوع برچسب‌ها هنگامی که هر نوع ویژگی "نخستین برچسب" (first tag) استفاده شود، نادیده گرفته می‌شوند. با این ویژگی می‌توانید در فهرست خوراک‌های خود هر عنوانی که می‌خواهید به خوراک‌ها اختصاص دهید:

https://rss.orf.at/news.xml "~ORF News"

نوع خاص دیگری از برچسب‌ها، برچسب‌هایی هستند که با علامت تعجب (!) آغاز می‌شوند. هنگامی که چنین برچسبی پیدا شود، خوراک از فهرست معمولی خوراک‌ها پنهان می‌شود و محتوای آن تنها از طریق یک خوراک پرس‌وجو قابل دسترسی است.

https://rss.orf.at/news.xml ! news
http://feeds.bbci.co.uk/news/world/rss.xml ! news
"query:News from around the globe:tags # \"news\""

در این مثال، دو خوراک اول در فهرست خوراک‌ها ظاهر نخواهند شد، اما مقالات آن‌ها همچنان از طریق خوراک پرس‌وجو با عنوان "News from around the globe" در دسترس خواهند بود. برچسب‌های "پنهان" در این مثال حتی نامی ندارند، زیرا تنها کاربرد آن‌ها پنهان کردن خوراکی است که برچسب‌گذاری می‌کنند.

نیوزبوت از افزونه‌های Snownews پشتیبانی می‌کند. نرم‌افزارهای خواننده خوراک RSS مانند Snownews و Liferea یک روش مشترک برای گسترش قابلیت‌ها با اسکریپت‌های سفارشی دارند. دو سازوکار، یعنی اسکریپت‌های نوع "execurl" و "filter"، در دسترس هستند و توسط نیوزبوت پشتیبانی می‌شوند.

یک اسکریپت "execurl" می‌تواند هر برنامه‌ای باشد که اجرا شده و خروجی آن به عنوان یک خوراک RSS تفسیر می‌شود، در حالی که اسکریپت‌های "filter" با محتوای یک نشانی URL پیکربندی‌شده تغذیه می‌شوند و خروجی آن‌ها به عنوان خوراک RSS تفسیر می‌گردد.

پیکربندی ساده و سرراست است. کافی است خطوط پیکربندی مانند موارد زیر را به فایل urls خود اضافه کنید:

exec:~/bin/execurl-script
filter:~/bin/filter-script:https://some.test/url

خط اول نحوه افزودن یک اسکریپت execurl را به پیکربندی نشان می‌دهد: خط را با exec: آغاز کنید و سپس بلافاصله مسیر اسکریپتی را که باید اجرا شود ضمیمه نمایید. اگر این اسکریپت به پارامترهای اضافی نیاز دارد، به سادگی از نقل‌قول استفاده کنید (برای جزئیات به بخش استفاده از نقل‌قول دوتایی مراجعه نمایید):

"exec:~/bin/execurl-script param1 param2"

خط دوم نحوه افزودن یک اسکریپت فیلتر را به پیکربندی شما نشان می‌دهد: خط را با filter: آغاز کنید، سپس بلافاصله مسیر اسکریپت را بیاورید، سپس یک دونقطه (:) بگذارید، و سپس نشانی URL فایلی را که باید به اسکریپت داده شود اضافه کنید. مجدداً، اگر اسکریپت به هرگونه پارامتر نیاز دارد، کل عبارت را داخل نقل‌قول قرار دهید:

"filter:~/bin/filter-script param1 param2:https://url/foobar"

در هر دو حالت، ویژگی برچسب‌گذاری که در بالا شرح داده شد همچنان در دسترس است:

exec:~/bin/execurl-script tag1 tag2 "quoted tag"
filter:~/bin/filter-script:https://some.test/url tag3 tag4 tag5

اگر نیاز به نوشتن افزونه خود دارید، به این راهنمای کوتاه https://web.archive.org/web/20090724045314/http://kiza.kcore.de/software/snownews/snowscripts/writing برای آشنایی مراجعه کنید. مجموعه‌ای از اسکریپت‌ها https://sourceforge.net/p/snownews/code/ci/de3bd8b28191c4d4bc1be18275786613bcbc0c94/tree/docs/untested و فیلترهای https://sourceforge.net/p/snownews/code/ci/9fb45e4cdf1cf9dea55b9af66c13a4c238809851/tree/docs/filters موجود نیز ممکن است مفید باشند.

نیوزبوت به همراه یک اسکریپت نمونه exec ارائه می‌شود که روشی را برای ایجاد یک کانال RSS نشان می‌دهد. این اسکریپت همچنین شامل روشی برای مشاهده آرگومان‌های دقیقی است که توسط نیوزبوت به اسکریپت ارسال می‌شوند. این نمونه را می‌توان در زیردایرکتوری doc/examples پیدا کرد.

گاهی اوقات کاربر با محتوای خاصی مواجه می‌شود که نمی‌خواهد آن را بخواند، برای مثال موضوعاتی که کاربر به آن‌ها علاقه‌ای ندارد یا مقالاتی که توسط افراد خاصی نوشته شده‌اند. در یوزنت (Usenet)، این ویژگی در نرم‌افزارها به طور سنتی "killfile" (پرونده مسدودسازی) نامیده می‌شود؛ بدین معنی که بر اساس محتوای این فایل، مقالاتی که با شرایط خاصی مطابقت دارند نمایش داده نمی‌شوند و به هیچ وجه به کاربر ارائه نمی‌گردند.

در نیوزبوت، چنین قابلیتی می‌تواند بر مبنای هر مقاله از طریق فایل پیکربندی پیاده‌سازی شود. مهم‌ترین دستور پیکربندی برای این کار ignore-article است:

ignore-article "https://synflood.at/blog/index.php?/feeds/index.rss2" "title =~ \"newsboat\""
ignore-article "regex:https?://nitter.net/.*" "title =~ \"^RT by\""
ignore-article "*" "title =~ \"Gentoo\""

این دستور دو پارامتر می‌پذیرد. اولین پارامتر یکی از موارد زیر است:

•نشانی URL یک خوراک.
•یک الگو با پیشوند regex:. این الگو باید یک عبارت باقاعده تعمیم‌یافته POSIX https://pubs.opengroup.org/onlinepubs/9699919799.2008edition/basedefs/V1_chap09.html باشد که بدون حساسیت به حروف کوچک و بزرگ تطبیق داده خواهد شد.
•"*" برای تطبیق با هر خوراکی (ستاره یک الگو، glob یا عبارت باقاعده نیست—ما صرفاً آن را برای معنی "تمام خوراک‌ها" اختصاص داده‌ایم).

آرگومان دوم یک عبارت فیلتر برای یک مقاله است، احتمالاً در نقل‌قول دوگانه برای حفظ فاصله‌های درون آن. اگر نیوزبوت در خوراک RSS مشخص‌شده با مقاله‌ای برخورد کند که با عبارت فیلتر مشخص‌شده مطابقت دارد، آن‌گاه این مقاله نادیده گرفته شده و هرگز به کاربر نشان داده نمی‌شود. خود پیکربندی می‌تواند شامل هر تعداد دستور ignore-article که مایل باشید باشد.

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

•هنگام بارگیری: مقالات هنگامی که یک خوراک بارگیری و تجزیه می‌شود نادیده گرفته می‌شوند، و بنابراین در حافظه نهان (کَش) محلی نوشته نخواهند شد.
•هنگام نمایش: مقالات بارگیری شده و در حافظه نهان محلی نوشته می‌شوند، اما هنگامی که خوراک نمایش داده می‌شود نادیده گرفته می‌شوند.

هر دو حالت مزایا و معایب خود را دارند: در حالی که حالت نادیده‌گیری هنگام بارگیری مقداری در فضای ذخیره‌سازی صرفه‌جویی می‌کند، شما نمی‌توانید صرفاً با حذف آن از فایل پیکربندی این نادیده‌گیری را لغو (undo) کنید؛ زیرا اگر مقاله نادیده‌گرفته‌شده قبلاً از یک خوراک پاک شده باشد، دیگر مجدداً ظاهر نخواهد شد. از طرف دیگر، حالت نادیده‌گیری هنگام نمایش به فضای بیشتری نیاز دارد، اما این مزیت را دارد که می‌توان با حذف دستور ignore-article از پیکربندی، نادیده‌گیری را لغو کرد.

حالت پیش‌فرض نادیده‌گیری "download" است. شما می‌توانید ignore-mode را در فایل پیکربندی تنظیم کنید:

ignore-mode "display"

پادکست یک فایل چندرسانه‌ای است که با استفاده از خوراک‌های اشتراک محتوا مانند RSS در اینترنت توزیع می‌شود تا بعداً در پخش‌کننده‌های قابل حمل یا رایانه‌ها پخش شود. نیوزبوت از بارگیری، ذخیره و پخش زنده (استریم) پادکست‌ها پشتیبانی می‌کند، هرچند برای پخش به یک پخش‌کننده رسانه خارجی نیاز است. نحوه این پشتیبانی با سایر جمع‌آوری‌کننده‌های پادکست یا "پادکچرها" کمی متفاوت است.

محتوای پادکست در خوراک‌های RSS از طریق تگ‌های ویژه‌ای به نام "enclosures" (ضمایم) انتقال می‌یابد. نیوزبوت این ضمایم را شناسایی کرده و اطلاعات مربوطه را برای هر مورد پادکست که در یک خوراک RSS پیدا کند، ذخیره می‌نماید. از نسخه ۲.۰ به بعد، نیوزبوت همچنین پسوندهای یاهو مدیا RSS را نیز شناسایی و مدیریت می‌کند.

واسط‌های برنامه‌نویسی کاربردی راه دور (Remote APIs) همیشه این "ضمایم" را فهرست نمی‌کنند، بنابراین ممکن است پادکست‌ها در نیوزبوت وجود نداشته باشند. چنین APIهایی در بخش مربوطه از اسناد ما مشخص شده‌اند. اگر توضیحی در این مورد نبود اما همچنان ضمایم را در نیوزبوت مشاهده نمی‌کنید، لطفاً یک گزارش مشکل (issue) ثبت کنید تا موضوع را بررسی کنیم!

مانند سایر نرم‌افزارهای مبتنی بر متن، نیوزبوت شامل یک خط فرمان داخلی برای تغییر متغیرهای پیکربندی به صورت موردی (ad hoc) و اجرای دستورات اختصاصی است. این خط فرمان دسترسی انعطاف‌پذیری به عملکردهای نیوزبوت فراهم می‌سازد که به ویژه برای کاربران پیشرفته مفید است.

برای شروع خط فرمان، کلید : را فشار دهید. اعلان ":" را در پایین صفحه مشاهده خواهید کرد، مشابه ابزارهایی مانند vi(m) یا mutt. اکنون می‌توانید دستورات را وارد کنید. با فشردن کلید Enter دستور اجرا شده (احتمالاً با ارائه بازخورد به کاربر) و خط فرمان بسته می‌شود. با فشردن کلید Esc می‌توانید وارد کردن دستورات را لغو کنید. تاریخچه تمام دستوراتی که وارد می‌کنید در فایل history.cmdline ذخیره خواهد شد که در کنار فایل cache.db قرار دارد. به صورت پیش‌فرض تاریخچه به ۱۰۰ مدخل محدود شده است، اما با تنظیم متغیر پیکربندی history-limit قابل تغییر است. برای غیرفعال کردن ذخیره تاریخچه، history-limit را روی 0 تنظیم کنید.

اگر نام کامل دستورات خط فرمان را به خاطر نمی‌آورید، خط فرمان راهنمایی‌هایی برای شما فراهم می‌کند. با فشردن کلید Tab، نیوزبوت تلاش می‌کند دستور شما را به صورت خودکار کامل کند. اگر بیش از یک تکمیل ممکن وجود داشته باشد، می‌توانید متعاقباً کلید Tab را فشار دهید تا میان تمام نتایج جابه‌جا شوید. اگر هیچ تطابقی پیدا نشود، هیچ پیشنهادی در خط فرمان درج نخواهد شد. برای دستور set، تکمیل خودکار برای نام متغیرهای پیکربندی نیز کار می‌کند.

علاوه بر این، برخی از کلیدهای ترکیبی متداول مانند Ctrl + G (برای لغو ورودی)، Ctrl + K (برای حذف متن از موقعیت مکان‌نما تا انتهای خط)، Ctrl + U (برای پاک کردن کل خط) و Ctrl + W (برای حذف کلمه قبل از موقعیت فعلی مکان‌نما) افزوده شده‌اند.

لطفاً توجه داشته باشید که تاریخچه ورودی هم برای خط فرمان و هم برای عملکردهای جستجو در سیستم فایل در فایل‌های history.cmdline و history.search (در کنار فایل cache.db) ذخیره می‌شوند. به طور پیش‌فرض، ۱۰۰ مدخل آخر ذخیره می‌شوند، اما این مقدار قابل پیکربندی است (متغیر پیکربندی history-limit) و همچنین می‌تواند کاملاً غیرفعال شود (با تنظیم متغیر مذکور روی 0).

در حال حاضر، دستورات خط فرمان زیر در دسترس هستند:

quit

خروج از نیوزبوت.

q

نام مستعار برای quit.

save <filename>

ذخیره مقاله فعلی در <filename>.


set <variable>[=<value>|&|!]

تنظیم (یا دریافت) مقدار متغیر پیکربندی. تعیین علامت ! پس از نام یک متغیر پیکربندی بولی، مقدار آن را تغییر وضعیت می‌دهد (toggle)، و علامت & مستقیماً پس از نام یک متغیر پیکربندی از هر نوع، مقدار آن را به مقدار پیش‌فرض مستندشده بازنشانی می‌کند.

tag <tagname>

انتخاب یک برچسب خاص.

goto <case-insensitive substring>

رفتن به خوراک بعدی که نام آن شامل زیررشته بدون حساسیت به حروف کوچک و بزرگ است.

source <filename> [...]

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

dumpconfig <filename>

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

<number>

پرش به مدخل شماره <number> در کادر محاوره فعلی.

به‌طور پیش‌فرض، نیوزبوت تمام فایل‌ها را به روش سنتی یونیکس ذخیره می‌کند، یعنی در یک "dotdir" (پوشه نقطه‌دار) واقع در ~/.newsboat. با این حال، از یک روش نوین نیز پشتیبانی می‌کند، مشخصات دایرکتوری پایه XDG https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html، که فایل‌ها را بین مکان‌های زیر تقسیم می‌کند:

1.$XDG_CONFIG_HOME/newsboat/ (مقدار پیش‌فرض XDG_CONFIG_HOME برابر ~/.config است)
2.$XDG_DATA_HOME/newsboat/ (مقدار پیش‌فرض XDG_DATA_HOME برابر ~/.local/share است)

اگر دایرکتوری newsboat در زیر XDG_CONFIG_HOME وجود داشته باشد، آن‌گاه نیوزبوت از دایرکتوری‌های XDG استفاده خواهد کرد (و در صورت لزوم دایرکتوری داده را ایجاد می‌کند). در غیر این صورت، نیوزبوت به صورت پیش‌فرض از ~/.newsboat استفاده می‌نماید.

اگر در حال حاضر از ~/.newsboat/ استفاده می‌کنید اما مایل به مهاجرت به دایرکتوری‌های XDG هستید، باید فایل‌ها را به صورت زیر انتقال دهید:

config، urls

به $XDG_CONFIG_HOME/newsboat/

cache.db، history.search، history.cmdline، queue

به $XDG_DATA_HOME/newsboat/

نیوزبوت و پادبوت همچنین "فایل‌های قفل" (lock files) ایجاد می‌کنند. این فایل‌ها از اجرای همزمان دو نمونه از یک برنامه و در نتیجه از خراب شدن داده‌های شما جلوگیری می‌کنند. نیوزبوت و پادبوت هنگام خروج از برنامه این فایل‌ها را حذف می‌کنند، بنابراین نیازی به کپی کردن آن‌ها در جایی نیست — فقط در صورتی که اسکریپت‌هایی می‌نویسید که با cache.db یا queue کار می‌کنند از آن‌ها آگاه باشید. به طور پیش‌فرض، فایل‌های قفل در مکان‌های زیر قرار دارند:

پوشه نقطه‌دار (dotdir) دایرکتوری XDG
Newsboat ~/.newsboat/cache.db.lock $XDG_DATA_HOME/newsboat/cache.db.lock
Podboat ~/.newsboat/pb-lock.pid $XDG_DATA_HOME/newsboat/.lock

نیوزبوت فایل قفل را در کنار فایل حافظه نهان (کَش) قرار می‌دهد، بنابراین اگر تنظیم cache-file را مشخص کنید یا آرگومان خط فرمان —cache-file را ارسال نمایید، مسیر فایل قفل نیز تغییر خواهد کرد. قفل پادبوت می‌تواند با استفاده از آرگومان خط فرمان —lock-file در مکان دیگری قرار داده شود.

فایل‌های نقطه‌دار (dotfiles)

~/.newsboat/config

~/.newsboat/urls

دایرکتوری‌های XDG

$XDG_CONFIG_HOME/newsboat/config

$XDG_CONFIG_HOME/newsboat/urls

نکته: اگر متغیر محیطی XDG_CONFIG_HOME تنظیم نشده باشد، نیوزبوت به گونه‌ای عمل می‌کند که گویی روی ~/.config تنظیم شده است.

BROWSER

به نیوزبوت اعلام می‌کند در صورت عدم وجود تنظیم browser در فایل پیکربندی، از چه مرورگری استفاده کند. اگر این متغیر وجود نداشته باشد، مقدار پیش‌فرض lynx(1) استفاده خواهد شد.

CURL_CA_BUNDLE

به نیوزبوت اعلام می‌کند از فایل گواهی مشخص‌شده برای اعتبارسنجی همتا (peer) استفاده کند. این فایل ممکن است شامل چندین گواهی باشد. گواهی(ها) باید با فرمت PEM باشند.

این گزینه در صورتی مفید است که libcurl شما بدون اطلاعات گواهی مفید کامپایل شده باشد و خودتان نتوانید کتابخانه را مجدداً کامپایل کنید.

EDITOR

به نیوزبوت اعلام می‌کند در صورت ویرایش فایل urls از طریق عملیات edit-urls و در حالتی که متغیر محیطی VISUAL تنظیم نشده است، از چه ویرایشگر جایگزینی استفاده کند. اگر این متغیر نیز وجود نداشته باشد، مقدار پیش‌فرض vi(1) استفاده خواهد شد.

NO_PROXY

به نیوزبوت اعلام می‌کند تنظیم proxy را برای برخی سایت‌ها نادیده بگیرد.

این متغیر شامل فهرستی از نام‌های هاست، نام‌های دامنه و نشانی‌های IP است که با کاما از یکدیگر جدا شده‌اند.

نام‌های دامنه با زیردامنه‌ها مطابقت دارند، یعنی "example.com" با "foo.example.com" نیز مطابقت دارد. نام‌های دامنه‌ای که با یک نقطه شروع می‌شوند فقط با زیردامنه‌ها تطبیق داده می‌شوند، به عنوان مثال ".example.com" با "bar.example.com" مطابقت دارد اما با خود "example.com" مطابقت ندارد.

نشانی‌های IPv6 بدون براکت نوشته می‌شوند و به صورت رشته تطبیق داده می‌شوند. بنابراین "::1" با "::0:1" تطبیق ندارد، حتی اگر این‌ها همان نشانی باشند.

PAGER

به نیوزبوت اعلام می‌کند در صورتی که تنظیم pager در فایل پیکربندی صراحتاً روی یک رشته خالی تنظیم شده باشد، از چه صفحه‌بندی (pager) استفاده کند.

TMPDIR

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

VISUAL

به نیوزبوت اعلام می‌کند هنگام ویرایش فایل urls از طریق عملیات edit-urls از چه ویرایشگری استفاده کند. اگر این متغیر وجود نداشته باشد، متغیر محیطی EDITOR استفاده خواهد شد.

XDG_CONFIG_HOME

به نیوزبوت اعلام می‌کند از کدام دایرکتوری پایه برای فایل‌های پیکربندی استفاده کند. برای اطلاعات بیشتر همچنین به بخش فایل‌ها مراجعه کنید.

XDG_DATA_HOME

به نیوزبوت اعلام می‌کند از کدام دایرکتوری پایه برای فایل‌های داده استفاده کند. برای اطلاعات بیشتر همچنین به بخش فایل‌ها مراجعه کنید.

podboat(1)

Alexander Batischev

2026-06-21