ink.resenha.reading

A reader's reading of a book BookHive's catalogue doesn't hold, or can't be matched to for certain: the home of last resort, so any book can be added to a library and reviewed. One per book. Status, dates, rating, review and progress live here as they do on a buzz.bookhive.book; the book is named in every key anyone uses, so any app that recognises one of them can show the reading. When BookHive's catalogue has the book, Resenha moves the reading there: it writes a buzz.bookhive.book with everything the reading held, or fills in the one the reader already has, and deletes the reading in the same commit. It does this when BookHive answers for the reading's ISBN, or when the reader picks the book in BookHive's catalogue.

Repository @resenha.ink did:plc:v7itjf4h3sb5zuegiiskctqb namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityresenha.ink
Indexed

Record

record · key tid

Properties

book

requiredref
Reference

The cover itself, kept in the reader's repository, for a book whose cover has no lasting address elsewhere.

  • maxSize: 2000000
  • accept: image/*

coverUrl

string · uri

The cover as the reader's app found it, for apps without a catalogue to ask. Kept for Resenha before 1.6.10, which reads only this; newer builds also write covers.

covers

array

Every address of the cover the reader's app knew, surest first. A reader tries the next when one fails.

  • maxLength: 8
itemsstring · uri

createdAt

requiredstring · datetime

finishedAt

string · datetime

review

string

The review as plain text. A formatted version, when there is one, is a site.standard.document the reader's ink.resenha.bookReview links to.

  • maxLength: 150000
  • maxGraphemes: 15000

stars

integer

In half stars, 1 to 10, as BookHive and Popfeed keep them.

  • minimum: 1
  • maximum: 10

startedAt

string · datetime

status

string
  • knownValues: wantToRead | reading | finished | abandoned

#progress

object

How far through the book the reader is, as BookHive's bookProgress has it.

Properties

  • minimum: 1

percent

requiredinteger
  • minimum: 0
  • maximum: 100

totalPages

integer
  • minimum: 1

updatedAt

requiredstring · datetime

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A book in the user's library

  • Views shared by the calls Resenha's server answers.

  • Which catalog book a book in the reader's library is, and which of the reader's records in each book app are that book. Resenha writes these when it matches a reader's Popfeed books to BookHive's catalog, so Popfeed's and BookHive's own records are never changed to hold the match.

  • User has abandoned the book

  • Where the reader stands with a Work. One per Work: the record key is the Work's Catalog identifier. Exists with or without a Copy. No record means unread.