po plugin: move translatable pages to setup file, refactor

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

diff --git a/doc/plugins/po.mdwn b/doc/plugins/po.mdwn
index 69fce52efe8767c682c3deb784725bae8da3df7f..20ca5c4a537e38b32f17e87855895b9bdb653a3f 100644 (file)
--- a/doc/plugins/po.mdwn
+++ b/doc/plugins/po.mdwn
@@ -49,12 +49,13 @@ languages, such as:
 Decide which pages are translatable
 -----------------------------------
 
 Decide which pages are translatable
 -----------------------------------
 

-The subset of "master" pages subject to translation is configurable:
+The `po_translatable_pages` setting configures what pages are
+translatable. It is a [[ikiwiki/PageSpec]], so you have lots of
+control over what kind of pages are translatable.

 
 

-- 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.
+The `*.LL.po` translations files are anyway not considered as being
+translatable, so you don't need to worry about excluding them manually
+from this [[ikiwiki/PageSpec]].

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


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

+Optimization
+------------
+
+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
+
+... and/or memoize `istranslation`/`istranslatable` function calls.
+

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


@@ -162,6 +173,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
 ---------------------------------------------------