napcok/calamares
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

i18n: expand the translation-load-compare tool a little, more docs

Browse Source
This commit is contained in:
Adriaan de Groot 2020-06-12 12:56:13 +02:00
parent f218e2e9a6
commit 70f1079873
1 changed files with 42 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
lang/txload.cpp
View File

@ -1,6 +1,4 @@
/* === This file is part of Calamares - <https://github.com/calamares> === /* === This file is part of Calamares - <https://github.com/calamares> ===
*
* Copyright 2018, Adriaan de Groot <groot@kde.org>
* *
* Calamares is free software: you can redistribute it and/or modify * Calamares is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by * it under the terms of the GNU General Public License as published by
@ -14,23 +12,33 @@
* *
* You should have received a copy of the GNU General Public License * You should have received a copy of the GNU General Public License
* along with Calamares. If not, see <http://www.gnu.org/licenses/>. * along with Calamares. If not, see <http://www.gnu.org/licenses/>.
*
* SPDX-FileCopyrightText: 2018 Adriaan de Groot <groot@kde.org>
* SPDX-License-Identifier: GPL-3.0-or-later
* License-Filename: LICENSE
*/ */
/* /*
* Tool to find differences between translations (can be used to help * Tool to find differences between translations (can be used to help
* merging them into one). See usage string, below, for details. * merging them into one). See usage string, below, for details.
*
* The tool can be used when there are multiple translation files
* for a single language (e.g. Spanish) which need to be reconciled.
* Then running `txload file0.ts file1.ts ...` will produce a
* human-readable overview of what is translated and where the
* differences in translation are.
*/ */
#include <QCoreApplication> #include <QCoreApplication>
#include <QDebug> #include <QDebug>
#include <QFile> #include <QFile>
#include <QList> // #include <QList>
#include <QDomDocument> #include <QDomDocument>
static const char usage[] = "Usage: txload <master> [<subsidiary> ...]\n" static const char usage[] = "Usage: txload <origin> [<alternate> ...]\n"
"\n" "\n"
"Reads a .ts source file <master> and zero or more .ts <subsidiary>\n" "Reads a .ts source file <origin> and zero or more .ts <alternate>\n"
"files, and does a comparison between the translations. Source (English)\n" "files, and does a comparison between the translations. Source (English)\n"
"strings that are untranslated are flagged in each of the translation\n" "strings that are untranslated are flagged in each of the translation\n"
"files, while differences in the translations are themselves also shown.\n" "files, while differences in the translations are themselves also shown.\n"
@ -95,34 +103,34 @@ QDomElement find_message(QDomElement& context, const QString& source)
return QDomElement(); return QDomElement();
} }
bool merge_into(QDomElement& master, QDomElement& sub) bool merge_into(QDomElement& origin, QDomElement& alternate)
{ {
QDomNode n = sub.firstChild(); QDomNode n = alternate.firstChild();
while (!n.isNull()) { while (!n.isNull()) {
if (n.isElement()) { if (n.isElement()) {
QDomElement e = n.toElement(); QDomElement alternateMessage = n.toElement();
if ( e.tagName() == "message" ) if ( alternateMessage.tagName() == "message" )
{ {
QString source = e.firstChildElement( "source" ).text(); QString alternateSourceText = alternateMessage.firstChildElement( "source" ).text();
QString translation = e.firstChildElement( "translation" ).text(); QString alternateTranslationText = alternateMessage.firstChildElement( "translation" ).text();
QDomElement masterTranslation = find_message( master, source ); QDomElement originMessage = find_message( origin, alternateSourceText );
if ( masterTranslation.isNull() ) if ( originMessage.isNull() )
{ {
qDebug() << "No master translation for" << source; qDebug() << "No origin translation for" << alternateSourceText;
return false; return false;
} }
QString msource = masterTranslation.firstChildElement( "source" ).text(); QString originSourceText = originMessage.firstChildElement( "source" ).text();
QString mtranslation = masterTranslation.firstChildElement( "translation" ).text(); QString originTranslationText = originMessage.firstChildElement( "translation" ).text();
if ( source != msource ) if ( alternateSourceText != originSourceText )
{ {
qDebug() << "Mismatch for messages\n" << source << '\n' << msource; qDebug() << "Mismatch for messages\n" << alternateSourceText << '\n' << originSourceText;
return false; return false;
} }
if ( !translation.isEmpty() && ( translation != mtranslation ) ) if ( !alternateTranslationText.isEmpty() && ( alternateTranslationText != originTranslationText ) )
{ {
qDebug() << "\n\n\nSource:" << source << "\nTL1:" << mtranslation << "\nTL2:" << translation; qDebug() << "\n\n\nSource:" << alternateSourceText << "\nTL1:" << originTranslationText << "\nTL2:" << alternateTranslationText;
} }
} }
} }
@ -134,32 +142,32 @@ bool merge_into(QDomElement& master, QDomElement& sub)
bool merge_into(QDomDocument& master, QDomElement& context) bool merge_into(QDomDocument& originDocument, QDomElement& context)
{ {
QDomElement name = context.firstChildElement( "name" ); QDomElement name = context.firstChildElement( "name" );
if ( name.isNull() ) if ( name.isNull() )
return false; return false;
QString contextname = name.text(); QString contextname = name.text();
QDomElement masterContext = find_context( master, contextname ); QDomElement originContext = find_context( originDocument, contextname );
if ( masterContext.isNull() ) if ( originContext.isNull() )
{ {
qDebug() << "Master document has no context" << contextname; qDebug() << "Origin document has no context" << contextname;
return false; return false;
} }
return merge_into( masterContext, context ); return merge_into( originContext, context );
} }
bool merge_into(QDomDocument& master, QDomDocument& sub) bool merge_into(QDomDocument& originDocument, QDomDocument& alternateDocument)
{ {
QDomElement top = sub.documentElement(); QDomElement top = alternateDocument.documentElement();
QDomNode n = top.firstChild(); QDomNode n = top.firstChild();
while (!n.isNull()) { while (!n.isNull()) {
if (n.isElement()) { if (n.isElement()) {
QDomElement e = n.toElement(); QDomElement e = n.toElement();
if ( e.tagName() == "context" ) if ( e.tagName() == "context" )
if ( !merge_into( master, e ) ) if ( !merge_into( originDocument, e ) )
return false; return false;
} }
n = n.nextSibling(); n = n.nextSibling();
@ -178,16 +186,16 @@ int main(int argc, char** argv)
return 1; return 1;
} }
QDomDocument doc("master"); QDomDocument originDocument("origin");
if ( !load_file(argv[1], doc) ) if ( !load_file(argv[1], originDocument) )
return 1; return 1;
for (int i = 2; i < argc; ++i) for (int i = 2; i < argc; ++i)
{ {
QDomDocument subdoc("sub"); QDomDocument alternateDocument("alternate");
if ( !load_file(argv[i], subdoc) ) if ( !load_file(argv[i], alternateDocument) )
return 1; return 1;
if ( !merge_into( doc, subdoc ) ) if ( !merge_into( originDocument, alternateDocument ) )
return 1; return 1;
} }
@ -200,7 +208,7 @@ int main(int argc, char** argv)
return 1; return 1;
} }
outfile.write( doc.toString(4).toUtf8() ); outfile.write( originDocument.toString(4).toUtf8() );
outfile.close(); outfile.close();
return 0; return 0;