BookFieldga qaytish

BookField package formati

wbpkg

BookField validate, install va read qila oladigan package

Version snapshot

workbook.toml
schema_version = 4
.wbpkg/manifest.json
schemaVersion = 5
reader_manifest.json
schemaVersion = 3
reader.rdoc
schemaVersion = 3
Reader SQLite schema
db_schema_version = 17

Qisqacha

BookField validate, install va read qila oladigan package

Bitta package bitta work va bitta edition uchun yagona installable boundary hisoblanadi. manifest.json BookField importdan oldin o‘qiydigan public contract. Legacy packageKind va presentation fields joriy package shape tarkibiga kirmaydi.

Installable container

Bitta package bitta work va bitta edition uchun yagona installable boundary hisoblanadi.

Manifest v5

manifest.json BookField importdan oldin o‘qiydigan public contract. Legacy packageKind va presentation fields joriy package shape tarkibiga kirmaydi.

ReaderDoc v3

ReaderDoc content import uchun tayyorlangan, shuning uchun reader runtime paytida EPUB, HTML yoki CSS parse qilmaydi.

Navigation tree

navigationTree reader uchun entry point va package-level table of contents-ni belgilaydi.

Locator indexes

canonical docs yoki schema files o‘zgarganda avval source-ni update qiling, keyin bu public snapshot va izohni refresh qiling.

Study plans

Authored study plans package ichida schedule data bo‘lsa, manifest.json ichida bo‘ladi.

Package layout

wbpkg ichidagi canonical files

Package paths package-root-relative POSIX paths hisoblanadi. Text packages reader/ ostida ReaderDoc files saqlaydi; image, audio yoki video only packages reader/ ni qoldirishi mumkin.

.wbpkg
manifest.json
reader/{assetId}/reader_manifest.json
reader/{assetId}/reader.rdoc
images/{assetId}.{ext}
images/{assetId}-thumb.{ext}
media/{assetId}.{ext}
locator/{profileId}.json

Manifest contract

Manifest v5 install contract-ni belgilaydi

manifest.json BookField importdan oldin o‘qiydigan public contract. Legacy packageKind va presentation fields joriy package shape tarkibiga kirmaydi.

packageId / packageVersion

manifest.json BookField importdan oldin o‘qiydigan public contract. Legacy packageKind va presentation fields joriy package shape tarkibiga kirmaydi.

work / edition

Bitta package bitta work va bitta edition uchun yagona installable boundary hisoblanadi.

assets

Package paths package-root-relative POSIX paths hisoblanadi. Text packages reader/ ostida ReaderDoc files saqlaydi; image, audio yoki video only packages reader/ ni qoldirishi mumkin.

navigationTree

navigationTree reader uchun entry point va package-level table of contents-ni belgilaydi.

studyPlans

Authored study plans package ichida schedule data bo‘lsa, manifest.json ichida bo‘ladi.

bindings

canonical docs yoki schema files o‘zgarganda avval source-ni update qiling, keyin bu public snapshot va izohni refresh qiling.

Package creation

Production tooling-ni public package boundary-dan alohida tuting

  1. 1

    Source content tayyorlash

    source content, metadata, media va authored schedules yoki references tayyorlang.

  2. 2

    wbpkg yaratish

    manifest metadata, ReaderDoc content, media, navigation va locator files bilan installable package yarating.

  3. 3

    Ulashishdan oldin tekshirish

    distribution oldidan package structure va schema compatibility-ni tekshiring.

Reader import

BookField installed package-ni lokal o‘qiydi

  1. 1

    Validate

    BookField package shape-ni tekshiradi va unsupported yoki malformed packages-ni reject qiladi.

  2. 2

    Unpack

    Supported package assets app-owned local storage ichiga unpack qilinadi.

  3. 3

    SQLite-ga import

    ReaderDoc payloads, navigation, locator indexes, search records va schedules offline use uchun register qilinadi.

Compatibility

Packages-ni predictable tutadigan rules

  • Reject: qiling legacy packageKind values.
  • Reject: qiling legacy presentation fields.
  • Reject: qiling non-canonical package paths.
  • Reject: qiling malformed structured references.
  • installable wbpkg ichiga source EPUB files qo‘shmang.

Canonical references

Update policy

Bu public page implementation-facing overview, canonical schema source emas. Canonical docs va schema files BookField source materials bilan saqlanadi.

Source docs va schema files

  • 00-spec-index.md

    Bu public page implementation-facing overview, canonical schema source emas. Canonical docs va schema files BookField source materials bilan saqlanadi.

  • 04-manifest-json-schema.md

    manifest.json BookField importdan oldin o‘qiydigan public contract. Legacy packageKind va presentation fields joriy package shape tarkibiga kirmaydi.

  • 08-reader-app-design.md

    BookField installed package-ni lokal o‘qiydi

  • schemas/manifest-v5.schema.json / readerdoc-v3.schema.json

    Bu public page implementation-facing overview, canonical schema source emas. Canonical docs va schema files BookField source materials bilan saqlanadi.

canonical docs yoki schema files o‘zgarganda avval source-ni update qiling, keyin bu public snapshot va izohni refresh qiling.

BookField package distribution-ni rejalashtiring

Product overview-ga qayting yoki wbpkg distribution flow content modelingizga mos keladimi, muhokama qiling.