Files
@ ae9d205f4407
Branch filter:
Location: kallithea/scripts/i18n - annotation
ae9d205f4407
1.7 KiB
text/plain
scripts/i18n: add command 'normalize-po-files'
The translation files in the Kallithea repository contained references to
the location(s) of each string in the repository. This is useful to
translators, but is not needed for all other users.
The big problem with that information is that it changes very commonly as a
result of normal development in Kallithea, causing a lot of unimportant
delta in the Kallithea repository, thus causing unnecessary repository
growth.
In this commit, a basic version of the script is added, only containing the
code to normalize the translation files by removing generated and outdated
data.
This can be used to check or ensure internal consistency between code and
translations, by extracting and merging and then removing most of it again with
normalize-po-files:
./setup.py extract_messages
for po in kallithea/i18n/*/LC_MESSAGES/kallithea.po; do msgmerge --width=76 --backup=none --previous --update $po kallithea/i18n/kallithea.pot ; done
scripts/i18n normalize-po-files kallithea/i18n/kallithea.pot kallithea/i18n/*/LC_MESSAGES/kallithea.po
Includes contributions from Mads Kiilerich.
The translation files in the Kallithea repository contained references to
the location(s) of each string in the repository. This is useful to
translators, but is not needed for all other users.
The big problem with that information is that it changes very commonly as a
result of normal development in Kallithea, causing a lot of unimportant
delta in the Kallithea repository, thus causing unnecessary repository
growth.
In this commit, a basic version of the script is added, only containing the
code to normalize the translation files by removing generated and outdated
data.
This can be used to check or ensure internal consistency between code and
translations, by extracting and merging and then removing most of it again with
normalize-po-files:
./setup.py extract_messages
for po in kallithea/i18n/*/LC_MESSAGES/kallithea.po; do msgmerge --width=76 --backup=none --previous --update $po kallithea/i18n/kallithea.pot ; done
scripts/i18n normalize-po-files kallithea/i18n/kallithea.pot kallithea/i18n/*/LC_MESSAGES/kallithea.po
Includes contributions from Mads Kiilerich.
4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 4bc712f1ec93 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 ae9d205f4407 4bc712f1ec93 4bc712f1ec93 | #!/usr/bin/env python3
# -*- coding: utf-8 -*-
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
import click
import i18n_utils
"""
Tool for maintenance of .po and .pot files
Normally, the i18n-related files contain for each translatable string a
reference to all the source code locations where this string is found. This
meta data is useful for translators to assess how strings are used, but is not
relevant for normal development nor for running Kallithea. Such meta data, or
derived data like kallithea.pot, will inherently be outdated, and create
unnecessary churn and repository growth, making it harder to spot actual and
important changes.
"""
@click.group()
@click.option('--debug/--no-debug', default=False)
def cli(debug):
if (debug):
i18n_utils.do_debug = True
pass
@cli.command()
@click.argument('po_files', nargs=-1)
def normalize_po_files(po_files):
"""Normalize the specified .po and .pot files.
Only actual translations and essential headers will be preserved.
"""
for po_file in po_files:
i18n_utils._normalize_po_file(po_file, strip=True)
if __name__ == '__main__':
cli()
|