yunohost-admin/README.md

46 lines
2.1 KiB
Markdown
Raw Normal View History

<h1 align="center">YunoHost Admin</h1>
2013-07-01 15:56:32 +02:00
<div align="center">
2021-10-01 17:49:47 +02:00
![Version](https://img.shields.io/github/v/tag/yunohost/yunohost-admin?label=version&sort=semver)
[![Tests status](https://github.com/YunoHost/yunohost-admin/actions/workflows/eslint.yml/badge.svg)](https://github.com/YunoHost/yunohost-admin/actions/workflows/eslint.yml)
[![GitHub license](https://img.shields.io/github/license/YunoHost/yunohost-admin)](https://github.com/YunoHost/yunohost-admin/blob/dev/LICENSE)
[YunoHost](https://yunohost.org) administration web interface (VueJS client for the API).
2014-03-19 11:57:46 +01:00
2019-10-16 02:21:37 +02:00
This client is a part of the YunoHost project, and can not be installed directly. Please visit the YunoHost website for [installation instructions](https://yunohost.org/install).
2021-11-12 17:48:30 +01:00
![](./doc/home.png)
</div>
Issues
------
- [Please report issues on YunoHost bugtracker](https://github.com/YunoHost/issues).
2015-10-25 14:15:56 +01:00
Translation
-----------
2014-03-19 11:57:46 +01:00
2021-10-01 17:39:17 +02:00
You can help translate Yunohost-Admin on our [translation platform](https://translate.yunohost.org/engage/yunohost/?utm_source=widget)
2017-03-28 23:54:15 +02:00
<div align="center"><img src="https://translate.yunohost.org/widgets/yunohost/-/admin/horizontal-auto.svg" alt="Translation status" /></div>
2014-03-19 11:57:46 +01:00
Developpers
-------------
2014-03-19 11:57:46 +01:00
Contributions are welcome!
2021-01-19 19:23:22 +01:00
In order to contribute you will need to setup a development environment using [ynh-dev](https://github.com/YunoHost/ynh-dev) (see the README).
Once you have a environment running and are attached to it (with `./ynh-dev start`) you will be able to run:
2021-01-19 19:23:22 +01:00
```
$ ./ynh-dev use-git yunohost-admin
```
2021-01-19 19:23:22 +01:00
This command will install all dependencies and start a dev server (based on [webpack-dev-server](https://github.com/webpack/webpack-dev-server)) with Hot-Module-Replacement (live updates on code modification without reloading the page nor rebuilding the whole code). After the build step, click on the "Network:" link and you are good to go.
2016-05-14 23:22:41 +02:00
2021-01-19 19:23:22 +01:00
You can also install [Vue Devtools](https://addons.mozilla.org/fr/firefox/addon/vue-js-devtools/) (module for Firefox but also exists for Chromium/Chrome) if you want component trees, performance views and so on.
2021-01-19 19:23:22 +01:00
On a YunoHost instance, the web admin files are located at `/usr/share/yunohost/admin`.