po/README.rst

   1 ===========================
   2 Libvirt Message Translation
   3 ===========================
   4
   5 .. image:: https://translate.fedoraproject.org/widgets/libvirt/-/libvirt/multi-auto.svg
   6      :target: https://translate.fedoraproject.org/engage/libvirt/
   7      :alt: Translation status
   8
   9 Libvirt translatable messages are maintained using the GNU Gettext tools and
  10 file formats, in combination with the Fedora Weblate web service.
  11
  12 https://translate.fedoraproject.org/projects/libvirt/libvirt/
  13
  14 Source repository
  15 =================
  16
  17 The libvirt GIT repository stores the master "libvirt.pot" file, which is to be
  18 refreshed at time of feature freeze.
  19
  20 The "po" files stored in GIT have source locations removed in order to cut down
  21 on storage size, by eliminating information already present in the "pot" file.
  22 All files are stored with strings sorted in alphabetical order rather than
  23 source location order, to minimize movement of strings when source locations
  24 change.
  25
  26 The "po" files are to be EXCLUSIVELY UPDATED by merge requests sent from the
  27 Fedora Weblate service. Other contributors MUST NEVER send changes which touch
  28 the "po" file content, as that will create merge conflicts for Weblate. IOW any
  29 bug fixes to translations should be made via the Weblate application UI.
  30
  31 After the "pot" file in libvirt GIT, Weblate will automatically run "msgmerge"
  32 to update the "po" files itself and send back a merge request with the changes.
  33
  34 Translation updates made in the Weblate Web UI will be committed to its fork of
  35 the GIT repo once a day. These commits will be submitted back to the master GIT
  36 repo via merge requests. If a merge request from Weblate is already open,
  37 commits will be added to this existing merge request. Weblate will take care of
  38 rebasing whenever changes happen in Git master. In order to avoid having to do
  39 translations merges 30 times a month, merge requests from Weblate will usually
  40 be left open until feature freeze arrives. During the freeze period, they will
  41 be accepted more promptly to ensure they make it into the new release.