mirror of
https://github.com/Cockatrice/Cockatrice.git
synced 2026-09-27 08:24:39 -07:00
8bb2337117
Localization wiring now runs end to end: the oracle importer collects
foreignData for the configured language and the client renders it.
- [Oracle] Import localized names and rules texts for the selected cardLang
- single-face cards store their foreignData name and full text
- multi-face (split/adventure/aftermath/prepare) cards collect the joined
name once and join each face's translated text with the same separator
as the English merge; an incomplete translation falls back to English;
the joined text follows the same highest-priority-set policy as the
single-face path and is only collected when localization is enabled
- the wizard switching languages re-imports the card database
- [Client] Display localized card info throughout the client
- card info text/picture widgets and the game board re-render on language
change
- pictures resolve cardLang art through Scryfall's named endpoint using the
localized name, falling back to id-based art when no match exists
- deck editor keeps canonical English names as card identity (EditRole)
while showing localized names (DisplayRole), so decks and wire names
stay stable
- [Card] Add CardLocalization-backed name/text lookup and cards.xml v4
localization elements with a bounded-size translation cache
- [Tests] Cover oracle foreignData import (incl. multi-face joins, priority
and fallback paths), XML v4 localization parsing, deck model localized
display and the language-aware settings default
Existing installations need to re-run Oracle to see translations: localized
data only lands in cards.xml when the Oracle app is started with the
preferred language selected — launch the separate "Oracle" program that
ships with Cockatrice, pick the language in the wizard and let it re-import
the card database.
The client's database cache (cards.xml.cache) is invalidated by the cache
format bump and the source-hash checks, but a cache written before the
re-import can still hold English-only entries (the hash uses file size and
mtime, so a same-size/same-timestamp rewrite may be served as-is); delete
cards.xml.cache and relaunch if no localized names/texts show up after
re-importing.
40 lines
No EOL
1.2 KiB
C++
40 lines
No EOL
1.2 KiB
C++
#ifndef CARD_LOCALIZATION_H
|
|
#define CARD_LOCALIZATION_H
|
|
|
|
#include <QString>
|
|
#include <QStringList>
|
|
|
|
/**
|
|
* @namespace CardLocalization
|
|
* @ingroup Cards
|
|
*
|
|
* @brief Shared language metadata for localized card text and images.
|
|
*
|
|
* Lists the language codes Cockatrice can display localized card data for and
|
|
* provides human-readable names. The list is shared between Oracle (which
|
|
* imports the selected language's card data) and the client settings UI (which
|
|
* offers the language choice).
|
|
*/
|
|
namespace CardLocalization
|
|
{
|
|
/**
|
|
* @brief Language codes for which localized card data can be imported/displayed.
|
|
*
|
|
* Matches the languages Scryfall can serve localized card images for. "en" is
|
|
* always available as the default/fallback and is not listed here.
|
|
*
|
|
* @return The list of supported language codes.
|
|
*/
|
|
[[nodiscard]] const QStringList &supportedLanguages();
|
|
|
|
/**
|
|
* @brief Human-readable native name for a language code.
|
|
*
|
|
* @param lang Language code (e.g. "de", "ja", "zhs").
|
|
* @return The language's name in its own language, or the code itself if
|
|
* it cannot be resolved.
|
|
*/
|
|
[[nodiscard]] QString languageDisplayName(const QString &lang);
|
|
} // namespace CardLocalization
|
|
|
|
#endif // CARD_LOCALIZATION_H
|