SAC:Weblate

Weblate is an instance of the Weblate server that runs in an LXD container in Osgeo9 and provides document translation servers for OSGeo community software. .

It can be accessed via https://weblate.osgeo.org/ (login with your OSGeo Userid)

= Location and configuration =

The application runs in LXD container called weblate on OSGeo9. It is run within that application using various docker containers launched with docker compose under the account weblate. Data is in a PostgreSQL database.

The configs are in /home/weblate/weblate-docker-compose

= Administration =

At the moment Regina Obe (creator of the container) and Sandro Santilli are admin users, although from the web UI this seems to provide no useful settings.

For maintenance and changes, administrators can access the container directly using

ssh ldap_account@osgeo7-weblate

= Hosting your own project =

Those who want to host their own project should put in a ticket in [|SAC Ticket] to be granted project creation permissions.

Aside from general request, how you automate weblate use within your app depends on how you are hosted. The step generally includes:

1. Setting up a webhook in your project to notify weblate of changes:


 * Gitea add in webhooks section of your project: https://weblate.osgeo.org/hooks/gitea/ (you may specify filter of branches in branch config)
 * Github add in webhooks section of your project: https://weblate.osgeo.org/hooks/github/ (you may specify filter of branches in branch config)
 * GitLab add in webhooks section of your project: https://weblate.osgeo.org/hooks/gitlab/ (you may specify filter of branches in branch config)

2. You can have weblate push changes to your repo in one of two ways

Directly or via Pull requests

a) Directly Giving Weblate commit access (for direct commits) In the https://weblate.osgeo.org/settings///#vcs (replace   with your specifics) choose Git for Version Control System


 * Gitea add |weblates ssh pubkey as a deployment key in your gitea project
 * Github Invite the osgeoweblate github account to your project.
 * Gitlab TBD

or

b) via pull requests In the https://weblate.osgeo.org/settings///#vcs (replace   with your specifics) choose


 * Gitea choose Gitea Pull Request for Version Control System # currently this doesn't work
 * Github choose Github Pull Request for Version Control System - in this model weblate creates a fork of your project under https://github.com/osgeoweblate and will create pull requests against your project with that fork
 * Gitlab choose Gitlab Merge Request for Version Control System # not tested