Dark mode

doc/file/format.txt

@@ -33,13 +33,16 @@ 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.
+
+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.
+
+If the file to be included can vary depending on if dark mode is selected, use:
+>>>include dark file: <em>filename</em>
+MSE will take the filename and add "_dark" if the app is currently in dark mode. If not, then nothing is added to the filename.
 
 --Example--
 For example, a [[type:set]] might look like this:

doc/function/get_mse_dark_mode.txt

@@ -0,0 +1,6 @@
+Function: get_mse_dark_mode
+
+--Usage--
+> get_mse_dark_mode()
+
+Returns true if the app is currently displayed in dark mode, false if in light mode.

doc/function/index.txt

@@ -125,6 +125,7 @@ These functions are built into the program, other [[type:function]]s can be defi
 | [[fun:get_mse_version]]			Get the MSE app version.
 | [[fun:get_mse_locale]]			Get the name of the currently selected locale.
 | [[fun:get_mse_path]]			Get the MSE app folder absolute path.
+| [[fun:get_mse_dark_mode]]			Check if the app is displayed in dark mode or light mode.
 | [[fun:trace]]			Output a message for debugging purposes.
 | [[fun:assert]]		Check a condition for debugging purposes.
 | [[fun:warning]]		Output a warning message.