|
|
|
|
# XPPL version alt
|
|
|
|
|
Library to hold books / knowledge
|
|
|
|
|
|
|
|
|
|
## TO DOs
|
|
|
|
|
- [x] fix adding stacks
|
|
|
|
|
- [x] update requirements
|
|
|
|
|
- [ ] generate new requirements.txt and installation process?
|
|
|
|
|
- [ ] fix stacks layout
|
|
|
|
|
- [ ] remove autocomplete? and training at the start of app
|
|
|
|
|
- [ ] update layout navigation
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
Install the required dependencies:
|
|
|
|
|
|
|
|
|
|
$ pip3 install -r requirements.txt
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Initialise database / Why is this needed again, could be checked in flask?
|
|
|
|
|
|
|
|
|
|
$ bash init_db.sh
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Further install notes (bugs)
|
|
|
|
|
|
|
|
|
|
* create the covers folder inside the uploadsfolder
|
|
|
|
|
* don't forget to chmod the uploads and coverfolder ;-)
|
|
|
|
|
|
|
|
|
|
* For Mac users -> brew install imagemagick@6 in order to install wand (should not be relevant for debian server install)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Run the program
|
|
|
|
|
|
|
|
|
|
Run the script in another terminal (from XPPL directory):
|
|
|
|
|
|
|
|
|
|
python3 run.py
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Deploy on server
|
|
|
|
|
|
|
|
|
|
(this will be added soon)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## REST API
|
|
|
|
|
|
|
|
|
|
Has currently 2 entrypoints:
|
|
|
|
|
|
|
|
|
|
`/api/books`
|
|
|
|
|
GETs all the books in the database
|
|
|
|
|
|
|
|
|
|
`/api/book/id`
|
|
|
|
|
GETs a specific book by its id
|
|
|
|
|
|
