Project basic internationalization support

novelWriter.pro

@@ -0,0 +1,36 @@
+SOURCES += nw/error.py \
+           nw/constants/constants.py \
+           nw/constants/iso.py \
+           nw/core/document.py \
+           nw/core/index.py \
+           nw/core/project.py \
+           nw/core/tohtml.py \
+           nw/core/tokenizer.py \
+           nw/core/tree.py \
+           nw/guimain.py \
+           nw/gui/about.py \
+           nw/gui/build.py \
+           nw/gui/custom.py \
+           nw/gui/doceditor.py \
+           nw/gui/dochighlight.py \
+           nw/gui/docmerge.py \
+           nw/gui/docsplit.py \
+           nw/gui/docviewer.py \
+           nw/gui/itemdetails.py \
+           nw/gui/itemeditor.py \
+           nw/gui/mainmenu.py \
+           nw/gui/noveltree.py \
+           nw/gui/outlinedetails.py \
+           nw/gui/outline.py \
+           nw/gui/preferences.py \
+           nw/gui/projdetails.py \
+           nw/gui/projload.py \
+           nw/gui/projsettings.py \
+           nw/gui/projtree.py \
+           nw/gui/projwizard.py \
+           nw/gui/statusbar.py \
+           nw/gui/theme.py \
+           nw/gui/wordlist.py \
+           nw/gui/writingstats.py
+
+TRANSLATIONS += i18n/nw_pt.ts

nw/__init__.py

@@ -285,6 +285,7 @@ def main(sysArgs=None):
         sys.excepthook = exceptionHandler
 
         # Launch main GUI
+        CONFIG.initLocalisation(nwApp)
         nwGUI = GuiMain()
         if not nwGUI.hasProject:
             nwGUI.showProjectLoadDialog()

nw/config.py

@@ -34,7 +34,10 @@
 from time import time
 
 from PyQt5.Qt import PYQT_VERSION_STR
-from PyQt5.QtCore import QT_VERSION_STR, QStandardPaths, QSysInfo
+from PyQt5.QtCore import (
+    QT_VERSION_STR, QStandardPaths, QSysInfo, QLocale, QLibraryInfo,
+    QTranslator
+)
 
 from nw.constants import nwConst, nwFiles, nwUnicode
 from nw.common import splitVersionNumber, formatTimeStamp
@@ -84,12 +87,18 @@ def __init__(self):
         self.guiSyntax   = "default_light"
         self.guiIcons    = "typicons_colour_light"
         self.guiDark     = False # Load icons for dark backgrounds, if available
-        self.guiLang     = "en"  # Hardcoded for now since the GUI is only in English
         self.guiFont     = ""    # Defaults to system default font
-        self.guiFontSize = 11
+        self.guiFontSize = 11    # Is overridden if system default is loaded
         self.guiScale    = 1.0   # Set automatically by Theme class
         self.lastNotes   = "0x0" # The latest release notes that have been shown
 
+        ## Localisation
+        self.qLocal     = QLocale.system()
+        self.guiLang    = self.qLocal.bcp47Name()
+        self.qtLangPath = QLibraryInfo.location(QLibraryInfo.TranslationsPath)
+        self.nwLangPath = None
+        self.qtTrans    = {}
+
         ## Sizes
         self.winGeometry   = [1200, 650]
         self.treeColWidth  = [200, 50, 30]
@@ -290,6 +299,9 @@ def initConfig(self, confPath=None, dataPath=None):
         self.iconPath  = os.path.join(self.assetPath, "icons")
         self.appIcon   = os.path.join(self.iconPath, "novelwriter.svg")
 
+        # Internationalisation
+        self.nwLangPath = os.path.join(self.appRoot, "i18n")
+
         logger.verbose("App path: %s" % self.appPath)
         logger.verbose("Last path: %s" % self.lastPath)
 
@@ -354,6 +366,30 @@ def initConfig(self, confPath=None, dataPath=None):
 
         return True
 
