In docbook one can specify +the language used at the top, and the processing pipeline will use +this information to pick the correct translations for 'chapter', 'see +also', 'index' etc. And for most languages used with docbook, I guess +this work just fine. For example a German user can start the document +with <book lang="de">, and the document will show up with the +correct content with any of the docbook processors. This is not the +case for the language +I +am working with at the moment, Norwegian Bokmål.
+ +For a while, I was confused about which language code to use, +because I was unable to find any language code that would work across +all tools. I am currently testing dblatex, xmlto, docbook-xsl, and +dbtoepub, and they do not handle Norwegian Bokmål the same way. Some +of them do not handle it at all.
+ +A bit of background information is probably needed to understand +this mess. Norwegian is not one, but two written variants. The +variants are Norwegian Nynorsk and Norwegian Bokmål. There are three +two letter language codes associated with these languages, Norwegian +is 'no', Norwegian Nynorsk is 'nn' and Norwegian Bokmål is 'nb'. +Historically the 'no' language code was used for Norwegian Bokmål, but +many years ago this was found to be å bad idea, and the recommendation +is to use the most specific language code instead, to avoid confusion. +In the transition period it is a good idea to make sure 'no' was an +alias for 'nb'.
+ +Back to docbook processing tools in Debian. The dblatex tool only +understand 'nn'. There are translations for 'no', but not 'nb' (BTS +#684391), but due to a bug +(BTS #682936) the 'no' +language code is not recognised. The docbook-xsl tool chain only +recognise 'nn' and 'nb', but not 'no'. The xmlto tool only recognise +'nn' and 'nb', but not 'no'. The end result that there is no language +code I can use to get the docbook file working with all of these tools +at the same time. :(
+ +The correct solution is to use <book lang="nb">, but it will +take time before that will work with all the free software docbook +processors. :(
+ +Oh, the joy of well integrated tools. :/
+