3,185 bytes added
, 10:39, 19 August 2023
== Hostnames ==
* https://weblate.sugarlabs.org/
== Hosted on ==
[[Machine/weblate]]
== Administrative contact ==
* admin AT weblate DOT sugarlabs DOT org
== Sysadmins ==
For non-emergency calls, preferably send email to the administrative contact.
* [[User:Chimosky|Chihurumnaya Ibiam]] has assumed maintainership tasks.
* [[User:Bernie|Bernie Innocenti]] has system admin privs, but takes care only of OS-level administration.
* [[User:MrBIOS|Alex Perez]]
== Notes ==
{| class="wikitable"
|-
!scope="row" | User
|{{Code|weblate}}
|-
|-
!scope="row" | Home
|{{Code|/home/weblate/weblate-docker}}
|-
!scope="row" | Daemon
|
{{Code|/etc/init.d/nginx}}<br>
{{Code|/etc/init.d/docker}}
|-
!scope="row" | Logs
|
{{Code|/var/log/nginx}}<br>
{{Code|docker logs weblate-docker-weblate-1}}<br>
|-
!scope="row" | Config
|
{{Code|/etc/nginx/sites-enabled/weblate}}<br>
{{Code|/home/weblate/weblate-docker/docker-compose.yml}}<br>
|-
!scope="row" | Ports
|
{{Code|443}} HTTP server<br>
{{Code|8080}} weblate docker container port<br>
|-
!scope="row" | Volumes
|
{{Code|/var/lib/docker/volumes/weblate-docker_postgres-data}}<br>
{{Code|/var/lib/docker/volumes/weblate-docker_redis-data}}<br>
{{Code|/var/lib/docker/volumes/weblate-docker_weblate-cache}}<br>
{{Code|/var/lib/docker/volumes/weblate-docker_weblate-data}}<br>
|-
|}
== Upgrade Notes ==
Weblate has [https://docs.weblate.org/en/latest/admin/install/docker.html#upgrading-the-docker-container upgrade notes] on upgrading the docker container.
== Maintenance Notes ==
Weblate is maintained. (ibiam has step-up to be maint)
== Files ==
Important files and directories in the root directory, {{Code|/home/weblate/weblate-docker}}.
{{Code|'''docker-compose.yml'''}}<br>
Contains definitions for all the services and volumes used by weblate, which includes weblate, database and cache with volumes weblate-cache, weblate-data, postgres-data, redis-data.
.
{{Code|'''environment'''}}<br>
Contains environment variables used by container.
== Tips ==
=== Create new Weblate translation component ===
* Create new translation component in Weblate admin menu, ''Add new translation component'';
* Select Project, we currently have {{Code|core-sugar}} and {{Code|Sugar-Activities}}, core-sugar contains sugar core APIs.
* Set version control system to GitHub pull request.
* Set source code repository link - ssh links would be preferred -
* Set repository branch.
* Set File format gettext PO file, File mask po/*.po
* Set Repository push URL to enable autoupdate of changes to Github from weblate.
* Set Push branch to weblate-sync which would be used to create a PR.
* On Github, add hook {{Code|https://weblate.sugarlabs.org/hooks/github/}} to activity repo as it's used for automated flow of updates to weblate.
* Check license in activity repo matches Translation license selected by weblate or set to the right license.
* Add all needed langs; when adding from Github, weblate automatically adds all the PO files and you'll only need to do this if the only PO file the activity
has is the template PO file.
== References ==
https://docs.weblate.org/en/latest/admin/install/docker.html#upgrading-the-docker-container