pub.byline.book
An author-authoritative record of a published or forthcoming work, signed by the author's own repository.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | byline.pub |
| Indexed |
Record
record · key tidProperties
authors
arrayCredited contributors. The repo owner is presumed primary author unless roles say otherwise.
- lex:pub.byline.defs#contributor
copyrightYear
integerYear of first copyright for the work.
cover
blobCover image, stored as a blob in the author's own repository.
maxSize: 2000000accept: image/png, image/jpeg, image/webp
coverAlt
stringAlt text describing the cover image, for accessibility.
maxLength: 1000
description
stringLong blurb / marketing copy. Markdown; consumers render or strip.
maxGraphemes: 5000
discussions
arrayStrong references to atproto-native discussion threads about this work (e.g. a Bluesky post, a pub.byline.comment). Off-protocol social goes in links[] with kind=discussion or social.
- lex:com.atproto.repo.strongRef
editions
array- lex:pub.byline.defs#edition
genres
arrayShelf-category genres for the work. Freeform; byline's authoring tool suggests existing values to encourage convergence, but no value is enforced.
maxLength: 128maxGraphemes: 128
identifiers
ref- lex:pub.byline.defs#identifiers
language
stringBCP-47 language tag, e.g. en, en-CA.
links
arrayWork-level links not tied to a specific edition.
- lex:pub.byline.defs#link
pageCount
integerWork-level page count. An edition's pageCount overrides this when present.
minimum: 1
publicationDate
string · datetimeActual or planned first-publication date.
publisher
stringWork-level publisher. An edition's publisher overrides this when present.
maxLength: 256
series
refSeries membership, if any. Book points at the series; the series record never points back.
- lex:pub.byline.defs#seriesMembership
shortDescription
stringCard and grid summary. Markdown; consumers render or strip.
maxGraphemes: 500
status
stringknownValues: pub.byline.defs#published | pub.byline.defs#forthcoming | pub.byline.defs#draft | pub.byline.defs#outOfPrint
subtitle
stringmaxLength: 512
tagline
stringOne-line hook for hero or featured display. Plain text, no markdown.
maxGraphemes: 200
tags
arrayFreeform descriptors. Genre lives in genres[]; tags are everything else.
maxLength: 128maxGraphemes: 128
minLength: 1maxLength: 512
updatedAt
string · datetimeSimilar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
A person credited on the work.
-
page.cavu.book
objectBook extension object, embedded in a site.standard.publication record as a pass-through `book` property (the Leaflet `theme` pattern). Its presence marks the publication as a book; series publications omit it. The publication's standard fields remain the fallback identity (name = title, description = blurb, icon = square mark).
-
com.nerdballot.book
recordA canonical work in the Nerd Ballot catalog, published by the Nerd Ballot account. Ballots reference these records by AT-URI.
-
A submission record carrying candidate catalog data for an edition of a previously-submitted work, published by a trusted submitter to their own PDS. Repeatable; a submitter may create, update, or delete edition-submission records over time.
-
A submission record carrying candidate catalog data for a work, published by a trusted submitter to their own PDS. Repeatable; a submitter may create, update, or delete work-submission records over time.