+    def initLocalisation(self, nwApp):
+        """Initialise the localisation of the GUI.
+        """
+        self.qLocal = QLocale(self.guiLang)
+        QLocale.setDefault(self.qLocal)
+        self.qtTrans = {}
+
+        langList = [
+            (self.qtLangPath, "qt"),
+            (self.qtLangPath, "qtbase"),
+            (self.nwLangPath, "nw"),
+        ]
+        for lngPath, lngBase in langList:
+            for lngCode in self.qLocal.uiLanguages():
+                qTrans = QTranslator()
+                lngFile = "%s_%s" % (lngBase, lngCode)
+                if lngFile not in self.qtTrans:
+                    if qTrans.load(lngFile, lngPath):
+                        logger.debug("Loaded: %s" % qTrans.filePath())
+                        nwApp.installTranslator(qTrans)
+                        self.qtTrans[lngFile] = qTrans
+
+        return
+
     def loadConfig(self):
         """Load preferences from file and replace default settings.
         """
@@ -397,6 +433,9 @@ def loadConfig(self):
         self.lastNotes = self._parseLine(
             cnfParse, cnfSec, "lastnotes", self.CNF_STR, self.lastNotes
         )
+        self.guiLang = self._parseLine(
+            cnfParse, cnfSec, "guilang", self.CNF_STR, self.guiLang
+        )
 
         ## Sizes
         cnfSec = "Sizes"
@@ -626,6 +665,7 @@ def saveConfig(self):
         cnfParse.set(cnfSec, "guifont",     str(self.guiFont))
         cnfParse.set(cnfSec, "guifontsize", str(self.guiFontSize))
         cnfParse.set(cnfSec, "lastnotes",   str(self.lastNotes))
+        cnfParse.set(cnfSec, "guilang",     str(self.guiLang))
 
         ## Sizes
         cnfSec = "Sizes"

nw/constants/__init__.py

@@ -1,17 +1,15 @@
 # -*- coding: utf-8 -*-
