2021-05-24 15:16:05 +02:00
<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
2021-01-29 16:24:35 +01:00
2021-05-24 15:16:05 +02:00
# BookStack for YunoHost
2019-07-29 19:50:23 +02:00
2021-05-30 17:29:24 +02:00
[![Integration level ](https://dash.yunohost.org/integration/bookstack.svg )](https://dash.yunohost.org/appci/app/bookstack) ![](https://ci-apps.yunohost.org/ci/badges/bookstack.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/bookstack.maintain.svg)
[![Install BookStack with YunoHost ](https://install-app.yunohost.org/install-with-yunohost.svg )](https://install-app.yunohost.org/?app=bookstack)
2019-07-29 19:50:23 +02:00
2021-05-24 15:16:05 +02:00
*[Lire ce readme en français.](./README_fr.md)*
2019-07-29 19:50:23 +02:00
2021-05-30 17:29:24 +02:00
> *This package allows you to install BookStack quickly and simply on a YunoHost server.
2021-05-24 15:16:05 +02:00
If you don't have YunoHost, please consult [the guide ](https://yunohost.org/#/install ) to learn how to install it.*
2019-07-29 19:50:23 +02:00
2021-05-24 15:16:05 +02:00
## Overview
2019-07-29 19:50:23 +02:00
2021-09-02 23:39:23 +02:00
BookStack is an opinionated wiki system that provides a pleasant and simple out of the box experience. New users to an instance should find the experience intuitive and only basic word-processing skills should be required to get involved in creating content on BookStack. The platform should provide advanced power features to those that desire it but they should not interfere with the core simple user experience.
2019-07-29 19:50:23 +02:00
2021-09-02 23:39:23 +02:00
2021-12-16 09:31:54 +01:00
**Shipped version:** 21.11.3~ynh1
2021-01-29 13:26:46 +01:00
2021-05-24 15:16:05 +02:00
**Demo:** https://demo.bookstackapp.com
2021-01-29 13:26:46 +01:00
2021-05-24 15:16:05 +02:00
## Screenshots
2021-01-28 23:21:19 +01:00
2021-05-30 17:29:24 +02:00
![](./doc/screenshots/bookstack-hero-screenshot.jpg)
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
## Disclaimers / important information
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
## Configuration
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
For the first time Login, use the default credentials `admin@admin.com` and `password` . You should change these details immediately after logging in for the first time.
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
* How to configure this app: From an admin panel, a plain file with SSH, or any other way.
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
## Documentation and resources
2021-01-28 23:21:19 +01:00
2021-05-24 15:16:05 +02:00
* Official app website: https://www.bookstackapp.com
* Official admin documentation: https://www.bookstackapp.com/docs
2021-05-30 17:29:24 +02:00
* Upstream app code repository: https://github.com/BookStackApp/BookStack
2021-05-24 15:16:05 +02:00
* YunoHost documentation for this app: https://yunohost.org/app_bookstack
* Report a bug: https://github.com/YunoHost-Apps/bookstack_ynh/issues
2021-01-28 23:21:19 +01:00
## Developer info
Please send your pull request to the [testing branch ](https://github.com/YunoHost-Apps/bookstack_ynh/tree/testing ).
To try the testing branch, please proceed like that.
```
sudo yunohost app install https://github.com/YunoHost-Apps/bookstack_ynh/tree/testing --debug
or
sudo yunohost app upgrade bookstack -u https://github.com/YunoHost-Apps/bookstack_ynh/tree/testing --debug
```
2021-05-24 15:16:05 +02:00
**More info regarding app packaging:** https://yunohost.org/packaging_apps