garage_ynh/README.md

85 lines
3.1 KiB
Markdown
Raw Normal View History

2018-07-01 07:57:16 +00:00
# Usage of this package (REMOVE THIS SECTION BEFORE RELEASE)
- Copy this app before working on it.
2020-01-28 05:30:10 +00:00
- Edit the `conf/nginx.conf` file to match app prerequisites.
- Edit the `manifest.json` with app specific info.
2018-07-01 07:57:16 +00:00
- Edit the `install`, `upgrade`, `remove`, `backup`, and `restore` scripts.
2021-04-24 16:34:22 +00:00
- Using the [script helpers documentation.](https://yunohost.org/packaging_apps_helpers)
2018-07-01 07:57:16 +00:00
- Add a `LICENSE` file for the package.
2020-01-28 05:30:10 +00:00
- Edit `README.md` and `README_fr.md`.
2018-07-01 07:57:16 +00:00
2017-02-04 08:58:08 +00:00
# Example app for YunoHost
2020-05-26 14:06:58 +00:00
[![Integration level](https://dash.yunohost.org/integration/REPLACEBYYOURAPP.svg)](https://dash.yunohost.org/appci/app/REPLACEBYYOURAPP) ![](https://ci-apps.yunohost.org/ci/badges/REPLACEBYYOURAPP.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/REPLACEBYYOURAPP.maintain.svg)
2020-12-10 10:27:00 +00:00
[![Install REPLACEBYYOURAPP with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=REPLACEBYYOURAPP)
2019-01-27 23:21:25 +00:00
*[Lire ce readme en français.](./README_fr.md)*
2020-01-28 05:30:10 +00:00
> *This package allows you to install REPLACEBYYOURAPP quickly and simply on a YunoHost server.
2021-04-24 16:34:22 +00:00
If you don't have YunoHost, please consult [the guide](https://yunohost.org/install) to learn how to install it.*
2014-10-20 16:55:53 +00:00
2018-06-28 20:05:35 +00:00
## Overview
Quick description of this app.
**Shipped version:** 1.0
## Screenshots
2020-01-28 05:30:10 +00:00
![](Link to a screenshot of this app.)
2018-06-28 20:05:35 +00:00
## Demo
2020-01-28 05:30:10 +00:00
* [Official demo](Link to a demo site for this app.)
2018-06-28 20:05:35 +00:00
## Configuration
2020-01-28 05:30:10 +00:00
How to configure this app: From an admin panel, a plain file with SSH, or any other way.
2018-06-28 20:05:35 +00:00
## Documentation
* Official documentation: Link to the official documentation of this app
2018-08-08 21:04:20 +00:00
* YunoHost documentation: If specific documentation is needed, feel free to contribute.
2018-06-28 20:05:35 +00:00
## YunoHost specific features
2020-01-28 05:30:10 +00:00
#### Multi-user support
2018-06-28 20:05:35 +00:00
2018-07-01 07:57:16 +00:00
Are LDAP and HTTP auth supported?
Can the app be used by multiple users?
2018-06-28 20:05:35 +00:00
#### Supported architectures
* x86-64 - [![Build Status](https://ci-apps.yunohost.org/ci/logs/REPLACEBYYOURAPP.svg)](https://ci-apps.yunohost.org/ci/apps/REPLACEBYYOURAPP/)
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/REPLACEBYYOURAPP.svg)](https://ci-apps-arm.yunohost.org/ci/apps/REPLACEBYYOURAPP/)
2018-06-28 20:05:35 +00:00
## Limitations
* Any known limitations.
2018-08-08 21:04:20 +00:00
## Additional information
2018-06-28 20:05:35 +00:00
2020-01-28 05:30:10 +00:00
* Other info you would like to add about this app.
2018-06-28 20:05:35 +00:00
2020-01-28 05:30:10 +00:00
**More info on the documentation page:**
2014-10-20 17:36:04 +00:00
https://yunohost.org/packaging_apps
2018-06-28 20:05:35 +00:00
## Links
* Report a bug: https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/issues
2020-01-28 05:30:10 +00:00
* App website: Link to the official website of this app.
* Upstream app repository: Link to the official repository of the upstream app.
2018-06-28 20:05:35 +00:00
* YunoHost website: https://yunohost.org/
---
2020-08-02 13:41:28 +00:00
## Developer info
2018-06-28 20:05:35 +00:00
**Only if you want to use a testing branch for coding, instead of merging directly into master.**
2020-01-28 05:30:10 +00:00
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing).
2018-06-28 20:05:35 +00:00
To try the testing branch, please proceed like that.
```
sudo yunohost app install https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
2018-06-28 20:05:35 +00:00
or
sudo yunohost app upgrade REPLACEBYYOURAPP -u https://github.com/YunoHost-Apps/REPLACEBYYOURAPP_ynh/tree/testing --debug
2018-06-28 20:05:35 +00:00
```