YunoHost-Apps/weblate_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/weblate_ynh.git synced 2024-10-01 13:35:04 +02:00
Code Issues Activity Actions 1
Weblate package for YunoHost
144 commits 5 branches 0 tags 988 KiB
Python 51.4%
Shell 48.6%
Find a file
Jean-Baptiste Holcroft eb87fcf289 typo fix
2018-10-06 20:49:54 +02:00
conf typo fix 2018-10-06 20:49:54 +02:00
hooks Add 3.1.1 upgrade with two steps upgrade 2018-09-01 22:46:03 +02:00
scripts ynh_string_random can't go further 24... 2018-09-02 14:18:13 +02:00
.gitignore Initial commit 2017-09-13 12:17:55 +02:00
check_process Impove mail helper and check_process 2018-06-03 15:07:35 +02:00
LICENSE switch from GPL3 to AGPL3 2017-09-13 17:19:18 +02:00
manifest.json Upgrade to 3.1.1 2018-08-27 22:36:09 +02:00
README.md Improve Readme 2018-09-17 22:29:37 +02:00

README.md

Install Weblate with YunoHost

Weblate translation platform for YunoHost

The YunoHost team uses Weblate for translations: https://translate.yunohost.org

Admin account

An admin user is created at installation, the login is what you provided at installation, the password is weblate.

Weblate 3.0 upgrade

This upgrade is a major one, remember to read this page before upgrading: https://docs.weblate.org/en/latest/admin/upgrade.html#upgrade-3

After upgrading:

  • All existing users and groups have been migrated to new model.
  • Any per user permissions are removed, please assign users to appropriate groups and roles to grant them permissions.
  • Any custom groups will not have any permissions after upgrade, please grant the permissions again.

Github

You'll need to give weblate a github user and a token. Please read github's documentation about token. This user will only be used to open the pull-request, each translation keep his author.

Careful, I still have to understand why, but you'll have to manually move your hub binary frile from /var/www/$app/bin/ to /usr/bin to enable pull request on github. I'm close to fix this.

SSH keys, you'll have to go in administration, and generate a public key for weblate and add github.com so weblate knows the fingerprint. Please note if your account already have a public key (ssh-rsa), you'll have to manually add the weblate's one to your github account.

Settings and upgrades

Almost everything related to Weblate's configuration is handled in a settings.py file. You'll probably edit it to enable or disable diverse features, it is stored in $final_path/venv/lib/python2.7/site-packages/weblate/settings.py.

Unfortunatly, this settings file also gets upgrades for each release.

This package will :

  • generate a default settings file for your current installation,
  • send you a diff with your actual settings (the content will be sent to root, and only basic information for weblate's admin),
  • generate a default settings file the new weblate's version, that will replace your actual settings.py.

You'll have to manually add your previous changes to this new settings.py.

Miscellaneous

Weblate and databases

Weblate recommands PostgreSQL, but YunoHost uses Mysql.

Carefull, this application install PostgreSQL and change the default configuration to ask for every connexion and every user a password (local all all password).

LDAP connexion

It doesn't work yet, but while it looks doable, I'm unsure it is a good idea to connect this kind of tools to your LDAP.

State of this package

Links