From b33fdd4856959ee18d5ef8618038afd11e76e79c Mon Sep 17 00:00:00 2001
From: GenevensiS <66968533+G-e-n-e-v-e-n-s-i-S@users.noreply.github.com>
Date: Tue, 11 Mar 2025 02:27:03 +0100
Subject: [PATCH] add include localized file token

---
 doc/file/format.txt                                 |  7 +++++++
 src/script/parser.cpp                               | 13 ++++++++++++-
 src/util/io/reader.cpp                              |  5 +++++
 src/util/io/reader.hpp                              |  7 +++++--
 .../website/drupal/mse-drupal-modules/highlight.inc |  2 ++
 5 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/doc/file/format.txt b/doc/file/format.txt
index 27354b06..d4ab464b 100644
--- a/doc/file/format.txt
+++ b/doc/file/format.txt
@@ -33,6 +33,13 @@ A heirachical file can contain a reference to another file:
 Where filename must be an absolute or relative [[type:filename]].
 
 That file is included literally into the current one; except for indentation, the included file never escapes from the level the 'include file' line is on.
+
+If the file to be included can vary depending on the locale that is selected, use:
+>>>include localized file: <em>filename</em>
+
+MSE will take the filename and add "_" followed by the name of the currently selected locale at the end of it.
+So for example, if the locale used is the folder "en.mse-locale", the file that will be included is "filename_en"
+You must provide a version of the file for each locale found in the data folder, even if it is simply a copy of the english one.
 
 --Example--
 For example, a [[type:set]] might look like this:
diff --git a/src/script/parser.cpp b/src/script/parser.cpp
index b47410c3..3d133b28 100644
--- a/src/script/parser.cpp
+++ b/src/script/parser.cpp
@@ -181,7 +181,18 @@ void TokenIterator::readToken() {
     newline = true;
   } else if (isSpace(c)) {
     ++pos;
-    // ignore
+    // ignore
+  } else if (is_substr(pos, end, "include localized file:")) {
+    pos += 23; // "include localized file:"
+    const char* newlines = "\r\n";
+    auto eol = find_first_of(pos, end, newlines, newlines + 2);
+    String include_file = trim(StringView(pos, eol)) + _("_") + settings.locale;
+    // include_file("filename_en")
+    addToken(TOK_NAME, "include_file", pos - 23);
+    addToken(TOK_LPAREN, "(", pos);
+    addToken(TOK_STRING, include_file, pos);
+    addToken(TOK_RPAREN, ")", eol);
+    pos = eol;
   } else if (is_substr(pos, end, "include file:")) {
     pos += 13; // "include file:"
     const char* newlines = "\r\n";
diff --git a/src/util/io/reader.cpp b/src/util/io/reader.cpp
index a641c5f9..786852dc 100644
--- a/src/util/io/reader.cpp
+++ b/src/util/io/reader.cpp
@@ -12,6 +12,7 @@
 #include <util/error.hpp>
 #include <util/io/package_manager.hpp>
 #include <boost/logic/tribool.hpp>
+#include <data/settings.hpp>
 #undef small
 using boost::tribool;
 
@@ -356,6 +357,10 @@ template <> void Reader::handle(Vector2D& vec) {
 template <> void Reader::handle(LocalFileName& f) {
   f = LocalFileName::fromReadString(this->getValue());
 }
+
+String Reader::addLocale(String filename) {
+  return filename + _("_") + settings.locale;
+}
 
 // ----------------------------------------------------------------------------- : EnumReader
 
diff --git a/src/util/io/reader.hpp b/src/util/io/reader.hpp
index d3482254..51e0876e 100644
--- a/src/util/io/reader.hpp
+++ b/src/util/io/reader.hpp
@@ -116,7 +116,9 @@ public:
   
   /// The package being read from
   inline Packaged* getPackage() const { return package; }
-  
+  
+  String addLocale(String);
+
 private:
   // --------------------------------------------------- : Data
   /// App version this file was made with
@@ -175,7 +177,8 @@ private:
   /** Maybe the key is "include file" */
   template <typename T>
   void unknownKey(T& v) {
-    if (key == _("include_file")) {
+    if (key == _("include_file") || key == _("include_localized_file")) {
+      value = key == _("include_localized_file") ? addLocale(value) : value;
       auto [stream, include_package] = openFileFromPackage(package, value);
       Reader sub_reader(*stream, include_package, value, ignore_invalid);
       if (sub_reader.file_app_version == 0) {
diff --git a/tools/website/drupal/mse-drupal-modules/highlight.inc b/tools/website/drupal/mse-drupal-modules/highlight.inc
index 2c9f908d..2e263d04 100644
--- a/tools/website/drupal/mse-drupal-modules/highlight.inc
+++ b/tools/website/drupal/mse-drupal-modules/highlight.inc
@@ -174,6 +174,8 @@ function highlight_script($code) {
 			      . "<span class='hl-num'>" . $matches[4] . "</span>)</span>";
 		} else if (preg_match("@^(if|then|else|for( each)?|in(?= )|do|div|mod|and|or|xor|not|rgb|rgba|from|to|min|max)\b(?!:)@",$code, $matches)) {
 			$ret .= "<span class='hl-kw'>" . $matches[0] . "</span>";
+		} else if (preg_match("@^(include localized file:)(.*)@",$code, $matches)) {
+			$ret .= "<span class='hl-key'>" . $matches[1] . "</span>" . $matches[2];
 		} else if (preg_match("@^(include file:)(.*)@",$code, $matches)) {
 			$ret .= "<span class='hl-key'>" . $matches[1] . "</span>" . $matches[2];
 		} else if (preg_match("@^([0-9][0-9.]*|true|false)@",$code, $matches)) {