「Newsraft」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(一部飜訳)
 
(2人の利用者による、間の3版が非表示)
1行目: 1行目:
 
[[Category:ニュースアグリゲータ]]
  
[[Category:ニュースアグリゲータ]]
 
[[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 をサポートしています。
  
[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 をサポートしています。
   
36行目: 37行目:
 
利用可能なアクション、設定、およびデフォルトの全リストは、{{man|1|newsraft|url=https://txgk.ru/newsraft.html}} で参照できます。
  
利用可能なアクション、設定、およびデフォルトの全リストは、{{man|1|newsraft|url=https://txgk.ru/newsraft.html}} で参照できます。
   
−
== Usage ==
 +
== 使用方法 ==
   
  +
Newsraft を起動する前に、フィードファイルを作成する必要があります。デフォルトのフィードファイルの場所と名前は {{ic|~/.config/newsraft/feeds}} です。このファイルにフィードへのリンクを記入したら、以下のコマンドで Newsraft を起動します：
−
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
  
$ newsraft
   
−
=== Managing feeds ===
 +
=== フィードの管理 ===
   
  +
フィードファイルには3種類の行を含めることができます。最初はフィードの URL で、テキストエディタで1行に1つのフィードを追加できます:
−
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|
  
{{hc|~/.config/newsraft/feeds|
50行目: 51行目:
 
}}
  
}}
   
  +
URL のみが厳密に必要です。Newsraft はフィードから提供された情報に基づいてフィードの名前を設定しようとします。別の名前が望ましい場合、URL と少なくとも1つの空白で区切った後に二重引用符で囲んでタイトルを追加できます。
−
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.
  
   
  +
次に、セクションヘッダーと呼ばれる行があります。これは @ 記号で始まり、少なくとも1つの空白とセクション名が続きます:
−
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|
  
{{hc|~/.config/newsraft/feeds|
58行目: 59行目:
 
}}
  
}}
   
  +
最後の種類のエントリはコメントであり、# 記号で始まります:
−
The final type of entry in the feeds file are comments, which start with the # symbol:
  
   
 
{{hc|~/.config/newsraft/feeds|
  
{{hc|~/.config/newsraft/feeds|
64行目: 65行目:
 
}}
  
}}
   
  +
フィードの URL とセクションヘッダーは、個々のフィードの頻度がセクションの頻度を上書きする形で、自動更新の頻度を設定できます。期間は中括弧で囲んだ分数で指定されます:
−
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>
  
{{hc|~/.config/newsraft/feeds|<nowiki>
73行目: 74行目:
 
</nowiki>}}
  
</nowiki>}}
   
  +
{{ic|{0}<nowiki/>}} を指定すると自動更新が無効になり、全体のフィード更新は {{ic|Global}} セクションヘッダーを使用して指定できます。上記の例では、{{ic|Section Header}} の下のすべてのフィードは2時間ごとに自動的に更新されますが、feed2 は1時間ごと、feed4 は自動更新されません。
−
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 ===
  
   
  +
これらのキーバインディングはすべて、Newsraft の [[#Configuration|設定ファイル]] 経由で変更できますが、基本的なデフォルトのキーバインディングとそのコマンドは以下のとおりです:
−
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"
  
{| class="wikitable"
  +
! コマンド
−
! Command
  
  +
! 説明
−
! Description
  
 
|-
  
|-
 
| {{ic|j - ''select-next''}}
  
| {{ic|j - ''select-next''}}
  +
| 選択を次のメニュー項目まで移動します
−
| move selection down to next menu item
  
 
|-
  
|-
 
| {{ic|k - ''select-prev''}}
  
| {{ic|k - ''select-prev''}}
  +
| 選択内容を前のメニュー項目まで移動する
−
| move selection up to previous menu item
  
 
|-
  
|-
 
| {{ic|l - ''enter''}}
  
| {{ic|l - ''enter''}}
  +
| 選択したメニュー項目を開く
−
| open selected menu item
  
 
|-
  
|-
 
| {{ic|h - ''quit''}}
  
| {{ic|h - ''quit''}}
  +
| 選択したメニュー項目を閉じて、前のメニューに戻ります。現在トップメニューにある場合は、newsraft を終了します
−
| close selected menu item, return to previous menu. If currently in top menu, quit newsraft
  
 
|-
  
|-
 
| {{ic|d - ''mark-read; jump-to-next''}}
  
| {{ic|d - ''mark-read; jump-to-next''}}
  +
| 選択内容を既読としてマークし、次のメニュー項目に移動します
−
| mark selection read and move to next menu item
  
 
|-
  
|-
 
| {{ic|D - ''mark-unread; jump-to-next''}}
  
| {{ic|D - ''mark-unread; jump-to-next''}}
  +
| 選択内容を未読としてマークし、次のメニュー項目に移動します
−
| mark selection unread and move to next menu item
  
 
|-
  
|-
 
| {{ic|^D - ''mark-read-all''}}
  
| {{ic|^D - ''mark-read-all''}}
  +
| すべてのメニュー項目に既読のマークを付ける
−
| mark all menu items read
  
 
|-
  
|-
 
| {{ic|o - ''open-in-browser''}}
  
| {{ic|o - ''open-in-browser''}}
  +
| ブラウザで選択範囲を開きます。'o' の前に数字がない場合は、最初の選択範囲が開きます
−
| open selection in browser. If no number precedes 'o', opens first selection
  
 
|-
  
|-
 
| {{ic|r - ''reload''}}
  
| {{ic|r - ''reload''}}
  +
| 選択したフィードを手動で更新する
−
| manually update selected feed
  
 
|-
  
|-
 
| {{ic|^R - ''reload-all''}}
  
| {{ic|^R - ''reload-all''}}
  +
| すべてのフィードを手動で更新する
−
| manually update all feeds
  
 
|}
  
|}

2023年10月27日 (金) 15:42時点における最新版

Newsraft は ncurses フィードリーダーであり、Newsboat に触発されつつ、その軽量な代替品を目指しています。RSS 2.0 以下、Atom 1.0、RSS Content Module、Media RSS、DublinCore 1.1 Elements、および JSON Feed をサポートしています。

インストール

newsraftAUR パッケージをインストールします。

設定

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

~/.config/newsraft/config
bind f exec feh "%l"
bind key action1; exec command1; action2; exec command2

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

例の設定

~/.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"

利用可能なアクション、設定、およびデフォルトの全リストは、newsraft(1) で参照できます。

使用方法

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

$ newsraft

フィードの管理

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

~/.config/newsraft/feeds
https://example.org/feed.xml "Lorem Ipsum Blog"

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

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

~/.config/newsraft/feeds
@ Section Header

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

~/.config/newsraft/feeds
# this line is completely ignored by newsraft

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

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

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

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

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

コマンド 説明
j - select-next 選択を次のメニュー項目まで移動します
k - select-prev 選択内容を前のメニュー項目まで移動する
l - enter 選択したメニュー項目を開く
h - quit 選択したメニュー項目を閉じて、前のメニューに戻ります。現在トップメニューにある場合は、newsraft を終了します
d - mark-read; jump-to-next 選択内容を既読としてマークし、次のメニュー項目に移動します
D - mark-unread; jump-to-next 選択内容を未読としてマークし、次のメニュー項目に移動します
^D - mark-read-all すべてのメニュー項目に既読のマークを付ける
o - open-in-browser ブラウザで選択範囲を開きます。'o' の前に数字がない場合は、最初の選択範囲が開きます
r - reload 選択したフィードを手動で更新する
^R - reload-all すべてのフィードを手動で更新する
「https://wiki.archlinux.jp/index.php?title=Newsraft&oldid=34540」から取得