c6eb59eb42
Add the following files: python3-flightgear/README-l10n.txt python3-flightgear/fg-convert-translation-files python3-flightgear/fg-new-translations python3-flightgear/fg-update-translation-files python3-flightgear/flightgear/__init__.py python3-flightgear/flightgear/meta/__init__.py python3-flightgear/flightgear/meta/exceptions.py python3-flightgear/flightgear/meta/i18n.py python3-flightgear/flightgear/meta/logging.py python3-flightgear/flightgear/meta/misc.py They should work on Python 3.4 and later (tested with 3.5.3). The folder structure is chosen so that other FG support modules can insert themselves here, and possibly be used together. I put all of these inside 'flightgear.meta', because I don't expect them to be needed at FG runtime (neither now nor in the future), probably not even by the CMake build system. To declare that a string has plural forms, simply set the attribute 'with-plural' to 'true' on the corresponding element of the default translation (and as in Qt, use %n as a placeholder for the number that determines which singular or plural form to use).
125 lines
4.7 KiB
Python
Executable file
125 lines
4.7 KiB
Python
Executable file
#! /usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# fg-new-translations --- Create new translations for FlightGear
|
|
# Copyright (C) 2017 Florent Rougon
|
|
#
|
|
# 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 2 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, write to the Free Software Foundation, Inc.,
|
|
# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
import argparse
|
|
import collections
|
|
import locale
|
|
import os
|
|
import sys
|
|
|
|
try:
|
|
import xml.etree.ElementTree as et
|
|
except ImportError:
|
|
import elementtree.ElementTree as et
|
|
|
|
import flightgear.meta.logging
|
|
import flightgear.meta.i18n as fg_i18n
|
|
|
|
|
|
PROGNAME = os.path.basename(sys.argv[0])
|
|
|
|
# Only messages with severity >= info will be printed to the terminal (it's
|
|
# possible to also log all messages to a file regardless of their level, see
|
|
# the Logger class). Of course, there is also the standard logging module...
|
|
logger = flightgear.meta.logging.Logger(
|
|
progname=PROGNAME,
|
|
logLevel=flightgear.meta.logging.LogLevel.info,
|
|
defaultOutputStream=sys.stderr)
|
|
|
|
|
|
def processCommandLine():
|
|
params = argparse.Namespace()
|
|
|
|
parser = argparse.ArgumentParser(
|
|
usage="""\
|
|
%(prog)s [OPTION ...] LANGUAGE_CODE...
|
|
Write the skeleton of XLIFF translation files.""",
|
|
description="""\
|
|
This program writes XLIFF translation files with the strings to translate
|
|
for the specified languages (target strings are empty). This is what you need
|
|
to start a translation for a new language.""",
|
|
formatter_class=argparse.RawDescriptionHelpFormatter,
|
|
# I want --help but not -h (it might be useful for something else)
|
|
add_help=False)
|
|
|
|
parser.add_argument("-t", "--transl-dir",
|
|
help="""\
|
|
directory containing all translation subdirs (such as
|
|
{default!r}, 'en_GB', 'fr_FR', 'de', 'it'...). This
|
|
"option" MUST be specified.""".format(
|
|
default=fg_i18n.DEFAULT_LANG_DIR))
|
|
parser.add_argument("lang_code", metavar="LANGUAGE_CODE", nargs="+",
|
|
help="""\
|
|
codes of languages to create translations for (e.g., fr,
|
|
fr_BE, en_GB, it, es_ES...)""")
|
|
parser.add_argument("-o", "--output-file",
|
|
help="""\
|
|
where to write the output to (use '-' for standard
|
|
output); if not specified, a suitable file under
|
|
TRANSL_DIR will be chosen for each LANGUAGE_CODE.
|
|
Note: this option can only be given when exactly one
|
|
LANGUAGE_CODE has been specified on the command
|
|
line (it doesn't make sense otherwise).""")
|
|
parser.add_argument("--output-format", default="xliff",
|
|
choices=fg_i18n.FORMAT_HANDLERS_NAMES,
|
|
help="format to use for the output files")
|
|
parser.add_argument("--help", action="help",
|
|
help="display this message and exit")
|
|
|
|
params = parser.parse_args(namespace=params)
|
|
|
|
if params.transl_dir is None:
|
|
logger.error("--transl-dir must be given, aborting")
|
|
sys.exit(1)
|
|
|
|
if params.output_file is not None and len(params.lang_code) > 1:
|
|
logger.error("--output-file can only be given when exactly one "
|
|
"LANGUAGE_CODE has been specified on the command line "
|
|
"(it doesn't make sense otherwise)")
|
|
sys.exit(1)
|
|
|
|
return params
|
|
|
|
|
|
def main():
|
|
global params
|
|
|
|
locale.setlocale(locale.LC_ALL, '')
|
|
params = processCommandLine()
|
|
|
|
l10nResPoolMgr = fg_i18n.L10NResourcePoolManager(params.transl_dir, logger)
|
|
xliffFormatHandler = fg_i18n.FORMAT_HANDLERS_MAP[params.output_format]()
|
|
|
|
if params.output_file is not None:
|
|
assert len(params.lang_code) == 1, params.lang_code
|
|
# Output to one file or to stdout
|
|
l10nResPoolMgr.writeSkeletonTranslation(
|
|
xliffFormatHandler, params.lang_code[0],
|
|
filePath=params.output_file)
|
|
else:
|
|
# Output to several files
|
|
for langCode in params.lang_code:
|
|
l10nResPoolMgr.writeSkeletonTranslation(xliffFormatHandler,
|
|
langCode)
|
|
|
|
sys.exit(0)
|
|
|
|
|
|
if __name__ == "__main__": main()
|