1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/h5ai_ynh.git synced 2024-09-03 20:36:25 +02:00
h5ai_ynh/README.md

65 lines
3.2 KiB
Markdown
Raw Normal View History

2021-06-04 10:03:18 +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.
-->
2020-07-08 09:49:14 +02:00
# h5ai for YunoHost
2016-06-02 16:10:37 +02:00
2022-10-16 20:28:19 +02:00
[![Integration level](https://dash.yunohost.org/integration/h5ai.svg)](https://dash.yunohost.org/appci/app/h5ai) ![Working status](https://ci-apps.yunohost.org/ci/badges/h5ai.status.svg) ![Maintenance status](https://ci-apps.yunohost.org/ci/badges/h5ai.maintain.svg)
2020-12-19 23:00:14 +01:00
[![Install h5ai with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=h5ai)
2020-07-08 09:49:14 +02:00
*[Lire ce readme en français.](./README_fr.md)*
2021-06-04 10:03:18 +02:00
> *This package allows you to install h5ai 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.*
2020-07-08 09:49:14 +02:00
## Overview
2022-10-16 20:28:19 +02:00
h5ai is a modern file indexer for HTTP web servers with focus on your files. Directories are displayed in a appealing way and browsing them is enhanced by different views, a breadcrumb and a tree overview.
2020-07-08 09:49:14 +02:00
2022-10-16 20:28:19 +02:00
### Features
There are lots of optional extensions and configuration options to customize the web appearance of your directory listings. All markup is valid HTML5 spiced up with CSS3 and finest JavaScript to build a fresh but minimal user interface and a user experience that focuses on your files.
2020-07-08 09:49:14 +02:00
2022-10-16 20:28:19 +02:00
Some of the optional features are: file sorting, different view modes, localization, a breadcrumb, a tree view, custom headers and footers, file filter and search, folder sizes, auto refresh, packaged download, QR codes, thumbnails, file previews
2020-07-08 09:49:14 +02:00
2023-01-07 00:06:41 +01:00
**Shipped version:** 0.30.0~ynh4
2022-10-16 20:28:19 +02:00
**Demo:** https://larsjung.de/h5ai/demo/
2021-06-04 10:03:18 +02:00
## Screenshots
2020-07-08 09:49:14 +02:00
2022-10-16 20:28:19 +02:00
![Screenshot of h5ai](./doc/screenshots/screenshot.jpg)
![Screenshot of h5ai](./doc/screenshots/h5ai-1024x540.png)
2020-07-08 09:49:14 +02:00
2021-06-04 10:03:18 +02:00
## Disclaimers / important information
2020-07-08 09:49:14 +02:00
2021-06-04 10:03:18 +02:00
## Configuration
2020-07-08 09:49:14 +02:00
2021-06-04 10:03:18 +02:00
After installing the application, you can add documents in `/var/www/documents` (or the corresponding path you choosed).
h5ai doesn't allow to edit or upload new documents directly from the web browser. But you can imagine coupling the folder `/var/www/documents` to Nextcloud or some sort of FTP to allow some users to upload content, and use h5ai as a public read-only interface.
The main configuration file is `_h5ai/private/conf/options.json`. You might want to change some of the documented settings. But there are some more files in `_h5ai/private/conf` you might have a look at.
2020-07-08 09:49:14 +02:00
2021-06-04 10:03:18 +02:00
## Documentation and resources
2020-07-08 09:49:14 +02:00
2022-10-16 20:28:19 +02:00
* Official app website: <https://larsjung.de/h5ai/>
* Official admin documentation: <https://larsjung.de/h5ai/>
* Upstream app code repository: <https://github.com/lrsjng/h5ai>
* YunoHost documentation for this app: <https://yunohost.org/app_h5ai>
* Report a bug: <https://github.com/YunoHost-Apps/h5ai_ynh/issues>
2020-07-08 09:49:14 +02:00
## Developer info
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/h5ai_ynh/tree/testing).
2018-08-08 21:46:41 +02:00
2020-07-08 09:49:14 +02:00
To try the testing branch, please proceed like that.
2022-10-16 20:28:19 +02:00
``` bash
2020-07-08 09:49:14 +02:00
sudo yunohost app install https://github.com/YunoHost-Apps/h5ai_ynh/tree/testing --debug
or
sudo yunohost app upgrade h5ai -u https://github.com/YunoHost-Apps/h5ai_ynh/tree/testing --debug
```
2021-06-04 10:03:18 +02:00
2022-10-16 20:28:19 +02:00
**More info regarding app packaging:** <https://yunohost.org/packaging_apps>