summaryrefslogtreecommitdiff
path: root/doc/todo/language_definition_for_the_meta_plugin.mdwn
blob: 4e5d8ef4e912f5640a7ab0db6d2d3efe05d41b35 (plain)

Here is a patch for the [[plugins/meta]] plugin. It adds the possibility to define the language used for a page, with [[meta lang="ja"]]

It doesn't insert the langage information in the xhtml meta elements, but defines a LANG variable to use in the templates, for example with

<html xmlns="http://www.w3.org/1999/xhtml"
      lang="<TMPL_IF NAME="LANG"><TMPL_VAR LANG><TMPL_ELSE>fr</TMPL_IF>"
      xml:lang="<TMPL_IF NAME="LANG"><TMPL_VAR LANG><TMPL_ELSE>fr</TMPL_IF>">

This way also allows to define a language for a subset of the final page, with custom templates and inclusion.

This may be useful for sites with a few pages in different languages, but no full i18n.

Looks good, but the need to modify the template and include a default language in it is a bit problimatic, I think. --[[Joey]]

--lang=XX could be a setup option, with a default value, then the template would be

            <html xmlns="http://www.w3.org/1999/xhtml" lang="<TMPL_VAR LANG>" xml:lang="<TMPL_VAR LANG>">

Yes, that seems reasonable. I guess there's no problem with defaulting to en if it can be overridden in the setup. --[[Joey]]

Yes, english default makes sense. I guess we should use the $config{lang}, defined from the setup file or command-line options to define the default language ($config{lang} defaults to en which is fine) if the html pages, and override it from the meta directive. — [[NicolasLimare]]

ikiwiki already has a $config{locale}, which is a full locale (ie, "en_US.UTF-8". This just needs to be parsed for the lang. --[[Joey]]

[[tag wishlist patch plugin/meta translation]]