2021-05-24 18:27:31 +02:00
<!--
2024-04-06 03:31:12 +02:00
N.B.: This README was automatically generated by < https: / / github . com / YunoHost / apps / tree / master / tools / readme_generator >
2021-05-24 18:27:31 +02:00
It shall NOT be edited by hand.
-->
2019-07-29 19:50:23 +02:00
2021-05-24 18:27:31 +02:00
# BookStack for YunoHost
2019-07-29 19:50:23 +02:00
2024-07-15 03:31:04 +02:00
[![Integration level ](https://dash.yunohost.org/integration/bookstack.svg )](https://ci-apps.yunohost.org/ci/apps/bookstack/) ![Working status ](https://ci-apps.yunohost.org/ci/badges/bookstack.status.svg ) ![Maintenance status ](https://ci-apps.yunohost.org/ci/badges/bookstack.maintain.svg )
2023-02-26 16:31:30 +01:00
2021-06-22 08:41:26 +02:00
[![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
2024-04-06 03:31:12 +02:00
*[Read this README in other languages.](./ALL_README.md)*
2019-07-29 19:50:23 +02:00
2024-04-06 03:31:12 +02:00
> *This package allows you to install BookStack quickly and simply on a YunoHost server.*
> *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 18:27:31 +02:00
## Overview
2019-07-29 19:50:23 +02:00
2022-01-29 15:29:42 +01: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
2022-02-07 19:29:35 +01:00
### Features
2022-03-02 08:28:16 +01:00
2022-02-07 19:29:35 +01:00
- Multi-Factor Authentication
- Dark & Light Modes
- LDAP Authentication
2022-06-28 14:24:00 +02:00
- Markdown Editor
- WYSIWYG Editing
2022-02-07 19:29:35 +01:00
- Multi-Lingual
2022-06-28 14:24:00 +02:00
- Diagrams.net Integration
2022-01-29 15:29:42 +01:00
2024-04-06 03:31:12 +02:00
2024-08-29 18:17:06 +02:00
**Shipped version:** 24.05.4~ynh1
2022-02-07 19:29:35 +01:00
2024-03-19 23:10:52 +01:00
**Demo:** < https: / / demo . bookstackapp . com >
2021-02-01 14:42:41 +01:00
2021-05-24 18:27:31 +02:00
## Screenshots
2021-02-01 14:42:41 +01:00
2023-01-31 14:31:51 +01:00
![Screenshot of BookStack ](./doc/screenshots/screenshot.png )
2021-02-01 14:42:41 +01:00
2021-05-24 18:27:31 +02:00
## Documentation and resources
2021-02-01 14:42:41 +01:00
2024-03-19 23:10:52 +01:00
- Official app website: < https: // www . bookstackapp . com >
- Official user documentation: < https: // www . bookstackapp . com / docs / user />
- Official admin documentation: < https: // www . bookstackapp . com / docs / admin />
- Upstream app code repository: < https: // github . com / BookStackApp / BookStack >
- YunoHost Store: < https: // apps . yunohost . org / app / bookstack >
- Report a bug: < https: // github . com / YunoHost-Apps / bookstack_ynh / issues >
2021-02-01 14:42:41 +01:00
## Developer info
2024-04-06 03:31:12 +02:00
Please send your pull request to the [`testing` branch ](https://github.com/YunoHost-Apps/bookstack_ynh/tree/testing ).
2021-02-01 14:42:41 +01:00
2024-04-06 03:31:12 +02:00
To try the `testing` branch, please proceed like that:
2022-05-25 18:35:13 +02:00
2024-03-19 23:10:52 +01:00
```bash
2021-02-01 14:42:41 +01:00
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 18:27:31 +02:00
2024-03-19 23:10:52 +01:00
**More info regarding app packaging:** < https: / / yunohost . org / packaging_apps >