Newsraftのソースを表示

[[Category:ニュースアグリゲータ]]
[[Category:コンソールアプリケーション]]
[[en:Newsraft]]
[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}} で参照できます。

== 使用方法 ==

Newsraft を起動する前に、フィードファイルを作成する必要があります。デフォルトのフィードファイルの場所と名前は {{ic|~/.config/newsraft/feeds}} です。このファイルにフィードへのリンクを記入したら、以下のコマンドで Newsraft を起動します：

 $ newsraft

=== フィードの管理 ===

フィードファイルには3種類の行を含めることができます。最初はフィードの URL で、テキストエディタで1行に1つのフィードを追加できます:

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

URL のみが厳密に必要です。Newsraft はフィードから提供された情報に基づいてフィードの名前を設定しようとします。別の名前が望ましい場合、URL と少なくとも1つの空白で区切った後に二重引用符で囲んでタイトルを追加できます。

次に、セクションヘッダーと呼ばれる行があります。これは @ 記号で始まり、少なくとも1つの空白とセクション名が続きます:

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

最後の種類のエントリはコメントであり、# 記号で始まります:

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

フィードの URL とセクションヘッダーは、個々のフィードの頻度がセクションの頻度を上書きする形で、自動更新の頻度を設定できます。期間は中括弧で囲んだ分数で指定されます:

{{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>}}

{{ic|{0}<nowiki/>}} を指定すると自動更新が無効になり、全体のフィード更新は {{ic|Global}} セクションヘッダーを使用して指定できます。上記の例では、{{ic|Section Header}} の下のすべてのフィードは2時間ごとに自動的に更新されますが、feed2 は1時間ごと、feed4 は自動更新されません。

=== 基本的なデフォルトのコマンド ===

これらのキーバインディングはすべて、Newsraft の [[#Configuration|設定ファイル]] 経由で変更できますが、基本的なデフォルトのキーバインディングとそのコマンドは以下のとおりです:

{| class="wikitable"
! コマンド
! 説明
|-
| {{ic|j - ''select-next''}}
| 選択を次のメニュー項目まで移動します
|-
| {{ic|k - ''select-prev''}}
| 選択内容を前のメニュー項目まで移動する
|-
| {{ic|l - ''enter''}}
| 選択したメニュー項目を開く
|-
| {{ic|h - ''quit''}}
| 選択したメニュー項目を閉じて、前のメニューに戻ります。現在トップメニューにある場合は、newsraft を終了します
|-
| {{ic|d - ''mark-read; jump-to-next''}}
| 選択内容を既読としてマークし、次のメニュー項目に移動します
|-
| {{ic|D - ''mark-unread; jump-to-next''}}
| 選択内容を未読としてマークし、次のメニュー項目に移動します
|-
| {{ic|^D - ''mark-read-all''}}
| すべてのメニュー項目に既読のマークを付ける
|-
| {{ic|o - ''open-in-browser''}}
| ブラウザで選択範囲を開きます。'o' の前に数字がない場合は、最初の選択範囲が開きます
|-
| {{ic|r - ''reload''}}
| 選択したフィードを手動で更新する
|-
| {{ic|^R - ''reload-all''}}
| すべてのフィードを手動で更新する
|}