From d2ecdd0668728b28254a062e107ae12acbd542ea Mon Sep 17 00:00:00 2001 From: Mike Macgirvin Date: Wed, 29 Sep 2010 18:35:21 -0700 Subject: [PATCH] doco on the utils dir and i18n --- util/README | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 util/README diff --git a/util/README b/util/README new file mode 100644 index 0000000000..ee164d1039 --- /dev/null +++ b/util/README @@ -0,0 +1,26 @@ +Utilities + +typo.php - is a crude syntax checker to avoid checking in files with simple +typos. It basically just loads each of our project files at once. Run from +cmdline and see if any parsing errors are reported. + +extract.php - extracts translatable strings from our project files. It +currently doesn't pick up strings in other libraries we might be using such as +tinymce, simplepie, and the HTML parsers. + +In order for extract to do its job, every use of the t() translation function +must be preceded by one space. The string also can not contain parentheses. If +parens are required in a string, please use hex escapes. + +strings.php - a recent run of the strings program. This provides output that +is suitable for direct inclusion in the program once the app has been +initialised. + +There are also translatable strings in the various files in the view +directory. By setting $lang = 'something' in .htconfig.php, the application +will search for view/something/filename prior to the English version in +view/filename when loading templates and view files. + + + +