Spanish Localization of the Perl Core Documentation - Grant Report #2
Tue, 07-Aug-2012 by
Alan Haggai Alavi
edit post
<![CDATA[
*Enrique Nell and Joaquin Ferrero reported:*
> <p>Project status:
> <a href='https://docs.google.com/spreadsheet/ccc?key=0AkmrG_9Q4x15dC1MNWloU0lyUjhGa2NrdTVTOG5WZVE'>https://docs.google.com/spreadsheet/ccc?key=0AkmrG_9Q4x15dC1MNWloU0lyUjhGa2NrdTVTOG5WZVE</a></p>
>
> <p>CPAN distribution:
> <a href='http://search.cpan.org/~enell/POD2-ES-5.16.0.07/'>http://search.cpan.org/~enell/POD2-ES-5.16.0.07/</a></p>
>
> <p>Project host:
> <a href='https://github.com/zipf/perldoc-es'>https://github.com/zipf/perldoc-es</a></p>
>
> <p>During the second month we did a thorough proofreading of files included in <code>POD2::ES</code>, which led to fixing several errors (mostly related to formatting). We also kept updating translated files to 5.16.0, and reviewed a few files that were included in the latest <code>POD2::ES</code> releases.</p>
>
> <p>While translating perlobj.pod, a bug in sample code was detected and reported through perlbug. The report was accepted and hopefully it will be fixed in v5.16.1.</p>
>
> <p>New files added during the v5.16.0 track of <code>POD2::ES</code>:</p>
>
> <ul>
> <li>perlobj</li>
> <li>perlmroapi</li>
> <li>perlnewmod</li>
> <li>perlhist</li>
> </ul>
>
> <h3>Stats</h3>
>
> <p>Document/word counts for v5.16.0:</p>
>
> <ul>
> <li>Total documents: 162 (100 in core docs)</li>
> <li>Total words: 841,604 (597,294 in core docs)</li>
> </ul>
>
> <p>Current status for the Spanish v5.16.0 track:</p>
>
> <ul>
> <li>% translated: 45.44% (46,77% of core docs) [Previous month: 43.51% (44.74%)]</li>
> <li>% reviewed: 8.52% [Previous month: 5.06%]</li>
> </ul>
>
> <h3>Tools</h3>
>
> <p>We have implemented several changes in the post-processing script (the new version will be published in the next few days):</p>
>
> <ul>
> <li>Removed the command line switch to add names of people involved in the translation and instead added the pod names translated by each team member (except the current reviewers, Joaquín and Enrique, whose names appear in every file) to their corresponding entry in the DATA section.</li>
> <li>Added a --nohtml switch to allow running the post-processing code without creating an html version of the pod files.</li>
> <li>Added a --diff switch to allow creating an word-oriented diff file in html format. The generated report contains the segments that were modified by the reviewer. This will be an important tool to help translators align their styles and terminology.</li>
> <li>Added a podchecker call to check POD formatting.</li>
> <li>Cleaned up the code.</li>
> </ul>
>
> <h3>Future work</h3>
>
> <p>We are still working on several of the TO DO list tasks mentioned in the previous report.</p>
>
> <p>Perl v5.16.1 will be released in a few days, so for the third month our top priority will be updating <code>POD2::ES</code> to the latest version, and adding more reviewed files to the distribution.</p>
>
> <p>We have identified another file, perlmodlib.pod, that is generated during Perl setup. Since it contains interesting material, we will add it to our file list.</p>
]]>
Comments (0)
