Newsraftのソースを表示

[[Category:ニュースアグリゲータ]]
[[Category:コンソールアプリケーション]]
[https://codeberg.org/grisha/newsraft Newsraft] は {{pkg|ncurses}} フィードリーダーであり、[[Newsboat]] に触発されつつ、その軽量な代替品を目指しています。RSS 2.0 以下、Atom 1.0、RSS Content Module、Media RSS、DublinCore 1.1 Elements、および JSON Feed をサポートしています。

== インストール ==

{{AUR|newsraft}} パッケージを[[インストール]]します。

== 設定 ==

Newsraft の設定はオプションであり、デフォルトの設定を変更するか機能を追加するだけです。これは {{ic|~/.config/newsraft/config}} にエントリを追加することで実現されます。これにはリーダーとカラーの設定、内蔵されたアクションのためのキーバインディング（{{ic|bind ''key action''}}）およびシェルコマンド（{{ic|bind ''key'' exec ''command''}}）が含まれ、指定したプログラムでリンクを開くオプションもあります。セミコロンで区切ることで、一つのバインディングに複数のコマンドを関連付けることができます：

{{hc|~/.config/newsraft/config|
bind f exec feh "%l"
bind ''key action1''; exec ''command1''; ''action2''; exec ''command2''
}}

デフォルトのキーバインディングは、不要な場合や別の目的で再利用するために {{ic|unbind ''key''}} で無効にすることができます。最後に、フィードファイルと同様に、# 記号はコメント行を指定し、newsraft によって無視されます。

=== 例の設定 ===

{{hc|~/.config/newsraft/config|
# Colors
set color-list-item-fg red
set color-list-item-unread-fg white

# Settings
set send-user-agent-header false

# Key bindings
bind d mark-read
unbind D
bind m exec mpv "%l"
}}

利用可能なアクション、設定、およびデフォルトの全リストは、{{man|1|newsraft|url=https://txgk.ru/newsraft.html}} で参照できます。

== Usage ==

Newsraft needs a feeds file created before it can be launched. The default feed file location and name is {{ic|~/.config/newsraft/feeds}}. Once this is populated with links to feeds, start newsraft with the command:

 $ newsraft

=== Managing feeds ===

The feeds file can contain three types of lines. The first is the feed URL, which can be added with a text editor one feed per line:

{{hc|~/.config/newsraft/feeds|
<nowiki>https://example.org/feed.xml "Lorem Ipsum Blog"</nowiki>
}}

Only the URL is strictly necessary. Newsraft will attempt to name the feed based on information provided by the feed. If an alternate name is desired, this can be supplied by adding the title in enclosed double quotes separated from the URL by at least one white space.

Section headers are the next type of line, which start with the @ symbol, at least one white space, and then the section name:

{{hc|~/.config/newsraft/feeds|
@ Section Header
}}

The final type of entry in the feeds file are comments, which start with the # symbol:

{{hc|~/.config/newsraft/feeds|
# this line is completely ignored by newsraft
}}

Both feed URLs and section headers can set auto update frequency, with individual feed frequencies overriding sectional frequencies. The period is specified by a number minutes enclosed by curly brackets:

{{hc|~/.config/newsraft/feeds|<nowiki>
@ Section Header {120}
https://example.org/feed2.xml "Lorem Ipsum Blog" {60}
https://example.org/feed3.xml
https://example.org/feed4.xml {0}
</nowiki>}}

Specifying {{ic|{0}<nowiki/>}} will disable automatic updates and global feed updates can be specified by using the {{ic|Global}} section header. In the above example, all feeds under {{ic|Section Header}} are automatically updated every two hours, except feed2, which is updated every hour, and feed4, which is never automatically updated.

=== Basic default commands ===

While all of these key bindings can be modified via newsraft's [[#Configuration|config file]], here are the basic default key bindings and their commands:

{| class="wikitable"
! Command
! Description
|-
| {{ic|j - ''select-next''}}
| move selection down to next menu item
|-
| {{ic|k - ''select-prev''}}
| move selection up to previous menu item
|-
| {{ic|l - ''enter''}}
| open selected menu item
|-
| {{ic|h - ''quit''}}
| close selected menu item, return to previous menu.  If currently in top menu, quit newsraft
|-
| {{ic|d - ''mark-read; jump-to-next''}}
| mark selection read and move to next menu item
|-
| {{ic|D - ''mark-unread; jump-to-next''}}
| mark selection unread and move to next menu item
|-
| {{ic|^D - ''mark-read-all''}}
| mark all menu items read
|-
| {{ic|o - ''open-in-browser''}}
| open selection in browser.  If no number precedes 'o', opens first selection
|-
| {{ic|r - ''reload''}}
| manually update selected feed
|-
| {{ic|^R - ''reload-all''}}
| manually update all feeds
|}