another problem

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

diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 156cb6cb33ecc65605b3a1b7c08b602cdee4f6c9..5016f1037dac7329cda77de1b28f5a94895201af 100644 (file)
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -250,6 +250,14 @@ 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.
 
+Self links
+----------
+
+If a page contains a WikiLink to itself, ikiwiki does not normally
+turn that into a hyperlink. However, if a translated page contains a
+WikiLink to itself, a hyperlink is inserted, at least with the default
+`po_link_to` the link points to the English version of the page. Is there a
+good reason for that to be done? --[[Joey]] 
 
 Language display order
 ----------------------
@@ -260,22 +268,31 @@ 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
--------------
+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]] 
+
+Name of toplevel index page
+---------------------------
 
-If .ikiwiki is deleted and a wiki is rebuilt from scratch, and
-po has created po files before, something wrong happens:
+Normally at the top index page of a wiki, you see the wiki name at
+the top. However, at the top *translated* index page, you see something
+like "index.da". --[[Joey]] 
 
-> 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
+Pagespecs
+---------
 
-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]]
+I was suprised that, when using the map directive, a pagespec of "*"
+listed all the translated pages as well as regular pages. That can 
+make a big difference to an existing wiki when po is turned on,
+and seems generally not wanted.
+(OTOH, you do want to match translated pages by
+default when locking pages.) --[[Joey]]
 
 Documentation
 -------------