Difference between revisions of "Windows Installer Translation"
From GnuCash
(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 | + | 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> | + | </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 | + | # 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 | ||
| − | [[ | + | |
| + | ===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.
Contents
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:
- Inno setup standard messages
- Gnucash custom messages
- 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:
- For the built-in messages of the Installer, search the section [Languages], add a line in the list 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.
[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"
- For the gnucash-specific messages in the Installer, copy&paste all lines in the [CustomMessages] section 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:
[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
;; ;;;;;;;;;;;;;;;;;;;;; ;; Catalan translation ca.FullInstall=Instal·lació completa :
- 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
- If your language is in the Official translations 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 Unofficial translations section of http://www.jrsoftware.org/files/istrans/, you can use it to start.
- You might consider to 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 README.win32-bin.txt, translate it and save it as README-<LL>.win32-bin.txt, where <LL> is your language code.
