summaryrefslogtreecommitdiff
path: root/docs/data_spec.org
diff options
context:
space:
mode:
authorAdrien Hopkins <adrien.p.hopkins@gmail.com>2025-06-15 19:42:01 -0500
committerAdrien Hopkins <adrien.p.hopkins@gmail.com>2025-06-15 19:42:01 -0500
commit2fdbc084fd1d78f0b7633db34460b1195de264f3 (patch)
tree4c908950d9b049394f8160b8159b498aec586ecc /docs/data_spec.org
parented53492243ecad8d975401a97f5b634328ad2c71 (diff)
parentbccb5b5e3452421c81c1fb58f83391ba6584807c (diff)
Merge release 1.0.0 into stable branchHEADstable
See the tag 'v1.0.0' or the changelog for more information about this release.
Diffstat (limited to 'docs/data_spec.org')
-rw-r--r--docs/data_spec.org8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/data_spec.org b/docs/data_spec.org
index c75eaa7..d251230 100644
--- a/docs/data_spec.org
+++ b/docs/data_spec.org
@@ -1,6 +1,6 @@
#+TITLE: 7Units Datafile Specification
-#+SUBTITLE: For Version 0.5.0
-#+DATE: 2024 March 23
+#+SUBTITLE: For Version 1.0.0
+#+DATE: 2025 June 1
#+LaTeX_HEADER: \usepackage[a4paper, lmargin=25mm, rmargin=25mm, tmargin=25mm, bmargin=25mm]{geometry}
#+LaTeX: \newpage
@@ -35,5 +35,9 @@ If a line's name part ends in the ASCII dash (~-~, 0x2D), it defines a prefix in
Dimension files give names to unit dimensions, so they can be selected in the unit converter to determine which units are shown. Dimension files are similar to unit and prefix files, except that they use a different set of base /dimensions/ (defined with ! as usual), and that addition and subtraction are not supported in dimension expressions.
* Metric Exception Files
Metric exception files list exceptions to the One-Way Conversion rule. Units included in these files are always shown on both sides of the unit converter, even if One Way Conversion is enabled. They are just a list of units, one per line. Ignored lines and comments work the same way as in other data files.
+* Locale Files
+A locale file contains the data to translate 7Units into another language. Each line is in the form ~key=value~. A sample locale file, with all available keys, can be found in ~src/resources/locales/en.txt~.
+
+To translate 7Units, simply create another locale file in the ~locales~ subdirectory of your 7Units configuration directory.
* Configuration Files
A configuration file contains one line for each configuration setting, in the format ~key=value~. Check the user manual for the list of configurable setting keys. Ignored lines and comments work the same way as in other data files.