YunoHost-Apps/domoticz_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/domoticz_ynh.git synced 2024-09-03 18:26:17 +02:00
Code Issues Activity Actions

Merge pull request #31 from YunoHost-Apps/testing

Browse source 
Testing
This commit is contained in:
Salamandar 2024-06-20 12:46:55 +02:00 committed by GitHub
commit ab5050d17e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 146 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
ALL_README.md
View file

@ -1,6 +1,8 @@
# All available README files by language
- [Read the README in English](README.md)
- [Lea el README en español](README_es.md)
- [Irakurri README euskaraz](README_eu.md)
- [Lire le README en français](README_fr.md)
- [Le o README en galego](README_gl.md)
- [阅读中文（简体）的 README](README_zh_Hans.md)

64
README_es.md Normal file
View file

@ -0,0 +1,64 @@
<!--
Este archivo README esta generado automaticamente<https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
No se debe editar a mano.
-->
# Domoticz para Yunohost
[![Nivel de integración](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz) ![Estado funcional](https://ci-apps.yunohost.org/ci/badges/domoticz.status.svg) ![Estado En Mantención](https://ci-apps.yunohost.org/ci/badges/domoticz.maintain.svg)
[![Instalar Domoticz con Yunhost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz)
*[Leer este README en otros idiomas.](./ALL_README.md)*
> *Este paquete le permite instalarDomoticz rapidamente y simplement en un servidor YunoHost.*
> *Si no tiene YunoHost, visita [the guide](https://yunohost.org/install) para aprender como instalarla.*
## Descripción general
Domoticz is a Home Automation system design to control various devices and receive input from various sensors.
For example this system can be used with:
* Light switches
* Door sensors
* Doorbells
* Security devices
* Weather sensors like: UV/Rain/Wind Meters
* Temperature Sensors
* Pulse Meters
* Voltage / AD Meters
* And more...
The MQTT broker Mosquitto is integrated into the package and requires its own domain or subdomain. It's an optional setting.
You may also install the [Mosquitto package](https://github.com/YunoHost-Apps/mosquitto_ynh) without using the one provided by domoticz_ynh.
**Versión actual:** 2024.4~ynh1
## Capturas
![Captura de Domoticz](./doc/screenshots/domoticz_Switches_screen.png)
![Captura de Domoticz](./doc/screenshots/domoticz_floorplan_machineon.png)
## Documentaciones y recursos
- Sitio web oficial: <https://domoticz.com/>
- Documentación usuario oficial: <https://www.domoticz.com/DomoticzManual.pdf>
- Documentación administrador oficial: <https://www.domoticz.com/wiki/Main_Page>
- Repositorio del código fuente oficial de la aplicación : <https://github.com/domoticz/domoticz>
- Catálogo YunoHost: <https://apps.yunohost.org/app/domoticz>
- Reportar un error: <https://github.com/YunoHost-Apps/domoticz_ynh/issues>
## Información para desarrolladores
Por favor enviar sus correcciones a la [`branch testing`](https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing
Para probar la rama `testing`, sigue asÍ:
```bash
sudo yunohost app install https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug
o
sudo yunohost app upgrade domoticz -u https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug
```
**Mas informaciones sobre el empaquetado de aplicaciones:** <https://yunohost.org/packaging_apps>

64
README_zh_Hans.md Normal file
View file

@ -0,0 +1,64 @@
<!--
注意：此 README 由 <https://github.com/YunoHost/apps/tree/master/tools/readme_generator> 自动生成
请勿手动编辑。
-->
# YunoHost 上的 Domoticz
[![集成程度](https://dash.yunohost.org/integration/domoticz.svg)](https://dash.yunohost.org/appci/app/domoticz) ![工作状态](https://ci-apps.yunohost.org/ci/badges/domoticz.status.svg) ![维护状态](https://ci-apps.yunohost.org/ci/badges/domoticz.maintain.svg)
[![使用 YunoHost 安装 Domoticz](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=domoticz)
*[阅读此 README 的其它语言版本。](./ALL_README.md)*
> *通过此软件包，您可以在 YunoHost 服务器上快速、简单地安装 Domoticz。*
> *如果您还没有 YunoHost，请参阅[指南](https://yunohost.org/install)了解如何安装它。*
## 概况
Domoticz is a Home Automation system design to control various devices and receive input from various sensors.
For example this system can be used with:
* Light switches
* Door sensors
* Doorbells
* Security devices
* Weather sensors like: UV/Rain/Wind Meters
* Temperature Sensors
* Pulse Meters
* Voltage / AD Meters
* And more...
The MQTT broker Mosquitto is integrated into the package and requires its own domain or subdomain. It's an optional setting.
You may also install the [Mosquitto package](https://github.com/YunoHost-Apps/mosquitto_ynh) without using the one provided by domoticz_ynh.
**分发版本：** 2024.4~ynh1
## 截图
![Domoticz 的截图](./doc/screenshots/domoticz_Switches_screen.png)
![Domoticz 的截图](./doc/screenshots/domoticz_floorplan_machineon.png)
## 文档与资源
- 官方应用网站： <https://domoticz.com/>
- 官方用户文档： <https://www.domoticz.com/DomoticzManual.pdf>
- 官方管理文档： <https://www.domoticz.com/wiki/Main_Page>
- 上游应用代码库： <https://github.com/domoticz/domoticz>
- YunoHost 商店： <https://apps.yunohost.org/app/domoticz>
- 报告 bug： <https://github.com/YunoHost-Apps/domoticz_ynh/issues>
## 开发者信息
请向 [`testing` 分支](https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing) 发送拉取请求。
如要尝试 `testing` 分支，请这样操作：
```bash
sudo yunohost app install https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug
或
sudo yunohost app upgrade domoticz -u https://github.com/YunoHost-Apps/domoticz_ynh/tree/testing --debug
```
**有关应用打包的更多信息：** <https://yunohost.org/packaging_apps>

10
doc/PRE_UPGRADE.d/2024.2~ynh1.md
View file

@ -1,10 +1,14 @@
###
### Important
BEWARE! If you did not activate the Mosquitto Broker within this package, please run following command prior to upgrade:
````sudo yunohost app setting __APP__ mqtt_domain -v your.__APP__.domain.tld```` with your.__APP__.domain.tld being the current domain of the application.
Failure to do so may break the app.
`sudo yunohost app setting __APP__ mqtt_domain -v your.__APP__.domain.tld` with `your.__APP__.domain.tld` being the current domain of the application.
**Failure to do so may break the app.**
If you did activate the Mosquitto broker, you can proceed safely.
### Version 2024.2
This update to 2024.2 brings a few changes in the package:
- Move to packaging V2: This will move the app folder from `/opt/yunohost/__APP__` to `/var/www/__APP__`. This should not cause any trouble to Domoticz, but some plugins may not like it.For example, Zigbee4Domoticz requires to edit config file in `/var/www/__APP__/plugins/Domoticz-Zigbee/Conf/PluginConf-08.json` to set the correct path in it.
- Since 2024.1, Domoticz provides precompiled binaries for each of the version on the project Github. while previously only the last version was available to download. So upgrades from inside the application have been disabled. This will allow a better integration in YunoHost but requires to prevent as much as possible upgrade from inside the app. From now on, a new package version will be published after each Domoticz update.

12
doc/PRE_UPGRADE.d/2024.2~ynh1_fr.md
View file

@ -1,10 +1,14 @@
###
ATTENTION! Si vous n'avez pas activer l'option du Broker Mosquitto de ce package, veuillez entrer la commande suivante avant de faire cette mise à jour:
````sudo yunohost app setting __APP__ mqtt_domain -v your.__APP__.domain.tld```` avec your.__APP__.domain.tld étant le domaine actuel de l'application.
Dans le cas contraire, vous risquez de complètement casser l'application.
### Important
ATTENTION! Si vous n'avez pas activé l'option du Broker Mosquitto de ce package, veuillez entrer la commande suivante avant de faire cette mise à jour:
`sudo yunohost app setting __APP__ mqtt_domain -v your.__APP__.domain.tld` avec `your.__APP__.domain.tld` étant le domaine actuel de l'application.
**Dans le cas contraire, vous risquez de complètement casser l'application.**
Si par contre vous avez activer le broker, Mosquitto, vous pouvez procéder à la mise à jour sans soucis.
### Version 2024.2
La mise à jour vers la 2024.2 a amené beaucoup de changements dans le package:
- Passage en packaging V2 : Ceci entraine le déplacement de l'application de `/opt/yunohost/__APP__` vers `/var/www/__APP__`. Normalement cela ne pose pas de problèmes à Domoticz mais certain plugins peuvent ne pas apprécier. Par exemple Zigbee4Domoticz nécessite dans ce cas d'éditer le fichier de configuration de `/var/www/__APP__/plugins/Domoticz-Zigbee/Conf/PluginConf-08.json` pour y remettre les chemins corrects.
- Domoticz fourni depuis la 2024.1 les binaires compilés pour chacune des versions sur sa page Github, contrairement aux version précédentes dont seule la dernière version était téléchargeable. Donc les mises à jours depuis l'application ont été désactivées. Ceci permet de mieux intégrer Domoticz dans Yunohost mais nécessite d'empecher autant que possible les mises à jours depuis l'application. Dorénavant, une nouvelle version du package sera donc publié après chaque mise à jour de Domoticz.