Newsboatのソースを表示

[[Category:ニュースアグリゲータ]]
[[en:Newsboat]]
[http://newsbeuter.org/ プロジェクトのウェブページ] より:
:Newsbeuter はテキストターミナル用のオープンソースの RSS/Atom フィードリーダーです。Linux, FreeBSD, macOS などの Unix ライクなオペレーティングシステムで動作します。Newsbeuter は設定が自由自在で優れた機能を多数備えていることから、全てキーボードで動作できる高速かつスマートなフィードリーダーを望んている人にうってつけです。

Newsbeuter の開発は中止され、フォークされて {{Pkg|newsboat}} が生まれました [https://groups.google.com/forum/#!topic/newsbeuter/RPtlWX8CPGU]。

== インストール ==
{{Pkg|newsboat}} は公式リポジトリからインストールできます。開発版は {{AUR|newsbeuter-git}} または {{AUR|newsboat-git}} パッケージでインストールできます。

== 使用方法 ==
インストールしたら、コマンドラインから newsbeuter を起動することができます:

 newsbeuter

ナビゲーションはとてもわかりやすいものになっています。キーバインディングの完全なリストは man ページを見るか、newsbeuter の中から {{ic|?}} キーを押して下さい。

{{Warning|フィードを設定しないと newsbeuter を起動することはできません。フィードの追加方法は次のセクションである [[#フィードの管理]] を見て下さい。}}
{{Note|キーバインディングの設定は変えられます。[[#設定]] を見たり、man ページに載っているバインド出来る機能のリストを見て下さい。}}

== フィードの管理 ==
フィードの追加・削除・タグ管理は全て urls ファイルの編集で行います。デフォルトでは {{ic|~/.newsbeuter/urls}} に存在します。

=== フィードの追加・削除 ===
URL を追加するには、{{ic|~/.newsbeuter/urls}} をお好きなテキストエディタで開いて、一行ごとに URL を追加します:

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

ユーザー名/パスワードを入力しないとアクセスできない URL を追加するときは、以下のようにしてユーザー名/パスワードを指定します:

 <nowiki>http://username:password@hostname.domain.tld/feed.rss</nowiki>

ユーザー名とパスワードが流出しないように、{{ic|~/.newsbeuter/urls}} には適切なパーミッションを設定してください。

また、Newsbeuter は URL に含まれているユーザー名とパスワードをユーザーインターフェイスに表示しません。ユーザー名に @ が含まれる場合、ユーザー名・パスワードとホスト名を区切る @ と区別が付くように %40 を使ってください。

ローカルのファイルをフィードとして設定することもでき、その場合はローカルパスの前に {{ic|file://}} を付けて {{ic|~/.newsbeuter/urls}} ファイルに追加します:

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

フィードを削除したいときは、urls ファイルからそのフィードの行を消して下さい。

=== フィードのタグ管理 ===
全てのフィードにはタグを割り当てることができます。タグ付けすることでフィードのカテゴライズが簡単になるだけでなく、一度に複数のフィードを対象としてコマンドを適用することができるようになります。

通常、{{ic|~/.newsbeuter/urls}} ファイルには一行ごとに一つの RSS フィードの URL を記述します。RSS フィードにタグを付けるには、スペースやタブなどの空白で区切って、単語を後ろに付け加えて下さい。タグの中に空白を入れたいときは、タグをクォート (") で括って下さい (下の例を参照)。例:

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

上記のように設定したら、newsbeuter を起動してから {{ic|t}} を押すことでタグを選択できます。"news" タグを選択した場合、3つの RSS フィード全てが表示されます。もう一度、{{ic|t}} を押して "conspiracy" タグを選択すると、{{ic|<nowiki>http://blog.fefe.de/rss.xml?html</nowiki>}} の RSS フィードしか表示されなくなります。{{ic|Ctrl-T}} を押すとタグの選択が解除され、全ての RSS フィードが表示されるように戻ります。

==== 特殊なタグ ====
===== フィードのカスタム名称 =====
urls ファイルで特殊なタグを使うことでフィードの名前を定義することができます。タグの名前の前に {{ic|~}} 記号を付けると、タグの名前がフィードの名前になります。例:

 <nowiki>http://rss.cnn.com/rss/cnn_topstories.rss</nowiki> "~CNN Top stories"

上記の設定で "CNN Top stories" がフィードの名前として定義されます。

===== 非表示フィード =====
タグの名前の前に {{ic|!}} を付けることで、そのフィードを通常のフィードのリストから非表示にすることができます。例:

 <nowiki>http://rss.orf.at/news.xml</nowiki> "!ORF News (hidden)"

非表示フィードのコンテンツは query しないかぎり表示されません。

== 設定 ==

設定ファイルで設定できる newsbeuter の挙動も存在します。設定ファイルはデフォルトで {{ic|~/.newsbeuter/config}} にあります。この設定ファイルは以下のような形式で記述されます:

 <config-command> <arg1> ...

設定ファイルにはコメントも付けられます。コメントの先頭には {{ic|#}} 記号をつけて、以下行末までコメントになります。空白が含まれた設定引数を入力する必要があるときは、クォート {{ic|"}} を使って引数全体を括って下さい。外部コマンドの出力を設定に組み入れることも可能です。バッククォート {{ic|`}} で囲まれたテキストはシェルコマンドとして評価され、その場所にはコマンドの出力が入ります。Bourne 互換シェルのバッククォートと同じように使うことができ、外部の情報を設定の中で使えるようになっています。

設定例は [https://gist.github.com/anonymous/42d2f5956e7bc8ee1ebc] と [http://moparx.com/configs/newsbeuter/] を見て下さい。

{{Note|設定コマンドの完全なリストは、man ページを見て下さい。}}

== ヒント ==
=== フィードの自動リロード ===
[[cron]] や [[systemd]] を使うことで自動的にフィードをリロードすることができます。crontab に行を追加するか、systemd のサービス/タイマーのコンボを作って以下のコマンドを実行してください:

 /usr/bin/newsbeuter -x reload

もしくは、以下の設定をすることで Newsbeuter の起動時にフィードを全て自動的にリロードするように設定することもできます:

 auto-reload yes

上記の設定をすると、Newsbeuter は定期的に自動リロードを行います。デフォルトでは60分に設定されています。自動リロードの間隔は以下のように設定できます:

 reload-time <desired number of minutes>

=== 記事の URL を外部のコマンドに渡す ===
外部のコマンドに記事の URL を渡すハックです。newsbeuter で記事を開くときのブラウザを設定する macro を使って他のコマンドのパスを利用して、その後、元の macro に戻します。

例えば、youtube のチャンネルを購読して [[mpv]] で動画を開きたい場合、以下のように設定します:

 macro y set browser "mpv %u" ; open-in-browser ; set browser "elinks %u"

{{Note|マクロを使うときは、まず {{ic|,}} キーを押してからキーバインドを押して下さい。上の例の場合、{{ic|,}} + {{ic|y}} と入力します。}}

== トラブルシューティング ==

=== 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つ開こうとしてもできません。

== 参照 ==
*[http://newsbeuter.org/ 公式ウェブサイト]
*[http://www.newsbeuter.org/doc/newsbeuter.html ドキュメント]
*[http://blog.sanctum.geek.nz/rss-with-newsbeuter/ Arabesque: Rss with Newsbeuter]