nalc
/
intllib
mirror of https://github.com/minetest-mods/intllib.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Use get_modpath() to check for mod existence

This commit is contained in:
ShadowNinja 2014-12-12 16:36:57 -05:00
parent 3a3da7359c
commit c4335aa3dc
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
README.txt
View File

@ -10,13 +10,13 @@ How do I use it?
In order to enable it for your mod, copy the following code snippet and paste In order to enable it for your mod, copy the following code snippet and paste
it at the beginning of your source file(s): it at the beginning of your source file(s):
-- Boilerplate to support localized strings if intllib mod is installed. -- Boilerplate to support localized strings if intllib mod is installed.
local S local S
if intllib then if minetest.get_modpath("intllib") then
S = intllib.Getter() S = intllib.Getter()
else else
S = function(s) return s end S = function(s) return s end
end end
You will also need to optionally depend on intllib, to do so add "intllib?" to You will also need to optionally depend on intllib, to do so add "intllib?" to
a empty line in your depends.txt. Also note that if intllib is not installed, a empty line in your depends.txt. Also note that if intllib is not installed,
@ -27,21 +27,21 @@ if the lib is actually installed.
Next, for each "translatable" string in your sources, use the S() function Next, for each "translatable" string in your sources, use the S() function
(defined in the snippet) to return the translated string. For example: (defined in the snippet) to return the translated string. For example:
minetest.register_node("mymod:mynode", { minetest.register_node("mymod:mynode", {
description = S("My Fabulous Node"), description = S("My Fabulous Node"),
<...> <...>
}) })
Then, you create a `locale' directory inside your mod directory, with files Then, you create a `locale' directory inside your mod directory, with files
named after the two-letter ISO Language Code of the languages you want to named after the two-letter ISO Language Code of the languages you want to
support. Here's an example for a Spanish locale file (`es.txt'): support. Here's an example for a Spanish locale file (`es.txt'):
# Lines beginning with a pound sign are comments and are effectively ignored # Lines beginning with a pound sign are comments and are effectively ignored
# by the reader. Note that comments only span until the end of the line; # by the reader. Note that comments only span until the end of the line;
# there's no support for multiline comments. # there's no support for multiline comments.
Hello, World! = Hola, Mundo! Hello, World! = Hola, Mundo!
String with\nnewlines = Cadena con\nsaltos de linea String with\nnewlines = Cadena con\nsaltos de linea
String with an \= equals sign = Cadena con un signo de \= igualdad String with an \= equals sign = Cadena con un signo de \= igualdad
Since there's currently no portable way to detect the language, this library Since there's currently no portable way to detect the language, this library
tries several alternatives, and uses the first one found: tries several alternatives, and uses the first one found:
@ -61,7 +61,7 @@ the following:
- Click OK until all dialogs are closed. - Click OK until all dialogs are closed.
Alternatively for all platforms, if you don't want to modify system settings, Alternatively for all platforms, if you don't want to modify system settings,
you may add the following line to your `minetest.conf' file: you may add the following line to your `minetest.conf' file:
language = <language code> language = <language code>
Also note that there are some problems with using accented, and in general Also note that there are some problems with using accented, and in general
non-latin characters in strings. Until a fix is found, please limit yourself non-latin characters in strings. Until a fix is found, please limit yourself