The Language Pack Concept

From eXo Wiki
Revision as of 01:50, 8 November 2021 by Timber (talk | contribs) (Created page with "== Technical Specs == === Core concepts overview === Language Packs are “add-ins”. They need eXoDOS lite or full installed. Yet they are designed to be as separate as...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Technical Specs

Core concepts overview

Language Packs are “add-ins”. They need eXoDOS lite or full installed. Yet they are designed to be as separate as possible to avoid conflicts, overwrites and complicated merges that require parsing and validating existing data, at the cost of some potential data duplication.

  • Each language is a separate pack. Users can install several as they do not overlap.
  • Each language pack has its own release schedule, asynchronous from eXoDOS or other

language packs.

  • Each language pack includes its own XML that its installer will merge in eXoDOS’ “MS-

DOS.xml” leveraging the existing “merge.bat” util.

  • For games already existing in eXoDOS as English version, a new entry is added as a LB

“AdditionalApplication” which lets users launch the localized game from right-click in LB.

  • For games that do not exist, a new game entry is appended to MS-DOS.xml
  • Multilanguage games (that may or may not exist in eXoDOS already) get their own

standalone preconfigured entry, which implies duplication of sources.

  • This document uses the French language as an example, all other languages follow the same

concept.

Structure

As separate add-ins, language pack files are stored in their own folder structure that plugs to eXoDOS.

X:\eXoDOS\xml\french

  • Contains the LB platform XML files (“french.xml” and “frenchfamily.xml”) that will be

merged into MS-DOS.xml in the same folder by the language pack setup.

X:\eXoDOS\eXo\eXoDOS\!french

  • Contains all localized game zips and is the destination for installed games
  • Functional equivalent of “X:\eXoDOS\eXo\eXoDOS” for regular eXoDOS

X:\eXoDOS\eXo\eXoDOS\!dos\!french

  • Contains individual game folders that include localized install batch, game launch batch,

dosbox.conf

  • Each game folders contain an “Extras” subfolder for localized manual and other documents

as well as a localized Alternate Launcher.bat

  • Functional equivalent of “X:\eXoDOS\eXo\eXoDOS\!dos” for regular eXoDOS

X:\eXoDOS\Images\MS-DOS\<image type>\France

  • Localized game images should be stored in a regional subfolder for easier packing.

LaunchBox already has pre-configured folders such as France and Germany. A new folder should be created if necessary.

After discussion with eXo, this requires a little more work as it is probable LB just loads images based on its “region” settings. Open question is: are multiple regions supported for a single game, and if yes, will it fetch images in all region folders? This is a problem for existing games mainly, as new games (=not existing in eXoDOS) will be added with the proper region.

X:\eXoDOS\eXo\dosbox

  • Contains a localized config.bat file (renamed to config_FR.bat for French), for global DOSBox

settings management

X:\eXoDOS\eXo\LanguagePacks\french (YET TO BE DEFINED – Placeholder)

  • Contains setup batch + other necessary files for language packs setup and management.

My suggestion would be to include localized setup batches in every language pack in their own folder, then instruct users to extract the language pack over their existing eXoDOS installation, then browse to “LanguagePacks\French” and run setup_FR.bat there, for example. This way in the case of several language packs installed, the setup files do not overwrite each other in a different language, and we do not have to worry about asking the user what languages he wants the setup in. The language of the setup is always in the language of the pack it belongs to. Yet if it finds several language XML’s, it installs all of them (see §3.2)

Setup and update

The full setup mechanism is still to be precisely defined at this stage.

Existing base concepts:

  • §2.1: Extraction of the xml files to the xml folder
  • §2.2: Extraction of all localized game zips to the localized game folder
  • §2.3: Extraction of all game files and extras to the localized “!dos” folder
  • §2.4: Extraction of all pictures to the region-specific images folders
  • §2.5: Extraction of the localized config batch file

XML Merging:

  • Merge.bat parses all xml files in the xml folder and identifies installed language pack(s)
  • Asks the user if he wants adult games or not to select the proper source XML from the

language pack(s) and the proper destination XML from the base eXoDOS install

  • Merges the appropriate language pack(s) xml files into the chosen base xml.
    • Adult games included: merges french.xml (+other installed language packs) into base

MS-DOS.xml, copy to X:\eXoDOS\Data\Platforms

    • Adult games excluded: merges frenchfamily.xml (+other installed language packs)

into dosfamily.xml and copy to X:\eXoDOS\Data\Platforms as MS-DOS.xml This implies every time a language pack is installed (be it for the first time or for an update), it creates a new clean MS-DOS.xml, overwriting potential manual changes.

Bat files localization

Game install and launch bat files need to have their “echo” instructions localized for a better user experience. A template of files is created for each language. The download on demand mechanism is stripped out, as language packs will only be released as full packages (no “lite” releases). To support foreign languages accents and special characters, the codepage of batch files needs to be changed to Unicode (UTF-8). This is done by adding these lines to the beginning of batch files to call a codepage change to 65001 (ref: https://docs.microsoft.com/en- us/windows/win32/intl/code-page-identifiers)

The files that need translation are:

  • Install.bat (in every “!dos\!french\” game folder)
  • Gamename (year).bat (in every “!dos\!french\” game folder)
  • Alternate Launcher.bat (in every game folder “Extras” subfolder)
  • Config.bat (only once in “eXo\Dosbox”, renamed to config_fr.bat)

Games packaging and localized names

Games are packaged in the same format as other eXoDOS games: GameName (year).zip When an official localized name exists for a game, this should be used instead of the English name.

LaunchBox integration

Three additional applications need to be merged into existing games, with the language as prefix to sort them out properly:

  • Standard game
  • Alternate Launcher (pixel perfect & shader options)
  • Open Extras folder (for localized manuals and docs)

Example for Space Quest IV French:

“Open Folder.bat” is a simple batch: “explorer.exe .” that opens explorer from the folder the batches is run from. These new entries should also be localized themselves for consistency. How it looks in the contextual menu:

What about new games that do not exist yet in eXoDOS? We just merge a full game entry in the french.xml instead of an additional application? Unlikely scenario – what happens if two language packs both insert the same game that doesn’t exist in eXoDOS (ie, a game that would only exist in French and German but not English). Borderline, I know...

Language Playlists

To be defined... Timber? :D

Retrieved from "https://wiki.retro-exo.com/index.php?title=The_Language_Pack_Concept&oldid=358"