Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

debian::l10n::debconf(3pm) [debian man page]

Debian::L10n::Debconf(3pm)				User Contributed Perl Documentation				Debian::L10n::Debconf(3pm)

NAME

       Debian::L10n::Debconf - translation status of Debconf templates

SYNOPSIS

	use Debian::L10n::Debconf;
	my $tmpl = Debian::L10n::Debconf->new();
	$tmpl->read_compact($file);
	my @languages = $tmpl->langs();
	foreach (sort @languages) {
	       my ($t,$f,$u) = $tmpl->stats($_);
	       print "$_:${t}t${f}f${u}u
";
	}

DESCRIPTION

       This module extracts informations about translation status of Debconf templates files.

METHODS

       new This is the constructor.

	      my $tmpl = Debian::L10n::Debconf->new();

       read_compact
	   Read a templates file containing all translations.  An optional second argument may be used, any non-zero value tells that this file
	   comes with translations in other files.  In such a case no warning is raised if this file contains translated fields, because
	   maintainer is assumed to be responsible for such translations.

	      $tmpl->read_compact($file);

       read_dispatched
	   Read templates contained in several files.  First argument is the English file, all other arguments are translated templates files.

	      @trans = qw(templates.de templates.fr templates.ja templates.nl);
	      $tmpl->read_dispatched('templates', @trans);

       langs
	   Return the languages in which this templates file is translated.

	      my @list = $tmpl->langs();

       filename
	   When templates are dispatched into several files, return the filename in which the language passed as argument is found.

	      my $filename = $tmpl->filename("de");

       count
	   Return the number of translatable strings in this templates file.

	      my $number = $tmpl->count();

       stats
	   With an argument, return an array consisting of the number of translated, fuzzy and untranslated strings for the language given as
	   argument.  Without argument, return a hash array indexed by language and returning an array of the number of translated, fuzzy and
	   untranslated strings.

	      my ($t, $f, $u) = $tmpl->stats("de");
	      my %stats  = $tmpl->stats();
	      foreach (keys %stats) {
		      print $_.':'. $stats{$_}->[0].'t'.$stats{$_}->[1].'f'.
			   $stats{$_}->[2]."u
";
	      }

       entries
	   Return an array containing all Debconf ids found in this templates file.

	      my @ids = $tmpl->entries();

AUTHOR

       Copyright (C) 2001  Denis Barbier <barbier@debian.org>

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

perl v5.14.2							    2011-03-30						Debian::L10n::Debconf(3pm)

Check Out this Related Man Page

DEBCONF-GETLANG(1)						      Debconf							DEBCONF-GETLANG(1)

NAME

       debconf-getlang - extract a language from a templates file

SYNOPSIS

	debconf-getlang lang master [translation]
	debconf-getlang --stats master translation [...]

DESCRIPTION

       Note: This utility is deprecated; you should switch to using the po-debconf package.

       This program helps make and manage translations of debconf templates.  There are basically three situations in which this program might be
       called:

       A translation is just being started.
	   You want to provide the translator with a file they can work on that has the English fields from your templates file, plus blank Field-
	   ll fields for the target language that they can fill in.

	   To do this, run the program with first parameter being the code for the language that is being translated to, and the second parameter
	   being the filename of the English templates file.

       A translation is well under way.
	   You have changed some English text, or added more items to your templates file, and you want to send the translators a file with the
	   English text plus their current translations (or you are the translator, and you want to generate such a file for your own use).

	   To accomplish this, run the program with the first parameter being the the code for the language that is being translated to, the
	   second parameter being the filename of the master English templates file, and the third parameter being the filename of the current
	   translated file.

	   When run this way, the program is smart enough to notice fuzzy translations. For example a fuzzy Description will be output as
	   Description-<lang>-fuzzy, and a new, blank Description-<lang> will be added.  Translators should remove the -fuzzy fields as they
	   correct the fuzzy translations.

       Checking the status of a translation
	   To check the status of a translation, use the --status flag, and pass the english template file as the first parameter, and all the
	   other translated templates after that. It will output statistics for each of them. For example:

	     debconf-getlang --stats debian/templates debian/templates.*

NOTE

       Note that the text in the generated templates may be word-wrapped by debconf.

SEE ALSO

       debconf-mergetemplate(1)

AUTHOR

       Joey Hess <joeyh@debian.org>

								    2012-09-10							DEBCONF-GETLANG(1)
Man Page