ぴるごむ改 0.2.1 - Windows Updater
===================================

「ぴるごむ改」は、利用者が指定した最大10個のRSS 2.0 / AtomフィードをPCで取得し、
各フィード最大5件、合計最大50件をPalm OS端末へ持ち出して読むための
オフラインリーダーです。
URL欄には動作例としてGIGAZINEのRSSを初期表示します。ニュース本文や取得済みPDBは
収録せず、URLは利用者が自由に変更できます。

0.2.1では、写真と見開き本アイコンを1bit、4階調、16階調、カラーの各画面向けに
収録します。モノクロ端末では利用可能な最良の階調を選び、カラー端末ではカラーを
維持します。0.2.1 PRCは旧0.2.0 UpdaterのPDBも読めますが、4/16階調写真を使うには
このパッケージの0.2.1 PRCとUpdaterを組み合わせてください。

本作は、小山虎氏作「VisorにWebがぴるごむ?!」が切り開いた、Webの情報を
Palmへ持ち出す楽しさに最大限の敬意を込めた令和の非公式リスペクト作品です。
原作者・関係者による公認、提携、後継版ではありません。原作のコードや素材は
使用していません。

必要環境
--------

- 64-bit Windows 10または11
- Palm Desktop / HotSync Managerが動作していること
- Palm OS 3.1以降の端末
- インターネット接続

Pythonは不要です。EXEには必要な実行環境が含まれています。

初回設定
--------

1. ZIPをフォルダーへすべて展開してください。
2. PilGomKai_0.2.1_JP.prcをPalm Desktopへ登録してHotSyncします。
3. PilGomKaiUpdater.exeを起動します。
4. 初期表示のGIGAZINE RSSを試すか、利用条件を確認済みのRSSまたはAtom
   フィードURLを最大10個まで登録します。番号順がPalmでの表示順です。
5. 更新するPalm Desktopユーザーを1つ以上選択します。
6. 「自動更新を有効にする」を押します。
7. 更新と転送待ち登録の完了後、通常どおりHotSyncしてください。

UpdaterはWindowsログオン時と4時間ごとに、次を実行します。

- 指定された最大10個のRSS 2.0 / Atomフィードを取得
- 登録順のまま、各フィード最大5件、合計最大50件を収録
- フィード内の見出し、日時、媒体名、description/content/summaryのみを保存
- リンク先の記事ページは取得しない
- Wikimedia CommonsのFeatured Pictureを1枚取得
- Palm用PDB（最大512 KiB）を全件検証してから置換
- 選択した全ユーザーの次回HotSyncキューへ登録

定期タスクはHotSync自体を開始しません。Palmを接続し、従来どおり
HotSyncボタンを押してください。

設定と保存先
------------

設定、最新PDB、写真クレジット、ログ、定期実行用EXE:

  %LOCALAPPDATA%\DoroDango\PilGomKai

タスク名:

  DoroDango - PilGom Kai Update

いずれかのフィードの取得や解析に失敗した場合は、直前のPDBを維持します。
update.logは512KiBを
超えるとupdate.log.1へローテーションします。

キューを変更しない取得テスト
----------------------------

設定、定期タスク、Palm DesktopのHotSyncキューを変更せず、指定フィードから
PDBだけを生成できます。

  PilGomKaiUpdater.exe --fetch-only --feed-url "https://example.invalid/feed.xml" --feed-url "https://example.org/atom.xml" --output "PilGomKaiData.pdb"

利用上の注意
------------

フィードの公開は、その内容を任意のアプリで保存・再配布できることを意味しません。
入力するフィードの利用条件、各記事の著作権、私的利用の範囲を利用者自身で確認し、
生成されたPilGomKaiData.pdbや記事内容を無断で公開・再配布しないでください。

写真ごとの作者、ライセンス、原画像URL、加工内容は
PilGomKaiData.photo.jsonへ保存されます。スクリーンショットなどへ再利用する際は、
そのファイルとCommonsの原画像ページでライセンス条件を確認してください。

EXEはデジタル署名されていません。SmartScreenが表示された場合は、配布元と
SHA256SUMS.txtのハッシュを確認してから実行してください。

収録ファイル
------------

- PilGomKaiUpdater.exe
- PilGomKai_0.2.1_JP.prc
- README-Windows.txt
- THIRD_PARTY_NOTICES.txt
- THIRD_PARTY_LICENSES\（同梱ライブラリのライセンス原文）
- SHA256SUMS.txt
