https://github.com/yunohost/yunohost-admin
Web administration interface for YunoHost
https://github.com/yunohost/yunohost-admin
admin-ui javascript js-client webadmintool yunohost yunohost-admin yunohost-api
Last synced: 7 months ago
JSON representation
Web administration interface for YunoHost
- Host: GitHub
- URL: https://github.com/yunohost/yunohost-admin
- Owner: YunoHost
- License: agpl-3.0
- Created: 2013-07-01T13:57:25.000Z (over 12 years ago)
- Default Branch: dev
- Last Pushed: 2025-04-01T18:22:14.000Z (7 months ago)
- Last Synced: 2025-04-04T02:07:23.847Z (7 months ago)
- Topics: admin-ui, javascript, js-client, webadmintool, yunohost, yunohost-admin, yunohost-api
- Language: Vue
- Homepage: http://yunohost.org
- Size: 16.2 MB
- Stars: 102
- Watchers: 25
- Forks: 74
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
YunoHost Admin
[](https://github.com/YunoHost/yunohost-admin/actions/workflows/eslint.yml)
[](https://github.com/YunoHost/yunohost/blob/dev/LICENSE)
[YunoHost](https://yunohost.org) administration web interface (VueJS client for the API).
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).
## Issues
- [Please report issues on YunoHost bugtracker](https://github.com/YunoHost/issues).
## Translation
You can help translate Yunohost-Admin on our [translation platform](https://translate.yunohost.org/engage/yunohost/?utm_source=widget)
## Developpers
Contributions are welcome!
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:
```bash
./ynh-dev use-git yunohost-admin
```
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.
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.
On a YunoHost instance, the web admin files are located at `/usr/share/yunohost/admin`.
### Debugging
To log SSE messages, type `localStorage.setItem('debug', true)` in the console and reload the page. Type `localStorage.removeItem('debug')` to deactivate it.
### Translation maintenance
#### Cleaning
To clean locales from unused keys:
```
python3 maintenance/clean_locales.py
```
This will also reorder keys in `en.json`.
#### Renaming
If you need to rename a key or more (from 'my.current.key' to 'my.new.key' for example).
From a string
```bash
python3 rename_i18n_keys.py --keys my.current.key:my.new.key
```
#### From a file
```bash
python3 rename_i18n_keys.py --file input.txt
```
input.txt
```
my.current.key:my.new.key
my.other.key:my.new.other.key
```
By default it renames keys only in the `en.json`, pass `--all` to apply changes to all locales file.