Home

Awesome

<h1 align="center">YunoHost Admin</h1> <div align="center">

Version Tests status Project license

YunoHost 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.

Web admin interface screenshot

</div>

Issues

Translation

You can help translate Yunohost-Admin on our translation platform

<div align="center"><img alt="View of the translation rate for the different languages available in YunoHost" src="https://translate.yunohost.org/widgets/yunohost/-/admin/horizontal-auto.svg" alt="Translation status" /></div>

Developpers

Contributions are welcome!

In order to contribute you will need to setup a development environment using 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:

./ynh-dev use-git yunohost-admin

This command will install all dependencies and start a dev server (based on 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 (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.

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

python3 rename_i18n_keys.py --keys my.current.key:my.new.key

From a file

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.