Merge branch 'master' into dependency-types

[git.ikiwiki.info.git] / doc / todo / l10n.mdwn

diff --git a/doc/todo/l10n.mdwn b/doc/todo/l10n.mdwn
index d5f7dbfadc5b7c09d782ea7f6cd6225d64aafdb6..a539f04246dc05a108969c98239ddb2dc8ee6d31 100644 (file)
--- a/doc/todo/l10n.mdwn
+++ b/doc/todo/l10n.mdwn
@@ -1,3 +1,21 @@
+ikiwiki should be fully internationalized.
+
+----
+
+As to the hardcoded strings in ikiwiki, I've internationalized the program,
+and there is a po/ikiwiki.pot in the source that can be translated.
+--[[Joey]]
+
+----
+
+> The now merged po plugin handles l10n of wiki pages. The only missing
+> piece now is l10n of the templates.
+> --[[Joey]]
+
+----
+
+## template i18n
+

 From [[Recai]]:
 > Here is my initial work on ikiwiki l10n infrastructure (I'm sending it
 > before finalizing, there may be errors).
 From [[Recai]]:
 > Here is my initial work on ikiwiki l10n infrastructure (I'm sending it
 > before finalizing, there may be errors).


@@ -48,52 +66,19 @@ Birisi[1], ki muhtemelen bu sizsiniz, <TMPL_VAR WIKINAME>[2] üzerindeki
 bulundu. Parola: <TMPL_VAR USER_PASSWORD> -- ikiwiki [1] Parolayı isteyen
 kullanıcının ait IP adresi: <TMPL_VAR REMOTE_ADDR>[2] <TMPL_VAR WIKIURL>
 
 bulundu. Parola: <TMPL_VAR USER_PASSWORD> -- ikiwiki [1] Parolayı isteyen
 kullanıcının ait IP adresi: <TMPL_VAR REMOTE_ADDR>[2] <TMPL_VAR WIKIURL>
 

-> Looks like, tmpl_process3 cannot preserve line breaks in template files.
-> For example, it processed the following template:
-

 This could be easily worked around in tmpl_process3, but I wouldn't like to
 maintain a separate utility.
 
 ----
 
 This could be easily worked around in tmpl_process3, but I wouldn't like to
 maintain a separate utility.
 
 ----
 

-As to the hardcoded strings in ikiwiki, I've internationalized the program,
-and there is a po/ikiwiki.pot in the source that can be translated.
---[[Joey]]
-
-----
-
-Danish l10n of templates and basewiki is available with the following commands:
-
-    git clone http://source.jones.dk/ikiwiki.git newsite
-    cd newsite
-    make
-
-Updates are retrieved with this single command:
-
-    make
-
-Right now the l10n is maintained by manually comparing against each new upstream release, and
-updating both the master mirror and the l10n as needed.
-
-Work is in progress to semi-automate this to still check manually for updates, but maintain the
-l10n as PO files - to allow more translations to more than the few languages I know about myself.
-
-As upstream ikiwiki is now maintained in GIT too, keeping the master mirror in sync with upstream
-could probably be automated even more - but an obstacle seems to be that content is not maintained
-separately but as an integral part of upstream source (GIT seems to not support subscribing to
-only parts of a repository).
-
-For example use, here's how to roll out a clone of the [Redpill support site](http://support.redpill.dk/):
-
-    mkdir -p ~/private_webdata
-    git clone http://source.redpill.dk/support.git ~/private_webdata/support.redpill.dk
-    cd ~/private_webdata/support.redpill.dk
-    make
-    mkdir -p ~/public_websites/support.redpill.dk
-    mkdir -p ~/public_websites/source.redpill.dk/support_content.git/hooks
-    mkdir -p ~/public_cgi/support.redpill.dk
-    make install
+Another way to approach this would be to write a small program that outputs
+the current set of templates. Now i18n of that program is trivial,
+and it can be run once per language to generate localized templates.

 
 

-(Redpill support is inspired by <http://help.riseup.net> but needs to be reusable for several similarly configured networks)
+Then it's just a matter of installing the templates somewhere, and having
+them be used when a different language is enabled.

 
 

---[[JonasSmedegaard]]
+It would make sense to make the existing `locale` setting control which
+templates are used. But the [[plugins/po]] plugin would probably want to do
+something more, and use the actual language the page is written in.
+--[[Joey]]