[Koha-docs] Translation of manual using pootle

[Nicole Engard]

Bernardo,

There were issues way back when we started with changing the encoding.
 The editor I'm using is entering those codes and if you change them
once I open the editor again it will put them back in.  So what needs
to be done, is not necessarily a patch to the English version, but a
check on the script that's generating the HTML to see if those codes
can be removed and still display the manual properly.  If they can
then I can alter the encoding on the application and it should update
those symbols .. if it doesn't then yes, we have to do it manually
with a patch.

I have to admit that I don't remember what the problem was, just that
we went back and forth and eventually found a method that worked and I
don't want to go and change the manual coding to find that we're back
at square one with things not appearing properly on the web.

Nicole

On Tue, Aug 28, 2012 at 1:03 PM, Bernardo Gonzalez Kriegel
<bgkriegel at gmail.com> wrote:
> Hi all,
> August is ending, so I guess it's time to revisit the issue of the
> translation of the manual.
> Some of us prefer to use the same infrastructure in translate.k-c.
>
> To that end we need a procedure to generate and update PO files from the XML
> version,
> translate, and finally produce a translated XML file (and then HTML, PDF,
> etc.).
>
> There are tools to do this:
> xml2pot: to create a POT file from XML
> gettext package to manipulate POT/PO/MO files
> itstool: to recreate XML from MO
>
> Now, one of this tools (itstool) complains that the current version of the
> manual (git, 3.8.x)
> is not a valid XML file.
>
> The problem seems to be due to the use of ISO (HTML) named character
> entities,
> such as &copy; &nbsp; &ldquo, which are invalid in a XML document.
>
> One solution is to replace these entities by their UTF-8 counterparts (i.e.
> author in UTF-8), or
> by numeric character entities  (&copy; -> &#169;)
>
> So, to begin we need that the English version of the manual changes
> accordingly.
> (I could send a patch to this)
>
> Sincerely
> Bernardo
>
> --
> Bernardo Gonzalez Kriegel
> bgkriegel at gmail.com
>