[Feature]: Desktop app: books reader

オープン
#94 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
20/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
rust, typescript

調査の方向性

Read the epic #80 and its prerequisites #82 and #83, then use the web reader files under web/src/books/ and the routes/book.$id.tsx and routes/read.$id.tsx routes as the specification. Start by porting packages/shared/src/books.ts and its books.test.ts tests to Rust. Done means long EPUB and FB2 books read like they do on the web, positions sync to the same sentence across window sizes, and quotes sync between web and desktop.

索引モデルが issue の本文から書いたものです。

説明

enhancement

[!NOTE]
This issue was written by Claude (Claude Opus 5.5) from a planning session with @PhrolovaMoe. Part of #80, builds on #82 and #83. Read the epic first.

Area

Desktop app

Problem

The web has a novel reader with positions shared across devices and quotes (highlights stored as clips). It's part of parity.

Proposed solution

The web is the spec: web/src/books/ (Library.tsx, Reader.tsx, components.tsx, focus.ts, quotes.tsx), routes/book.$id.tsx, routes/read.$id.tsx.

  • Port packages/shared/src/books.ts to Rust with its tests (books.test.ts): the content model (/api/books/{id}/content JSON, with style flags BOLD, ITALIC… as bits) and positions counted in characters of text, so the same position lands on the same sentence on web, Android and desktop, at any size.
  • Layout and text with iced's text stack (cosmic-text), in Geist and whatever font choices the web reader offers. Images through /api/books/{id}/files/{*name}, covers through /api/books/{id}/cover.
  • Every reading mode and setting the web reader has (paging/scrolling, sizes, margins, themes within the app's scheme), the focus behaviour of focus.ts, and keyboard navigation.
  • Progress: the same mutations and cadence as the web, so switching devices continues where you were.
  • Quotes: selecting text and saving a quote (a highlight stored as a clip), showing existing highlights, the quotes list, as on web.
  • The book's details page (book.$id): metadata, cover, continue reading.
Done when

A long EPUB and an FB2 read the same as on web. Positions round-trip between web and app to the same sentence at different window sizes, and quotes made in either show up in both.

主要言語
TypeScript
スター
4
フォーク
1
平均マージ
4時間 49分
マージ済み PR(30日)
5

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

tinystream-dev/tinystream のほかの issue

tinystream-dev/tinystream の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。