diff options
author | Joey Hess <joey@gnu.kitenet.net> | 2009-07-21 11:31:51 +0200 |
---|---|---|
committer | Joey Hess <joey@gnu.kitenet.net> | 2009-07-21 11:31:51 +0200 |
commit | eca2dbe67f7c2ce9f5a53765ea73227fdad0ad28 (patch) | |
tree | f1be1e4f398e2a191d38a20ad1c53cb280da257c /doc | |
parent | eeeda1295f08337f1321860d2b839732a46786e4 (diff) |
po: Add support for mo files in underlays
In order to support translated basewiki and other underlays, we need
support for mo files in underlays.
The code did not allow this before, because if a mo file was in an
underlay, then it might try to update it, and its pot, and write to the
underlay, which is guaranteed to either fail due to permissions, or be
undesirable.
To fix, my approach is to just detect if a mo or pot file that is about to
be updated is in an underlay, and skip updating it. This seems to work
well:
- If the mo is out of date in the underlay, it won't get updated, but this
would probably be due to a problem in the underlay, or more likely,
the wiki is being rebuilt and so it *thinks* the mo is out of date,
but it's really not (and it would be a waste of time to rebuild it
anyway).
- If a page from the basewiki is edited, it is saved to the srcdir,
which causes generation of an updated mo and pot also in the srcdir;
the underlay stops being used for that page, and everything seems
to work.
Note that I am not including an underlay search directory for pot files.
They *seem* to be unnecessary for the underlay, since the mo files
in there never need to be updated.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/plugins/po.mdwn | 33 |
1 files changed, 0 insertions, 33 deletions
diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn index 8e87e2638..36b44cd7f 100644 --- a/doc/plugins/po.mdwn +++ b/doc/plugins/po.mdwn @@ -250,7 +250,6 @@ 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 ---------------------- @@ -260,38 +259,6 @@ 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 ? ------------------ |