Difference between revisions of "Weblate"
From GnuCash
(→Maintainer: Setup, Workflow) |
(→Workflow: details) |
||
| Line 71: | Line 71: | ||
===Workflow=== | ===Workflow=== | ||
| − | As long as Pushs of Pull Requests are not enabled, | + | As long as Pushs of Pull Requests are not enabled, get the current status of commits at https://hosted.weblate.org/projects/gnucash/#repository or do it separate for real components. |
| − | :;Tip: remote add weblate to your repo. Then you can preview pending commits | + | :;Tip: <syntaxhighlight lang="sh"> |
| + | URL=https://hosted.weblate.org/git/gnucash/gnucash/ # program and glossary | ||
| + | # or | ||
| + | URL=https://hosted.weblate.org/git/gnucash/website/ | ||
| + | # then | ||
| + | git remote add weblate $URL | ||
| + | </syntaxhighlight> to your repo. Then you can ''preview'' pending commits by: <syntaxhighlight lang="sh">git fetch weblate</syntaxhighlight> | ||
If there are pending commits | If there are pending commits | ||
| − | # rebase (you need to zoom the window to see the | + | # '''rebase''' the weblate repo(s): |
| − | # push, to create PRs; | + | #*all together: https://hosted.weblate.org/projects/gnucash/#repository |
| − | # review | + | #*or per component: https://hosted.weblate.org/projects/gnucash/gnucash/#repository … |
| − | # rebase. Now all lines should show 0. | + | #:you need to zoom the window to see the buttons; |
| + | #:''Reason'': merge conflicts would lock the repository; | ||
| + | # '''push''', to create PRs; | ||
| + | # '''review''' at github | ||
| + | #:;Note: Because not all weblate users must be github users, it would be nicer to comment on the changes at weblate. This needs more research. | ||
| + | # '''merge''' the PRs via {{BuildServer}}; | ||
| + | # '''rebase''' weblate. Now all lines should show 0. | ||
Revision as of 16:49, 29 December 2020
On 2020-12-14 https://hosted.weblate.org/projects/gnucash was created.
- Status
- consider it still as experimental.
The page is organized by roles.
General
Many pages @ weblate link context sensitive help by i in a circle.
Translator
- Everybody
- can add suggestions as anomymous.
- Everybody with a weblate account
- can translate and gets mentioned in the po file. In the current configuration a review is required.
- Our former language maintainers
- are asked to tell us their weblate name, to get Review rights.
Ideally no checks should fail. In some cases, the mistake is in the source string. Then please report them by a comment or label.
Coder
With weblate you get feedback, where Translators have problems with your messages. Overview Program Source Messages Tasks by priority:
- label:"Source needs review"
- Multiple failing checks This is usually an indication that something could be done to improve the source string. Info
- Tip
- In both cases at the bottom select
- Comments,
- Other languages
- to get an impression of the problem.
Maintainer
Concept
Weblate is more anarchistic than our hierarchical thinking with core devs accepting or rejecting patches:
- Project settings
- Some are derived from our status as libre hosted project.
- https://hosted.weblate.org/settings/gnucash/#access is set public meaning:
- visible for all,
- every registered user can translate,
- unregistered can attach suggestions.
- To avoid chaos in https://hosted.weblate.org/settings/gnucash/#workflow
- Review is activated, ideally a Gnucash Language :Team should have at least 2 reviewers (and unlimited users), confirming each others changes.
- Component settings
- Suggestions are enabled, but Suggestion voting and Autoaccept suggestions are currently not.
- Lazy commits
- The changes in this mode are committed once any of the following conditions are fulfilled:
- Somebody else changes an already changed string.
- A merge from upstream occurs.
- An explicit commit is requested.
- Change is older than period defined as Age of changes to commit on Component configuration.
Setup
| WebLate Component | GitHub Repository/location | Notes |
|---|---|---|
| Glossary | glossary | linked project, part of Program |
| Program | gnucash | |
| Website | gnucash-htdocs |
Workflow
As long as Pushs of Pull Requests are not enabled, get the current status of commits at https://hosted.weblate.org/projects/gnucash/#repository or do it separate for real components.
- Tip
- to your repo. Then you can preview pending commits by:
URL=https://hosted.weblate.org/git/gnucash/gnucash/ # program and glossary # or URL=https://hosted.weblate.org/git/gnucash/website/ # then git remote add weblate $URL
git fetch weblate
If there are pending commits
- rebase the weblate repo(s):
- all together: https://hosted.weblate.org/projects/gnucash/#repository
- or per component: https://hosted.weblate.org/projects/gnucash/gnucash/#repository …
- you need to zoom the window to see the buttons;
- Reason: merge conflicts would lock the repository;
- push, to create PRs;
- review at github
- Note
- Because not all weblate users must be github users, it would be nicer to comment on the changes at weblate. This needs more research.
- merge the PRs via code.gnucash.org;
- rebase weblate. Now all lines should show 0.
