po: oops, removed debug output from testsuit
[git.ikiwiki.info.git] / doc / plugins / po.mdwn
index f10ee1d2cf8c72aedc04c1d41e1b33d454715199..a010dbb7e2cfc9073c7b3434c5fbdf908c1c05bd 100644 (file)
@@ -215,16 +215,6 @@ TODO
 Security checks
 ---------------
 
-- `refreshpofiles` uses `system()`, whose args have to be checked more
-  thoroughly to prevent any security issue (command injection, etc.).
-  > Always pass `system()` a list of parameters to avoid the shell.
-  > I've checked in a change fixing that. --[[Joey]]
-- `refreshpofiles` and `refreshpot` create new files; this may need
-  some checks, e.g. using `IkiWiki::prep_writefile()`
-  > Yes, it would be ideal to call `prep_writefile` on each file 
-  > that they write, beforehand. This way you'd avoid symlink attacks etc to the
-  > generated po/pot files. I haven't done it, but it seems pretty trivial.
-  > --[[Joey]]
 - Can any sort of directives be put in po files that will
   cause mischief (ie, include other files, run commands, crash gettext,
   whatever).
@@ -255,25 +245,29 @@ does. This is actually a duplicate for
 [[bugs/pagetitle_function_does_not_respect_meta_titles]], which might
 be fixed by something like [[todo/using_meta_titles_for_parentlinks]].
 
-### websetup
+### backlinks
 
-Which configuration settings are safe enough for websetup, apart of
-`po_master_language` and `po_slave_languages` that already have
-been checked?
+#### `po_link_to = negotiated`
 
-> `po_translatable_pages` seems entirely safe. `po_link_to` w/o usedirs
-> causes ikiwiki to error out. If it were changed to fall back to a safe
-> setting in this case rather than error, it would be safe.
-> --[[Joey]]
+This is now implemented:
+- if a translatable page links to another translatable page: the
+  master destpage gets a backlink to the master sourcepage, and every
+  slave destpage gets a backlink to the corresponding slave sourcepage
+- if a translatable page links to a non-translatable page: the
+  destpage gets a backlink to the master sourcepage only
+- if a non-translatable page links to a translatable page: every
+  master or slave destpage gets a backlink to the sourcepage
+- if a non-translatable page links to another non-translatable page:
+  the default behavious is nice, don't change it
 
-### backlinks
+#### `po_link_to = current`
+
+At first glance, backlinks seem to work nicely, but a more thorough
+look is needed.
 
-`po_link_to = negotiated`: if a given translatable `sourcepage.mdwn`
-links to \[[destpage]], `sourcepage.LL.po` also link to \[[destpage]],
-and the latter has the master page *and* all its translations listed
-in the backlinks.
+#### `po_link_to = default`
 
-`po_link_to = current`: seems to work nicely
+FIXME
 
 Translation quality assurance
 -----------------------------