-from nw.constants.iso import isoLanguage, isoCountry
 from nw.constants.constants import (
-    nwConst, nwLists, nwRegEx, nwFiles, nwKeyWords, nwLabels, nwQuotes,
-    nwUnicode, nwHtmlUnicode
+    trConst, nwConst, nwLists, nwRegEx, nwFiles, nwKeyWords, nwLabels,
+    nwQuotes, nwUnicode, nwHtmlUnicode
 )
 from nw.constants.enum import (
     nwAlert, nwDocAction, nwItemClass, nwItemLayout, nwItemType, nwOutline,
     nwDocInsert
 )
 
 __all__ = [
-    "isoCountry",
-    "isoLanguage",
+    "trConst",
     "nwConst",
     "nwLists",
     "nwRegEx",

nw/constants/constants.py

@@ -24,10 +24,18 @@
 along with this program. If not, see <https://www.gnu.org/licenses/>.
 """
 
+from PyQt5.QtCore import QCoreApplication
+from PyQt5.QtCore import QT_TRANSLATE_NOOP as QT_TRN
+
 from nw.constants.enum import (
     nwItemClass, nwItemLayout, nwItemType, nwOutline
 )
 
+def trConst(tString):
+    """Wrapper function for locally translating constants.
+    """
+    return QCoreApplication.translate("Constant", tString)
+
 class nwConst():
 
     # Date and Time Formats
@@ -119,17 +127,17 @@ class nwKeyWords:
 class nwLabels():
 
     CLASS_NAME = {
-        nwItemClass.NO_CLASS  : "None",
-        nwItemClass.NOVEL     : "Novel",
-        nwItemClass.PLOT      : "Plot",
-        nwItemClass.CHARACTER : "Characters",
-        nwItemClass.WORLD     : "Locations",
-        nwItemClass.TIMELINE  : "Timeline",
-        nwItemClass.OBJECT    : "Objects",
-        nwItemClass.ENTITY    : "Entity",
-        nwItemClass.CUSTOM    : "Custom",
-        nwItemClass.ARCHIVE   : "Outtakes",
-        nwItemClass.TRASH     : "Trash",
+        nwItemClass.NO_CLASS  : QT_TRN("Constant", "None"),
+        nwItemClass.NOVEL     : QT_TRN("Constant", "Novel"),
+        nwItemClass.PLOT      : QT_TRN("Constant", "Plot"),
+        nwItemClass.CHARACTER : QT_TRN("Constant", "Characters"),
+        nwItemClass.WORLD     : QT_TRN("Constant", "Locations"),
+        nwItemClass.TIMELINE  : QT_TRN("Constant", "Timeline"),
+        nwItemClass.OBJECT    : QT_TRN("Constant", "Objects"),
+        nwItemClass.ENTITY    : QT_TRN("Constant", "Entity"),
+        nwItemClass.CUSTOM    : QT_TRN("Constant", "Custom"),
+        nwItemClass.ARCHIVE   : QT_TRN("Constant", "Outtakes"),
+        nwItemClass.TRASH     : QT_TRN("Constant", "Trash"),
     }
     CLASS_FLAG = {
         nwItemClass.NO_CLASS  : "0",
@@ -158,15 +166,15 @@ class nwLabels():
         nwItemClass.TRASH     : "cls_trash",
     }
     LAYOUT_NAME = {
-        nwItemLayout.NO_LAYOUT  : "None",
-        nwItemLayout.TITLE      : "Title Page",
-        nwItemLayout.BOOK       : "Book",
-        nwItemLayout.PAGE       : "Plain Page",
-        nwItemLayout.PARTITION  : "Partition",
-        nwItemLayout.UNNUMBERED : "Unnumbered",
-        nwItemLayout.CHAPTER    : "Chapter",
-        nwItemLayout.SCENE      : "Scene",
-        nwItemLayout.NOTE       : "Note",
+        nwItemLayout.NO_LAYOUT  : QT_TRN("Constant", "None"),
+        nwItemLayout.TITLE      : QT_TRN("Constant", "Title Page"),
+        nwItemLayout.BOOK       : QT_TRN("Constant", "Book"),
+        nwItemLayout.PAGE       : QT_TRN("Constant", "Plain Page"),
+        nwItemLayout.PARTITION  : QT_TRN("Constant", "Partition"),
+        nwItemLayout.UNNUMBERED : QT_TRN("Constant", "Unnumbered"),
+        nwItemLayout.CHAPTER    : QT_TRN("Constant", "Chapter"),
+        nwItemLayout.SCENE      : QT_TRN("Constant", "Scene"),
+        nwItemLayout.NOTE       : QT_TRN("Constant", "Note"),
     }
     LAYOUT_FLAG = {
         nwItemLayout.NO_LAYOUT  : "Xo",
@@ -180,35 +188,35 @@ class nwLabels():
         nwItemLayout.NOTE       : "Nt",
     }
     KEY_NAME = {
-        nwKeyWords.TAG_KEY    : "Tag",
-        nwKeyWords.POV_KEY    : "Point of View",
-        nwKeyWords.FOCUS_KEY  : "Focus",
-        nwKeyWords.CHAR_KEY   : "Characters",
-        nwKeyWords.PLOT_KEY   : "Plot",
-        nwKeyWords.TIME_KEY   : "Timeline",
-        nwKeyWords.WORLD_KEY  : "Locations",
-        nwKeyWords.OBJECT_KEY : "Objects",
-        nwKeyWords.ENTITY_KEY : "Entities",
-        nwKeyWords.CUSTOM_KEY : "Custom",
+        nwKeyWords.TAG_KEY    : QT_TRN("Constant", "Tag"),
+        nwKeyWords.POV_KEY    : QT_TRN("Constant", "Point of View"),
+        nwKeyWords.FOCUS_KEY  : QT_TRN("Constant", "Focus"),
+        nwKeyWords.CHAR_KEY   : QT_TRN("Constant", "Characters"),
+        nwKeyWords.PLOT_KEY   : QT_TRN("Constant", "Plot"),
+        nwKeyWords.TIME_KEY   : QT_TRN("Constant", "Timeline"),
+        nwKeyWords.WORLD_KEY  : QT_TRN("Constant", "Locations"),
+        nwKeyWords.OBJECT_KEY : QT_TRN("Constant", "Objects"),
+        nwKeyWords.ENTITY_KEY : QT_TRN("Constant", "Entities"),
+        nwKeyWords.CUSTOM_KEY : QT_TRN("Constant", "Custom"),
     }
     OUTLINE_COLS = {
-        nwOutline.TITLE  : "Title",
-        nwOutline.LEVEL  : "Level",
-        nwOutline.LABEL  : "Document",
-        nwOutline.LINE   : "Line",
-        nwOutline.CCOUNT : "Chars",
-        nwOutline.WCOUNT : "Words",
-        nwOutline.PCOUNT : "Pars",
-        nwOutline.POV    : "POV",
-        nwOutline.FOCUS  : "Focus",
+        nwOutline.TITLE  : QT_TRN("Constant", "Title"),
+        nwOutline.LEVEL  : QT_TRN("Constant", "Level"),
+        nwOutline.LABEL  : QT_TRN("Constant", "Document"),
+        nwOutline.LINE   : QT_TRN("Constant", "Line"),
+        nwOutline.CCOUNT : QT_TRN("Constant", "Chars"),
+        nwOutline.WCOUNT : QT_TRN("Constant", "Words"),
+        nwOutline.PCOUNT : QT_TRN("Constant", "Pars"),
+        nwOutline.POV    : QT_TRN("Constant", "POV"),
+        nwOutline.FOCUS  : QT_TRN("Constant", "Focus"),
         nwOutline.CHAR   : KEY_NAME[nwKeyWords.CHAR_KEY],
         nwOutline.PLOT   : KEY_NAME[nwKeyWords.PLOT_KEY],
         nwOutline.TIME   : KEY_NAME[nwKeyWords.TIME_KEY],
         nwOutline.WORLD  : KEY_NAME[nwKeyWords.WORLD_KEY],
         nwOutline.OBJECT : KEY_NAME[nwKeyWords.OBJECT_KEY],
         nwOutline.ENTITY : KEY_NAME[nwKeyWords.ENTITY_KEY],
         nwOutline.CUSTOM : KEY_NAME[nwKeyWords.CUSTOM_KEY],
-        nwOutline.SYNOP  : "Synopsis",
+        nwOutline.SYNOP  : QT_TRN("Constant", "Synopsis"),
     }
 
 # END Class nwLabels
@@ -218,28 +226,28 @@ class nwQuotes():
     Source: https://en.wikipedia.org/wiki/Quotation_mark
     """
     SYMBOLS = {
-        "\u0027" : "Straight single quotation mark",
-        "\u0022" : "Straight double quotation mark",
-
-        "\u2018" : "Left single quotation mark",
-        "\u2019" : "Right single quotation mark",
-        "\u201a" : "Single low-9 quotation mark",
-        "\u201b" : "Single high-reversed-9 quotation mark",
-        "\u201c" : "Left double quotation mark",
-        "\u201d" : "Right double quotation mark",
-        "\u201e" : "Double low-9 quotation mark",
-        "\u201f" : "Double high-reversed-9 quotation mark",
-        "\u2e42" : "Double low-reversed-9 quotation mark",
-
-        "\u2039" : "Single left-pointing angle quotation mark",
-        "\u203a" : "Single right-pointing angle quotation mark",
-        "\u00ab" : "Left-pointing double angle quotation mark",
-        "\u00bb" : "Right-pointing double angle quotation mark",
-
-        "\u300c" : "Left corner bracket",
-        "\u300d" : "Right corner bracket",
-        "\u300e" : "Left white corner bracket",
-        "\u300f" : "Right white corner bracket",
+        "\u0027" : QT_TRN("Constant", "Straight single quotation mark"),
+        "\u0022" : QT_TRN("Constant", "Straight double quotation mark"),
+
+        "\u2018" : QT_TRN("Constant", "Left single quotation mark"),
+        "\u2019" : QT_TRN("Constant", "Right single quotation mark"),
+        "\u201a" : QT_TRN("Constant", "Single low-9 quotation mark"),
+        "\u201b" : QT_TRN("Constant", "Single high-reversed-9 quotation mark"),
+        "\u201c" : QT_TRN("Constant", "Left double quotation mark"),
+        "\u201d" : QT_TRN("Constant", "Right double quotation mark"),
+        "\u201e" : QT_TRN("Constant", "Double low-9 quotation mark"),
+        "\u201f" : QT_TRN("Constant", "Double high-reversed-9 quotation mark"),
+        "\u2e42" : QT_TRN("Constant", "Double low-reversed-9 quotation mark"),
+
+        "\u2039" : QT_TRN("Constant", "Single left-pointing angle quotation mark"),
+        "\u203a" : QT_TRN("Constant", "Single right-pointing angle quotation mark"),
+        "\u00ab" : QT_TRN("Constant", "Left-pointing double angle quotation mark"),
+        "\u00bb" : QT_TRN("Constant", "Right-pointing double angle quotation mark"),
+
+        "\u300c" : QT_TRN("Constant", "Left corner bracket"),
+        "\u300d" : QT_TRN("Constant", "Right corner bracket"),
+        "\u300e" : QT_TRN("Constant", "Left white corner bracket"),
+        "\u300f" : QT_TRN("Constant", "Right white corner bracket"),
     }
 
 # END Class nwQuotes