POD2::* and Perl translation documentation project

  • 1,079 views
Uploaded on

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

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

More in: Technology , Business
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to like this
No Downloads

Views

Total Views
1,079
On Slideshare
0
From Embeds
0
Number of Embeds
1

Actions

Shares
Downloads
0
Comments
1
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. th 4 italian Perl workshop - 19/09/2008 POD2::* and Perl translation documentation project Enrico Sorcinelli
  • 2. What pod2it is the Italian Perldoc Translation Project ●
  • 3. When pod2it is born on August 21, 2002 ●
  • 4. Who A brillant idea of some italian Perl mongers ● 20 translators and reviewers ●
  • 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. Where http://pod2it.sourceforge.net/ ● pod2it-translators@lists.sf.net ●
  • 7. How it works It's simple: translate and commit ● There's a guide line ● We use entities for (à, è, ...) ● status.txt ●
  • 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. [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. 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. 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. 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. 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. 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. Coordinating POD2::* worldwide pod2.perl.org ● Unique repository (CVS/Subversion) ● Mailing list ●
  • 16. perldoc.perl.org Add translations ● upgrade for each new Perl release – POD2::IT package isn't complete –
  • 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. 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. Questions?