Skip to content

Commit 72f9ad3

Browse files
Update README.md
Create the initial README
1 parent 530bf3b commit 72f9ad3

File tree

1 file changed

+102
-2
lines changed

1 file changed

+102
-2
lines changed

README.md

Lines changed: 102 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,102 @@
1-
# FlutterBookstackApiExample
2-
This Flutter project demonstrates how to use the Bookstack API.
1+
# BookStackAPI Flutter/Dart Script Readme
2+
3+
This Flutter/Dart script demonstrates the usage of the BookStackAPI library to interact with a BookStack instance. The script showcases various functions available in the BookStackAPI library, allowing you to perform operations such as fetching books, chapters, and pages, creating new content, updating existing content, and more.
4+
5+
![Flutter](https://img.shields.io/badge/Flutter-%5E2.0.0-blue)
6+
![Dart](https://img.shields.io/badge/Dart-%5E2.15.0-blue)
7+
![BookStackAPI](https://img.shields.io/badge/BookStackAPI-%5E1.0.0-green)
8+
9+
## Getting Started
10+
11+
1. Clone this repository to your local machine:
12+
13+
```bash
14+
git clone https://github.com/chris-devel0per/FlutterBookstackApiExample.git
15+
cd FlutterBookstackApiExample
16+
```
17+
18+
2. Install Flutter and Dart if you haven't already. Follow the [official installation guide](https://flutter.dev/docs/get-started/install) for your platform.
19+
20+
3. Install dependencies:
21+
22+
```bash
23+
flutter pub get
24+
```
25+
26+
4. Configure the BookStackAPI settings:
27+
28+
Open the `lib/controller/server_info.dart` file and provide your BookStack instance's base URL, API token, and other configuration details.
29+
30+
5. Run the script:
31+
32+
```bash
33+
flutter run
34+
```
35+
36+
## Features
37+
38+
### Authentication
39+
40+
The script demonstrates how to authenticate with the BookStack API using your API token and make authenticated requests.
41+
42+
### Fetching Books, Chapters, and Pages
43+
44+
You can use the library to fetch a list of books, chapters within a book, and pages within a chapter. The script showcases how to retrieve this hierarchical content structure.
45+
46+
### Creating Content
47+
48+
Learn how to create new books, chapters, and pages using the BookStackAPI library. The script includes examples of creating various types of content.
49+
50+
### Updating Content
51+
52+
See how to update existing content such as book titles, chapter names, and page content.
53+
54+
### Deleting Content
55+
56+
The script demonstrates how to delete books, chapters, and pages. Be cautious when using this functionality, as it permanently removes content.
57+
58+
### Search
59+
60+
Learn how to perform search queries using the BookStackAPI library. The script showcases searching for books, chapters, and pages based on keywords.
61+
62+
### Attachments
63+
64+
Learn how to interact with the Attachments
65+
66+
### Image-Gallery
67+
68+
Learn how to interact with the Image-Gallery
69+
70+
### USER & ROLES
71+
72+
Learn how to manage users and Roles
73+
74+
### ATTENTION
75+
76+
These methods are <ins>!!!NOT!!!</ins> supported:
77+
78+
79+
Recycle-Bin>restore
80+
81+
82+
Recycle-Bin>destroy
83+
84+
85+
86+
Content-permissions>update
87+
88+
## Documentation
89+
90+
For more detailed information about the available functions and classes in the BookStackAPI library, refer to the official documentation provided with the library. You can find it [here](https://demo.bookstackapp.com/api/docs).
91+
92+
## Contributions
93+
94+
Contributions to this script and the associated documentation are welcome. If you find any bugs or have suggestions for improvement, please open an issue or submit a pull request on the GitHub repository.
95+
96+
## License
97+
98+
This script is released under the [MIT License](LICENSE).
99+
100+
---
101+
102+
Happy coding! If you have any questions or need assistance, feel free to reach out to the author at Discord (skiddybison5924).

0 commit comments

Comments
 (0)