Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update links to the agama-weblate repository #1651

Merged
merged 2 commits into from
Sep 30, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/weblate-merge-po.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ jobs:
uses: actions/checkout@v4
with:
path: agama-weblate
repository: openSUSE/agama-weblate
repository: ${{ github.repository_owner }}/agama-weblate

- name: Update PO files
working-directory: ./agama
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/weblate-merge-products-po.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ jobs:
uses: actions/checkout@v4
with:
path: agama-weblate
repository: openSUSE/agama-weblate
repository: ${{ github.repository_owner }}/agama-weblate

- name: Validate the product PO files
working-directory: ./agama-weblate
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/weblate-merge-service-po.yml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ jobs:
uses: actions/checkout@v4
with:
path: agama-weblate
repository: openSUSE/agama-weblate
repository: ${{ github.repository_owner }}/agama-weblate

- name: Validate the service PO files
working-directory: ./agama-weblate
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/weblate-update-pot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ jobs:
uses: actions/checkout@v4
with:
path: agama-weblate
repository: openSUSE/agama-weblate
repository: ${{ github.repository_owner }}/agama-weblate
token: ${{ secrets.GH_TOKEN }}

- name: Configure Git
Expand Down
14 changes: 7 additions & 7 deletions doc/i18n.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,21 +84,21 @@ The basic translation workflow looks like this:
1. The translatable texts are marked for translation in the source code, usually
with the `_()` function or something similar
2. The translatable string are collected into a POT file which is uploaded to
the staging [agama-weblate](https://github.com/openSUSE/agama-weblate) GitHub
the staging [agama-weblate](https://github.com/agama-project/agama-weblate) GitHub
repository
3. The POT file is loaded by the Weblate into the
[agama](https://l10n.opensuse.org/projects/agama/) project
4. Translators then can translate the English texts into other languages
5. Weblate pushes back the translations in the PO files back to the
[agama-weblate](https://github.com/openSUSE/agama-weblate) repository
[agama-weblate](https://github.com/agama-project/agama-weblate) repository
6. The translations in the PO files are regularly copied to the main repository
using pull requests
7. The PO files are processed during build so the translations can be used
later at runtime

## Staging Translation Repository

The special [agama-weblate](https://github.com/openSUSE/agama-weblate)
The special [agama-weblate](https://github.com/agama-project/agama-weblate)
repository works like a buffer between the Agama sources and the Weblate tool.

We do not want to spam the Weblate tool with every trivial change in the texts
Expand All @@ -114,7 +114,7 @@ of seconds.
## Synchronization

The content between the main [agama](https://github.com/openSUSE/agama) and
the translation [agama-weblate](https://github.com/openSUSE/agama-weblate)
the translation [agama-weblate](https://github.com/agama-project/agama-weblate)
GitHub repositories is synchronized automatically using the GitHub Actions.

### Uploading Translatable Texts
Expand Down Expand Up @@ -160,7 +160,7 @@ separate translation component for each Agama part (the web frontend, the D-Bus
backend and the command line interface).

For reading the translations it uses the [agama-weblate](
https://github.com/openSUSE/agama-weblate) GitHub repository, but for the source
https://github.com/agama-project/agama-weblate) GitHub repository, but for the source
code locations it uses the original [agama](https://github.com/openSUSE/agama)
repository. That means after clicking the source location link in the Weblate
you will see the correct source location in the other repository.
Expand Down Expand Up @@ -526,14 +526,14 @@ UI.
[language package](#backend-translations) is installed.
3. The text should be [extracted into the POT file](#building-pot-file)
4. The [agama.pot](
https://github.com/openSUSE/agama-weblate/blob/master/web/agama.pot) in the
https://github.com/agama-project/agama-weblate/blob/master/web/agama.pot) in the
`agama-weblate` repository is up to date, if not then run the [Weblate Update
POT](https://github.com/openSUSE/agama/actions/workflows/weblate-update-pot.yml)
Github Action manually.
5. The text is translated in the [Weblate repository](
https://l10n.opensuse.org/projects/agama/).
6. The translation is included in the respective PO file in the [agama-weblate](
https://github.com/openSUSE/agama-weblate) repository.
https://github.com/agama-project/agama-weblate) repository.
7. The PO file in the [agama](
https://github.com/openSUSE/agama/tree/master/web/po) repository is up to
date, if not the check whether there is an [open pull request](
Expand Down
4 changes: 2 additions & 2 deletions products.d/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@ This directory contains product definitions for the Agama installer.
For updating the translations use the [Agama Weblate
project](https://l10n.opensuse.org/projects/agama/agama-products/). The changes
in the Weblate are automatically saved to the
[agama-weblate](https://github.com/openSUSE/agama-weblate/products) repository
[agama-weblate](https://github.com/agama-project/agama-weblate/products) repository
and later a pull request with the changes is automatically created for merging
the changes here.

Alternatively you can open a pull request against the
[agama-weblate](https://github.com/openSUSE/agama-weblate/products) GitHub
[agama-weblate](https://github.com/agama-project/agama-weblate/products) GitHub
repository. But that requires manual approving and merging, prefer using the
Weblate tool, it merges automatically.
4 changes: 2 additions & 2 deletions web/po/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ installer. See more details in the main [i18n](../../doc/i18n.md) documentation.

:warning: *WARNING: Do not manually change any files here! The files are
automatically overwritten by the files from the
[agama-weblate](https://github.com/openSUSE/agama-weblate/tree/master/web) Git
[agama-weblate](https://github.com/agama-project/agama-weblate/tree/master/web) Git
repository! Your changes would be lost on the next synchronization!* :warning:

For updating the translations use the [Agama Weblate
Expand All @@ -17,6 +17,6 @@ and later a pull request with the changes is automatically created for merging
the changes here.

Alternatively you can open a pull request against the
[agama-weblate](https://github.com/openSUSE/agama-weblate/web) GitHub
[agama-weblate](https://github.com/agama-project/agama-weblate/web) GitHub
repository. But that requires manual approving and merging, prefer using the
Weblate tool, it merges automatically.