po plugin: added note about not publishing .pot files

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

diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 991f25c069712c6decb626ae6d8958b608d8c400..2b0fba628a1842170f8d4d078e3ead86e689c341 100644 (file)
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -46,6 +46,16 @@ languages, such as:
                                 'de' => { 'name' => 'Deutsch', }
         }
 
                                 'de' => { 'name' => 'Deutsch', }
         }
 

+Decide which pages are translatable
+-----------------------------------
+
+The subset of "master" pages subject to translation is configurable:
+
+- a `[[!translatable ]]` directive, when put on a page, makes it
+  translatable
+- to set at once a bunch of pages as being translatable, use this
+  [[ikiwiki/directive]] with the `match=PageSpec` argument.
+

 Internal links
 --------------
 
 Internal links
 --------------
 


@@ -112,6 +122,15 @@ lighttpd unfortunately does not support content negotiation.
 TODO
 ====
 
 TODO
 ====
 

+Optimization
+------------
+
+Move `match_istranslation` and `match_istranslatable` code into helper
+functions, and pre-compute what can be early in the build process:
+
+- the list of translatable (master) pages
+- for every translatable page, the list of slave pages
+

 Display available translations
 ------------------------------
 
 Display available translations
 ------------------------------
 


@@ -131,17 +150,6 @@ implemented as a
 loop, a page using it should depend on any "master" and "slave" pages
 whose status is being displayed.
 
 loop, a page using it should depend on any "master" and "slave" pages
 whose status is being displayed.
 

-Decide which pages are translatable
------------------------------------
-
-The subset of "master" pages subject to translation must be
-configurable:
-
-- a `[[!translatable ]]` directive, when put on a page, makes it
-  translatable
-- to set at once a bunch of pages as being translatable, use this
-  [[ikiwiki/directive]] with the `match=PageSpec` argument.
-

 Automatic PO files update
 -------------------------
 
 Automatic PO files update
 -------------------------
 


@@ -163,6 +171,8 @@ The latter can be implemented by making any "slave" page depend on the
 corresponding "master" page. The `add_depends` function can achieve
 this, if used in a **FIXME** hook.
 
 corresponding "master" page. The `add_depends` function can achieve
 this, if used in a **FIXME** hook.
 

+The POT files should not be published on the wiki.
+

 UI consistency: rename "Edit" button on slave pages
 ---------------------------------------------------
 
 UI consistency: rename "Edit" button on slave pages
 ---------------------------------------------------