X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/b62dc0a3d8a82460ee43fa34a65403b75530b38b..eeeda1295f08337f1321860d2b839732a46786e4:/doc/plugins/po.mdwn?ds=sidebyside diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn index 98526a55a..8e87e2638 100644 --- a/doc/plugins/po.mdwn +++ b/doc/plugins/po.mdwn @@ -250,6 +250,57 @@ once [[intrigeri]]'s `meta` branch is merged. An integration branch, called `meta-po`, merges [[intrigeri]]'s `po` and `meta` branches, and thus has thise additional features. + +Language display order +---------------------- + +Jonas pointed out that one might want to control the order that links to +other languages are listed, for various reasons. Currently, there is no +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]] + +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. + +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. + +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. + +So, we seem to have two cases, in one po files from the underlay should be +used, in the other not. Hmm. Support both? + +> Update -- I've written po2wiki, which can spit out translated underlays +> in markdown format, and made the po plugin enable use of such underlays +> when the master language is not `en`. +--[[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 -------------