Your SlideShare is downloading. ×
th
4 italian Perl workshop - 19/09/2008




      POD2::* and Perl translation
         documentation project
            ...
What

    pod2it is the Italian Perldoc Translation Project
●
When

    pod2it is born on August 21, 2002
●
Who

    A brillant idea of some italian Perl mongers
●



    20 translators and reviewers
●
Why

    The scope of the project is to translate in italian
●


    the pods that are shipped with Perl
        41 transl...
Where

    http://pod2it.sourceforge.net/
●



    pod2it-translators@lists.sf.net
●
How it works

    It's simple: translate and commit
●



    There's a guide line
●



    We use entities for (à, è, ...)...
How to contribute

    Join to pod2it-translators@lists.sf.net
●



    Get a SourceForge account
●



    Choose a pod
●
...
[RFC] POD2::* namespace

From: Enrico Sorcinelli <enrico [at] sorcinelli.it>
Date: Sun, 20 Jul 2003 23:25:42 +0200
To: per...
POD2::IT

    0.01 Thu Jun 19 01:29:11 2003
●

     + original version; created by h2xs 1.21 with options
        -A -X -n...
New in Perl 5.10!

    %> perldoc -L it <podname>
●


    %> perldoc -L it -f <function>
●


    %> perldoc -L it -q <FAQr...
Future of Pod::Perldoc

    Retrieve language code from environment
●


    variable PERLDOC_POD2:
%> export PERLDOC_POD2=...
Future of Pod::Perldoc

    Message strings localization
●



    Failover method if requested pod doesn't exist
●


     ...
Other translation projects

    www.perldoc.jp
●


    POD2::FR
●


    POD2::CN
●


    POD2::LT
●


    POD2::EO::Time::...
Coordinating POD2::* worldwide

    pod2.perl.org
●



    Unique repository (CVS/Subversion)
●



    Mailing list
●
perldoc.perl.org

    Add translations
●


        upgrade for each new Perl release
    –

        POD2::IT package isn't...
pod2it advocacy

    Invite local communities to translate not only
●


    core pods, but also most important modules
   ...
Conclusions

    We live in a Country (Italy) where the English
●


    language should be spread better but unluckly
    ...
Questions?
Upcoming SlideShare
Loading in...5
×

POD2::* and Perl translation documentation project

1,145

Published on

Past, present and future of Perl translation documentation project (italian and worlwide)

Published in: Technology, Business
1 Comment
0 Likes
Statistics
Notes
  • Be the first to like this

No Downloads
Views
Total Views
1,145
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
0
Comments
1
Likes
0
Embeds 0
No embeds

No notes for slide

Transcript of "POD2::* and Perl translation documentation project"

  1. 1. th 4 italian Perl workshop - 19/09/2008 POD2::* and Perl translation documentation project Enrico Sorcinelli
  2. 2. What pod2it is the Italian Perldoc Translation Project ●
  3. 3. When pod2it is born on August 21, 2002 ●
  4. 4. Who A brillant idea of some italian Perl mongers ● 20 translators and reviewers ●
  5. 5. Why The scope of the project is to translate in italian ● the pods that are shipped with Perl 41 translated pods (including perlfaq* and the – huge perlfunc) 10 pods under revision –
  6. 6. Where http://pod2it.sourceforge.net/ ● pod2it-translators@lists.sf.net ●
  7. 7. How it works It's simple: translate and commit ● There's a guide line ● We use entities for (à, è, ...) ● status.txt ●
  8. 8. How to contribute Join to pod2it-translators@lists.sf.net ● Get a SourceForge account ● Choose a pod ● Start to translate or to review! ●
  9. 9. [RFC] POD2::* namespace From: Enrico Sorcinelli <enrico [at] sorcinelli.it> Date: Sun, 20 Jul 2003 23:25:42 +0200 To: perl-documentation [at] perl.org Subject: [RFC] POD2::* perldoc translations namespace Hi all, One year ago, some Italian Perl Mongers started quot;pod2itquot; project, the perldoc italian translation project (pod2it.sourceforge.net, leaded by Stefano Rodighiero <larsen@perl.it>). [...] Which namespace? We have chosen POD2::<country code> namespace [...] There is also an idea to patch perldoc in order to add a switch (like -L) for directly see localized translation: perldoc -L it perlfunc [...] http://www.xray.mpe.mpg.de/mailing-lists/perl- ● documentation/2003-07/msg00015.html
  10. 10. POD2::IT 0.01 Thu Jun 19 01:29:11 2003 ● + original version; created by h2xs 1.21 with options -A -X -n POD2::IT by Enrico Sorcinelli <bepi@perl.it> July, 23 2005: first CPAN release ● 0.12 (18/08/2008) ● %> perl -MCPAN -e install POD2::IT ● %> perldoc POD2::IT::<podname> ● perldoc's -f and -q switches don't work no ● longer
  11. 11. New in Perl 5.10! %> perldoc -L it <podname> ● %> perldoc -L it -f <function> ● %> perldoc -L it -q <FAQregex> ● RFC: Wed, 27 Jul 2005 16:57:37 +0200 ● Simple API ● – print_pod, print_pods – search_perlfunc_re Pod::Perldoc uses hard coded strings ● It returns a localized translation of the paragraph ● 'Alphabetical Listing of Perl Functions' string
  12. 12. Future of Pod::Perldoc Retrieve language code from environment ● variable PERLDOC_POD2: %> export PERLDOC_POD2=it %> perldoc -f print Auto-retrieve language code from local, only if ● PERLDOC_POD2=1 %> export PERLDOC_POD2=1 %> perldoc -f print For the impatient: ● %> alias perldoc-it='perldoc -L it' %> perldoc-it -f print
  13. 13. Future of Pod::Perldoc Message strings localization ● Failover method if requested pod doesn't exist ● POD2::* isn't installed: check CPAN and ask for – installation POD2::* is installed but there isn't the specific pod – translation: automatic (or ask) switch to english pod
  14. 14. Other translation projects www.perldoc.jp ● POD2::FR ● POD2::CN ● POD2::LT ● POD2::EO::Time::Decimal ● POD2::PT (?) ● POD2::Base ● Base module for translations of Perl documentation – (based on IT.pm)
  15. 15. Coordinating POD2::* worldwide pod2.perl.org ● Unique repository (CVS/Subversion) ● Mailing list ●
  16. 16. perldoc.perl.org Add translations ● upgrade for each new Perl release – POD2::IT package isn't complete –
  17. 17. pod2it advocacy Invite local communities to translate not only ● core pods, but also most important modules pods. For example: POD2::IT::LWP POD2::IT::DBI POD2::IT::Getopt::Long has been just ● released to CPAN http://search.cpan.org/~enrys/POD2-IT-Getopt-Long/ –
  18. 18. Conclusions We live in a Country (Italy) where the English ● language should be spread better but unluckly isn't If the Perl documentation was in locale ● language instead of English, we could have more Perl fans. Instead, we've now a VB| Java|.NET|Python|PHP programmers...
  19. 19. Questions?

×