minor wording improvements/changes

master
Joey Hess 2008-11-05 14:22:02 -05:00
parent 9bedf53c0f
commit b76ee8a96d
2 changed files with 10 additions and 14 deletions

View File

@ -12,5 +12,5 @@ wiki:
* "`currentlang()`" - Tests whether a page is written in the same * "`currentlang()`" - Tests whether a page is written in the same
language as the current page. language as the current page.
Note: every non-PO page is considered to be written in Note: every non-po page is considered to be written in
`po_master_language`, as specified in `ikiwiki.setup`. `po_master_language`, as specified in `ikiwiki.setup`.

View File

@ -13,7 +13,7 @@ A language is chosen as the "master" one, and any other supported
language is a "slave" one. language is a "slave" one.
A page written in the "master" language is a "master" page. It can be A page written in the "master" language is a "master" page. It can be
of any page type supported by ikiwiki, but PO. It does not have to be of any page type supported by ikiwiki, except `po`. It does not have to be
named a special way: migration to this plugin does not imply any page named a special way: migration to this plugin does not imply any page
renaming work. renaming work.
@ -22,7 +22,7 @@ English; if `usedirs` is enabled, it is rendered as
`bla/page/index.en.html`, else as `bla/page.en.html`. `bla/page/index.en.html`, else as `bla/page.en.html`.
Any translation of a "master" page into a "slave" language is called Any translation of a "master" page into a "slave" language is called
a "slave" page; it is written in the gettext PO format. PO is now a "slave" page; it is written in the gettext PO format. `po` is now
a page type supported by ikiwiki. a page type supported by ikiwiki.
Example: `bla/page.fr.po` is the PO "message catalog" used to Example: `bla/page.fr.po` is the PO "message catalog" used to
@ -56,9 +56,8 @@ The `po_translatable_pages` setting configures what pages are
translatable. It is a [[ikiwiki/PageSpec]], so you have lots of translatable. It is a [[ikiwiki/PageSpec]], so you have lots of
control over what kind of pages are translatable. control over what kind of pages are translatable.
The PO translations files are anyway not considered as being The `.po` files are not considered as being translatable, so you don't need to
translatable, so you don't need to worry about excluding them worry about excluding them explicitly from this [[ikiwiki/PageSpec]].
explicitly from this [[ikiwiki/PageSpec]].
Internal links Internal links
-------------- --------------
@ -180,17 +179,14 @@ Additional PageSpec tests
This plugin enhances the regular [[ikiwiki/PageSpec]] syntax with some This plugin enhances the regular [[ikiwiki/PageSpec]] syntax with some
additional tests that are documented [[here|ikiwiki/pagespec/po]]. additional tests that are documented [[here|ikiwiki/pagespec/po]].
Automatic PO files update Automatic PO file update
------------------------- ------------------------
Committing changes to a "master" page: Committing changes to a "master" page:
1. updates the POT file and the PO files for the supported languages 1. updates the POT file and the PO files for the supported languages;
(this is done in the `needsbuild` hook); the updated PO files are the updated PO files are then put under version control
then put under version control 2. triggers a refresh of the corresponding HTML slave pages
2. triggers a refresh of the corresponding HTML slave pages (this is
achieved by making any "slave" page dependent on the corresponding
"master" page, in the `needsbuild` hook)
Also, when the plugin has just been enabled, or when a page has just Also, when the plugin has just been enabled, or when a page has just
been declared as being translatable, the needed POT and PO files are been declared as being translatable, the needed POT and PO files are