「Newsboat」の版間の差分
(→ヒントとテクニック: フィードを並行ロードして更新を高速化するを翻訳して追加) |
(→設定: 情報を更新) |
||
71行目: | 71行目: | ||
== 設定 == |
== 設定 == |
||
− | + | Newsboat は、デフォルトで {{ic|~/.newsboat/config}} または {{ic|~/.config/newsboat/config}} にある設定ファイルを介して設定できます。この設定ファイルは以下のような形式で記述されます: |
|
<config-command> <arg1> ... |
<config-command> <arg1> ... |
||
+ | |||
+ | === カラースキーム === |
||
+ | |||
+ | パッケージには、{{ic|/usr/share/doc/newsboat/contrib/colorschemes/}} に多数のスキームが同梱されており、次のように include コマンドでロードできます。 |
||
+ | |||
+ | include /usr/share/doc/newsboat/contrib/colorschemes/inkpot |
||
+ | |||
+ | === 追加オプション === |
||
設定ファイルにはコメントも付けられます。コメントの先頭には {{ic|#}} 記号をつけて、以下行末までコメントになります。空白が含まれた設定引数を入力する必要があるときは、クォート {{ic|"}} を使って引数全体を括って下さい。外部コマンドの出力を設定に組み入れることも可能です。バッククォート {{ic|`}} で囲まれたテキストはシェルコマンドとして評価され、その場所にはコマンドの出力が入ります。Bourne 互換シェルのバッククォートと同じように使うことができ、外部の情報を設定の中で使えるようになっています。 |
設定ファイルにはコメントも付けられます。コメントの先頭には {{ic|#}} 記号をつけて、以下行末までコメントになります。空白が含まれた設定引数を入力する必要があるときは、クォート {{ic|"}} を使って引数全体を括って下さい。外部コマンドの出力を設定に組み入れることも可能です。バッククォート {{ic|`}} で囲まれたテキストはシェルコマンドとして評価され、その場所にはコマンドの出力が入ります。Bourne 互換シェルのバッククォートと同じように使うことができ、外部の情報を設定の中で使えるようになっています。 |
||
79行目: | 87行目: | ||
設定例は [https://gist.github.com/anonymous/42d2f5956e7bc8ee1ebc] と [http://moparx.com/configs/newsbeuter/] を見て下さい。 |
設定例は [https://gist.github.com/anonymous/42d2f5956e7bc8ee1ebc] と [http://moparx.com/configs/newsbeuter/] を見て下さい。 |
||
− | {{Note|設定コマンドの完全なリストは、man |
+ | {{Note|設定コマンドの完全なリストは、{{man|1|newsboat|CONFIGURATION COMMANDS}} を見て下さい。}} |
== ヒントとテクニック == |
== ヒントとテクニック == |
2023年11月24日 (金) 03:00時点における版
プロジェクトのウェブページ より:
- Newsbeuter はテキストターミナル用のオープンソースの RSS/Atom フィードリーダーです。Linux, FreeBSD, macOS などの Unix ライクなオペレーティングシステムで動作します。Newsbeuter は設定が自由自在で優れた機能を多数備えていることから、全てキーボードで動作できる高速かつスマートなフィードリーダーを望んている人にうってつけです。
Newsbeuter の開発は中止され、フォークされて newsboat が生まれました [1]。
目次
インストール
newsboat は公式リポジトリからインストールできます。開発版は newsbeuter-gitAUR または newsboat-gitAUR パッケージでインストールできます。
使用方法
Newsboatは、設定済みのフィードなしでは起動できません。 フィードは、~/.config/newsboat/urls
で構成できます。
インストールしたら、コマンドラインから newsboat を起動することができます:
newsboat
ナビゲーションはとてもわかりやすいものになっています。キーバインディングの完全なリストは man ページを見るか、newsbeuter の中から ?
キーを押して下さい。
フィードの管理
フィードの追加・削除・タグ管理は全て urls ファイルの編集で行います。デフォルトでは ~/.config/newsboat/urls
に存在します。
フィードの追加・削除
URL を追加するには、~/.config/newsboat/urls
をお好きなテキストエディタで開いて、一行ごとに URL を追加します:
http://rss.cnn.com/rss/cnn_topstories.rss http://newsrss.bbc.co.uk/rss/newsonline_world_edition/front_page/rss.xml
ユーザー名/パスワードを入力しないとアクセスできない URL を追加するときは、以下のようにしてユーザー名/パスワードを指定します:
http://username:password@hostname.domain.tld/feed.rss
ユーザー名とパスワードが流出しないように、~/.config/newsboat/urls
には適切なパーミッションを設定してください。
また、Newsbeuter は URL に含まれているユーザー名とパスワードをユーザーインターフェイスに表示しません。ユーザー名に @ が含まれる場合、ユーザー名・パスワードとホスト名を区切る @ と区別が付くように %40 を使ってください。
ローカルのファイルをフィードとして設定することもでき、その場合はローカルパスの前に file://
を付けて ~/.newsbeuter/urls
ファイルに追加します:
file:///var/log/rss_eventlog.xml
フィードを削除したいときは、urls ファイルからそのフィードの行を消して下さい。
フィードのタグ管理
全てのフィードにはタグを割り当てることができます。タグ付けすることでフィードのカテゴライズが簡単になるだけでなく、一度に複数のフィードを対象としてコマンドを適用することができるようになります。
通常、~/.newsbeuter/urls
ファイルには一行ごとに一つの RSS フィードの URL を記述します。RSS フィードにタグを付けるには、スペースやタブなどの空白で区切って、単語を後ろに付け加えて下さい。タグの中に空白を入れたいときは、タグをクォート (") で括って下さい (下の例を参照)。例:
http://blog.fefe.de/rss.xml?html interesting conspiracy news "cool stuff" http://rss.orf.at/news.xml news orf http://www.heise.de/newsticker/heise.rdf news interesting
上記のように設定したら、newsbeuter を起動してから t
を押すことでタグを選択できます。"news" タグを選択した場合、3つの RSS フィード全てが表示されます。もう一度、t
を押して "conspiracy" タグを選択すると、http://blog.fefe.de/rss.xml?html
の RSS フィードしか表示されなくなります。Ctrl-T
を押すとタグの選択が解除され、全ての RSS フィードが表示されるように戻ります。
特殊なタグ
フィードのカスタム名称
urls ファイルで特殊なタグを使うことでフィードの名前を定義することができます。タグの名前の前に ~
記号を付けると、タグの名前がフィードの名前になります。例:
http://rss.cnn.com/rss/cnn_topstories.rss "~CNN Top stories"
上記の設定で "CNN Top stories" がフィードの名前として定義されます。
非表示フィード
タグの名前の前に !
を付けることで、そのフィードを通常のフィードのリストから非表示にすることができます。例:
http://rss.orf.at/news.xml "!ORF News (hidden)"
非表示フィードのコンテンツは query しないかぎり表示されません。
設定
Newsboat は、デフォルトで ~/.newsboat/config
または ~/.config/newsboat/config
にある設定ファイルを介して設定できます。この設定ファイルは以下のような形式で記述されます:
<config-command> <arg1> ...
カラースキーム
パッケージには、/usr/share/doc/newsboat/contrib/colorschemes/
に多数のスキームが同梱されており、次のように include コマンドでロードできます。
include /usr/share/doc/newsboat/contrib/colorschemes/inkpot
追加オプション
設定ファイルにはコメントも付けられます。コメントの先頭には #
記号をつけて、以下行末までコメントになります。空白が含まれた設定引数を入力する必要があるときは、クォート "
を使って引数全体を括って下さい。外部コマンドの出力を設定に組み入れることも可能です。バッククォート `
で囲まれたテキストはシェルコマンドとして評価され、その場所にはコマンドの出力が入ります。Bourne 互換シェルのバッククォートと同じように使うことができ、外部の情報を設定の中で使えるようになっています。
ヒントとテクニック
フィードの自動リロード
cron や systemd を使うことで自動的にフィードをリロードすることができます。crontab に行を追加するか、systemd のサービス/タイマーのコンボを作って以下のコマンドを実行してください:
/usr/bin/newsbeuter -x reload
もしくは、以下の設定をすることで Newsbeuter の起動時にフィードを全て自動的にリロードするように設定することもできます:
auto-reload yes
上記の設定をすると、Newsbeuter は定期的に自動リロードを行います。デフォルトでは60分に設定されています。自動リロードの間隔は以下のように設定できます:
reload-time <desired number of minutes>
フィードを並行ロードして更新を高速化する
デフォルトでは、Newsboat は ~/.newsboat/urls
内のエントリを順番に更新しようとします。ただし、次の設定では、一度に n 個ずつ並行して更新されます。nはお好みに合わせて調整してください。
reload-threads 100
記事の URL を外部のコマンドに渡す
外部のコマンドに記事の URL を渡すハックです。newsbeuter で記事を開くときのブラウザを設定する macro を使って他のコマンドのパスを利用して、その後、元の macro に戻します。
例えば、youtube のチャンネルを購読して mpv で動画を開きたい場合、以下のように設定します:
macro y set browser "mpv %u" ; open-in-browser ; set browser "elinks %u"
副題
ユーザーが副題を追加してフィードをより効率的に並べ替えることができる、もう 1 つの小さなハックがあります。このハッキングには、次のように偽のフィードを urls
ファイルに追加することが含まれます。
---Heading---
次に、~/.config/newsboat/config
に次の 2 行を追加します:
highlight feedlist "---.*---" COLOR_OF_YOUR_CHOOSING default bold highlight feedlist ".*0/0.." default default invis
COLOR_OF_YOUR_CHOOSING
を newsboat がサポートする色 に置き換えます。
このトリックは、---Heading---
を次のように置き換えることでタグと対話することもできます:
"query:---Heading---:tags # \"Tag\""
次に、見出しの下にあるすべてのフィードに Tag
をタグ付けします。
トラブルシューティング
Newsbeuter が起動しない
何もフィードを設定していないと Newsbeuter は起動しません。以下のようなエラーが表示される場合:
Error: no URLs configured. Please fill the file /home/ak/.newsbeuter/urls with RSS feed URLs or import an OPML file.
#フィードの管理 を見て URL を追加してください。
上記が問題ではない場合、おそらく newsbeuter の別のインスタンスが実行中です。Newsbeuter はデータベースにロックをかけるため一度にデータベースにアクセスできるインスタンスは一つのみとなっています。そのため、インスタンスを2つ開こうとしてもできません。