aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMike Macgirvin <mike@macgirvin.com>2010-09-29 18:35:21 -0700
committerMike Macgirvin <mike@macgirvin.com>2010-09-29 18:35:21 -0700
commitd2ecdd0668728b28254a062e107ae12acbd542ea (patch)
tree70e002a0658e8695d314231a8bb718b92ae4bd9e
parente25e40f1ef4e1ad703c55b13069461ee0d712eae (diff)
downloadvolse-hubzilla-d2ecdd0668728b28254a062e107ae12acbd542ea.tar.gz
volse-hubzilla-d2ecdd0668728b28254a062e107ae12acbd542ea.tar.bz2
volse-hubzilla-d2ecdd0668728b28254a062e107ae12acbd542ea.zip
doco on the utils dir and i18n
-rw-r--r--util/README26
1 files changed, 26 insertions, 0 deletions
diff --git a/util/README b/util/README
new file mode 100644
index 000000000..ee164d103
--- /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.
+
+
+
+