more thoughts on underlays

[ikiwiki.git] / doc / plugins / po.mdwn

diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 156cb6cb33ecc65605b3a1b7c08b602cdee4f6c9..f28c8b188cd1bfbf1dea53b3d5b63ce0b12c1fa3 100644 (file)
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -260,22 +260,42 @@ order, as `po_slave_languages` is a hash. It would need to be converted
 to an array to support this. (If twere done, twere best done quickly.)
 --[[Joey]] 
 
-Re-render bug
--------------
+po files in underlay
+--------------------
+
+I think this plugin doesn't yet allow po files to be present in an
+underlay to translate files also from the underlay.
+
+In `istranslatablefile`, it specifically checks that
+the file is present in srcdir. 
+
+Problem with this is that it precludes using po to translate
+the basewiki (work which is well under way for Danish BTW),
+since the translated po files cannot really be used.
 
-If .ikiwiki is deleted and a wiki is rebuilt from scratch, and
-po has created po files before, something wrong happens:
+A further problem comes if one wants to use a non-English language as the
+`po_master_language`. It would be good to get a translated
+basewiki, taking po files from the underlay and using them as the primary
+page sources, but this plugin doesn't yet support that. 
 
-> joey@gnu:~/src/ikiwiki/po/html>ls -l index*
-> -rw-r--r-- 1 joey joey 1159 Jul 19 22:51 index.html
-> 
-> index.de:
-> total 4
-> -rw-r--r-- 1 joey joey 1829 Jul 19 22:51 index.html
+And, maybe it shouldn't? A user would not expect to see a po file when
+editing the index page of their wiki, just because they're using a
+different language. Instead, we might want to build localized .mdwn files
+for the basewiki, and then ikiwiki would just use that translated underlay.
+The when the user edits index, they get a nice mdwn file to start from.
 
-index.de/index.html contains the raw po file shoved into
-page.tmpl. I have only gotten as far as guessing it is a bug in
-`_istranslation` --[[Joey]]
+So, we seem to have two cases, in one po files from the underlay should be
+used, in the other not. Hmm. Support both?
+--[[Joey]] 
+
+Duplicate %links ?
+------------------
+
+I notice code in the scan hook that seems to assume
+that %links will accumulate duplicate links for a page.
+That used to be so, but the bug was fixed. Does this mean
+that po might be replacing the only link on a page, in error? 
+--[[Joey]] 
 
 Documentation
 -------------