archive/BookStackApp_BookStack
0
0
Fork 0
mirror of https://github.com/BookStackApp/BookStack.git synced 2025-04-30 06:30:03 +00:00
Code Issues Projects Releases Wiki Activity

ZIP Export: Started types in format doc

Browse source
This commit is contained in:
Dan Brown 2024-10-13 22:56:22 +01:00
parent e088d09e47
commit 1930af91ce
No known key found for this signature in database
GPG key ID: 46D9F943C24A2EF9
1 changed files with 16 additions and 3 deletions

19
dev/docs/portable-zip-file-format.md
View file

@ -59,11 +59,22 @@ The `id_ciphertext` is the ciphertext of encrypting the text `bookstack`. This i
#### Book #### Book
TODO - `id` - Number, optional, original ID for the book from exported system.
- `name` - String, required, name/title of the book.
- `description_html` - String, optional, HTML description content.
- `chapters` - [Chapter](#chapter) array, optional, chapters within this book.
- `pages` - [Page](#page) array, optional, direct child pages for this book.
- `tags` - [Tag](#tag) array, optional, tags assigned to this book.
The `pages` are not all pages within the book, just those that are direct children (not in a chapter). To build an ordered mixed chapter/page list for the book, as what you'd see in BookStack, you'd need to combine `chapters` and `pages` together and sort by their `priority` value (low to high).
#### Chapter #### Chapter
TODO - `id` - Number, optional, original ID for the chapter from exported system.
- `name` - String, required, name/title of the chapter.
- `description_html` - String, optional, HTML description content.
- `pages` - [Page](#page) array, optional, pages within this chapter.
- `tags` - [Tag](#tag) array, optional, tags assigned to this chapter.
#### Page #### Page
@ -79,4 +90,6 @@ TODO
#### Tag #### Tag
TODO - `name` - String, required, name of the tag.
- `value` - String, optional, value of the tag (can be empty).
- `order` - Number, optional, integer order for the tags (shown low to high).