util/README

   1 Utilities
   2
   3 typo.php  - is a crude syntax checker to avoid checking in files with simple
   4 typos. It basically just loads each of our project files at once. Run from
   5 cmdline and see if any parsing errors are reported.
   6
   7 extract.php - extracts translatable strings from our project files. It
   8 currently doesn't pick up strings in other libraries we might be using such as
   9 tinymce, simplepie, and the HTML parsers.
  10
  11 In order for extract to do its job, every use of the t() translation function
  12 must be preceded by one space. The string also can not contain parentheses. If
  13 parens are required in a string which requires translation, please use hex escapes.
  14
  15 \x28 = (
  16 \x29 = )
  17
  18
  19 strings.php - a recent run of the strings program. This provides output that
  20 is suitable for direct inclusion in the program once the app has been
  21 initialised.
  22
  23 There are also translatable strings in the various files in the view
  24 directory. By setting $lang = 'something' in .htconfig.php, the application
  25 will search for view/something/filename prior to the English version in
  26 view/filename when loading templates and view files. The translated string table
  27 should be placed in view/$lang/strings.php for automatic inclusion.
  28
  29 You are not restricted to using known languages. You may also use this to
  30 translate the software into "pirate", "surfer" or merely to replace certain
  31 text which you don't care for.
  32
  33
  34
  35
  36
  37