Difference between revisions of "Windows Installer Translation"

From GnuCash
Jump to: navigation, search
(only one section header makes not much sense)
(Custom Messages and Settings: remove Translation#Check_doc/FREADME-*)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
This page deals with the translation of the windows installer. For the general part see [[Translation]].
 
This page deals with the translation of the windows installer. For the general part see [[Translation]].
 +
[[Category:Translation]][[Category:Windows]]
 +
 
==Intro==  
 
==Intro==  
 
The Windows specific parts of GnuCash are in a separate repository. <SyntaxHighlight lang="sh">
 
The Windows specific parts of GnuCash are in a separate repository. <SyntaxHighlight lang="sh">
 
git clone https://github.com/Gnucash/gnucash-on-windows ${SOURCEDIR}
 
git clone https://github.com/Gnucash/gnucash-on-windows ${SOURCEDIR}
cd ${SOURCEDIR}
+
cd ${SOURCEDIR}/inno_setup  # all translatable parts are in inno_setup
 
</SyntaxHighlight>
 
</SyntaxHighlight>
 +
 
==Translation==
 
==Translation==
 +
The translation of messages is split in two parts and a README file:
 +
# [[#Inno Setup Standard Messages|Inno setup standard messages]]
 +
# Gnucash [[#Custom Messages and Settings|custom messages]]
 +
#a [[#README File|README file]], which is displayed to the user in the setup process.
 +
 +
===Custom Messages and Settings===
 
All settings related to the language(s) in the installer are controlled  
 
All settings related to the language(s) in the installer are controlled  
through the file [https://github.com/Gnucash/gnucash-on-windows/blob/master/inno_setup/gnucash-mingw64.iss inno_setup/gnucash-mingw64.iss].
+
through the file [https://github.com/Gnucash/gnucash-on-windows/blob/master/inno_setup/gnucash-mingw64.iss gnucash-mingw64.iss].
  
 
In particular, the following settings will have to be added:
 
In particular, the following settings will have to be added:
Line 18: Line 27:
 
:
 
:
 
Name: "zh_TW"; MessagesFile: "@GC_WIN_REPOS_DIR@\inno_setup\ChineseTraditional-5.5.3.isl"; InfoAfterFile: "@INST_DIR@\share\doc\@PACKAGE@\README-zh_TW.win32-bin.txt"
 
Name: "zh_TW"; MessagesFile: "@GC_WIN_REPOS_DIR@\inno_setup\ChineseTraditional-5.5.3.isl"; InfoAfterFile: "@INST_DIR@\share\doc\@PACKAGE@\README-zh_TW.win32-bin.txt"
</SyntaxHighlight> Only if you created <tt>gnucash/doc/README-<ll>.win32-bin.txt</tt>, add the part in the square brackets <tt>[...]</tt>. This "README" is shown as last screen of the installer. Its creation is explained in [[Translation#Check_doc/FREADME-*]].
+
</SyntaxHighlight> Only if you created <tt>README-<ll>.win32-bin.txt</tt>, add the part in the square brackets <tt>[...]</tt>. This "README" is shown as last screen of the installer.
 
# For the gnucash-specific messages in the Installer, copy&paste all lines in the [CustomMessages] section <SyntaxHighlight lang="ini">
 
# For the gnucash-specific messages in the Installer, copy&paste all lines in the [CustomMessages] section <SyntaxHighlight lang="ini">
 
[CustomMessages]
 
[CustomMessages]
Line 57: Line 66:
 
:
 
:
 
</SyntaxHighlight>
 
</SyntaxHighlight>
# One line has to be added for the CodePage in line 262, like so: <SyntaxHighlight lang="ini">
+
# One line has to be added for the <tt>CodePage</tt> paragraph, like so: <SyntaxHighlight lang="ini">
 
;; List of Code pages, used in gnucash.cmd
 
;; List of Code pages, used in gnucash.cmd
 
LanguageCodePage=1252
 
LanguageCodePage=1252
Line 71: Line 80:
 
zh_TW.LanguageCodePage=950
 
zh_TW.LanguageCodePage=950
 
</SyntaxHighlight>
 
</SyntaxHighlight>
----
+
;Note: We prefer now <tt>LanguageCodePage=0</tt> for UTF-8.
 
;Source: https://lists.gnucash.org/pipermail/gnucash-devel/2009-January/024535.html
 
;Source: https://lists.gnucash.org/pipermail/gnucash-devel/2009-January/024535.html
[[Category:Translation]]
+
 
 +
===Inno Setup Standard Messages===
 +
* If your language is in the <tt>Official translations</tt> section of http://www.jrsoftware.org/files/istrans/ no further action is required.
 +
* Else you should submit a translation of https://raw.github.com/jrsoftware/issrc/master/Files/Default.isl to gnucash.
 +
** If there is already a file in <tt>Unofficial translations</tt> section of http://www.jrsoftware.org/files/istrans/, you can use it to start.
 +
** You might consider to [http://www.jrsoftware.org/files/istrans/send.php submit your updated and reviewed file also to Inno Setup].
 +
;Maintainers: After a file appears in the official translations of the current Inno Setup version, you can remove it from GnuCash again.
 +
 
 +
===README File===
 +
Open [https://github.com/Gnucash/gnucash-on-windows/blob/master/inno_setup/README.win32-bin.txt README.win32-bin.txt], translate it and save it as <tt>README-<LL>.win32-bin.txt</tt>, where <LL> is your language code.

Latest revision as of 21:22, 21 August 2023

This page deals with the translation of the windows installer. For the general part see Translation.

Intro

The Windows specific parts of GnuCash are in a separate repository.
git clone https://github.com/Gnucash/gnucash-on-windows ${SOURCEDIR}
cd ${SOURCEDIR}/inno_setup  # all translatable parts are in inno_setup

Translation

The translation of messages is split in two parts and a README file:

  1. Inno setup standard messages
  2. Gnucash custom messages
  3. a README file, which is displayed to the user in the setup process.

Custom Messages and Settings

All settings related to the language(s) in the installer are controlled through the file gnucash-mingw64.iss.

In particular, the following settings will have to be added:

  1. For the built-in messages of the Installer, search the section [Languages], add a line in the list
    [Languages]
    Name: "en"; MessagesFile: "compiler:Default.isl"
    Name: "ca"; MessagesFile: "compiler:Languages\Catalan.isl"; InfoAfterFile: "@INST_DIR@\share\doc\@PACKAGE@\README-ca.win32-bin.txt"
    :
    Name: "<ll>"; MessagesFile: "compiler:Languages\<Language>.isl"[; InfoAfterFile: "@INST_DIR@\share\doc\@PACKAGE@\README-<ll>.win32-bin.txt"]
    :
    Name: "zh_TW"; MessagesFile: "@GC_WIN_REPOS_DIR@\inno_setup\ChineseTraditional-5.5.3.isl"; InfoAfterFile: "@INST_DIR@\share\doc\@PACKAGE@\README-zh_TW.win32-bin.txt"
    
    Only if you created README-<ll>.win32-bin.txt, add the part in the square brackets [...]. This "README" is shown as last screen of the installer.
  2. For the gnucash-specific messages in the Installer, copy&paste all lines in the [CustomMessages] section
    [CustomMessages]
    ; *** "Select Components" wizard page
    FullInstall=Full installation
    CustomInstall=Custom installation
    CreateDesktopIcon=Create a &desktop icon
    CreateMenuLink=Create a start menu link
    RunPrg=Run GnuCash now
    AdditionalIcons=Create these icons:
    StatusMsgFirewall=Installing Windows firewall rules...
    ; *** "Another install" wizard page
    ; %1 in the following messages will be replaced with the application name and version, like "GnuCash 2.3.15"
    AIWP_Title=Another installation has been found
    AIWP_Description=%1 is currently installed on this computer
    AIWP_Message=This earlier installation has to be removed before continuing.%n%nIf you don't want that, click Cancel now to abort the current installation.%n%nClick Next to remove %1 and continue with the installation.%n%nNote: Only the program will be removed, not your financial data.
    
    MainFiles=GnuCash Program
    TranslFiles=Translation Files
    TemplFiles=Account Template Files
    
    IconComment_GnuCash=GnuCash Free Finance Manager
    IconName_README=Show GnuCash README
    IconComment_README=Show the README file
    IconFilename_README=README.win32-bin.txt
    IconName_FAQ=GnuCash FAQ (Online)
    IconName_Bugzilla=Report a GnuCash Bug (Online)
    IconName_InstallFQ=Install Online Price Retrieval for GnuCash
    IconComment_InstallFQ=Install the necessary perl module Finance-Quote for online retrieval of prices.  Requires ActivePerl or Strawberry Perl 5.8 or later
    IconName_Theme=Select GnuCash Theme
    IconName_Uninstall=Uninstall GnuCash
    IconComment_Uninstall=Uninstall the Finance Manager GnuCash
    
    similar to the other languages. For each custom message you will have to prefix the line with your language code and add your translation <ll>.<MessageName>=<Translated Message> there:
    ;; ;;;;;;;;;;;;;;;;;;;;;
    ;; Catalan translation
    
    ca.FullInstall=Instal·lació completa
    :
    
  3. One line has to be added for the CodePage paragraph, like so:
    ;; List of Code pages, used in gnucash.cmd
    LanguageCodePage=1252
    ca.LanguageCodePage=1252
    de.LanguageCodePage=1252
    el.LanguageCodePage=1253
    fr.LanguageCodePage=1252
    it.LanguageCodePage=1252
    ja.LanguageCodePage=932
    nl.LanguageCodePage=1252
    pt_BR.LanguageCodePage=1252
    zh_CN.LanguageCodePage=936
    zh_TW.LanguageCodePage=950
    
Note
We prefer now LanguageCodePage=0 for UTF-8.
Source
https://lists.gnucash.org/pipermail/gnucash-devel/2009-January/024535.html

Inno Setup Standard Messages

Maintainers
After a file appears in the official translations of the current Inno Setup version, you can remove it from GnuCash again.

README File

Open README.win32-bin.txt, translate it and save it as README-<LL>.win32-bin.txt, where <LL> is your language code.