[Po4a-devel][CVS] po4a/lib/Locale/Po4a Chooser.pm,1.14,1.15 Dia.pm,1.2,1.3 KernelHelp.pm,1.5,1.6 Man.pm,1.20,1.21 Pod.pm,1.9,1.10 Xml.pm,1.5,1.6
by Jordi Vilalta
Update of /cvsroot/po4a/po4a/lib/Locale/Po4a
In directory haydn:/tmp/cvs-serv27212
Modified Files:
Chooser.pm Dia.pm KernelHelp.pm Man.pm Pod.pm Xml.pm
Log Message:
Canonize TransTractor's name and a few other documentation enhancements.
Index: Dia.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Dia.pm,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- Dia.pm 19 Jul 2004 10:21:12 -0000 1.2
+++ Dia.pm 30 Jul 2004 00:17:41 -0000 1.3
@@ -76,7 +76,7 @@
=head1 SEE ALSO
-L<po4a(7)>, L<Locale::Po4a::TransTranctor(3pm)>, L<Locale::Po4a::Pod(3pm)>.
+L<po4a(7)>, L<Locale::Po4a::TransTractor(3pm)>, L<Locale::Po4a::Pod(3pm)>.
=head1 AUTHORS
Index: KernelHelp.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/KernelHelp.pm,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- KernelHelp.pm 30 Apr 2004 22:47:58 -0000 1.5
+++ KernelHelp.pm 30 Jul 2004 00:17:41 -0000 1.6
@@ -156,7 +156,7 @@
=head1 SEE ALSO
-L<Pod::Parser>, L<po4a(7)>, L<Locale::Po4a::TransTranctor(3pm)>,
+L<Pod::Parser>, L<po4a(7)>, L<Locale::Po4a::TransTractor(3pm)>,
L<Locale::Po4a::Man(3pm)>,
L<Locale::Po4a::Pod(3pm)>,
Index: Pod.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Pod.pm,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Pod.pm 19 Jul 2004 20:32:43 -0000 1.9
+++ Pod.pm 30 Jul 2004 00:17:41 -0000 1.10
@@ -271,7 +271,7 @@
=head1 SEE ALSO
-L<Pod::Parser>, L<po4a(7)>, L<Locale::Po4a::TransTranctor(3pm)>,
+L<Pod::Parser>, L<po4a(7)>, L<Locale::Po4a::TransTractor(3pm)>,
L<Locale::Po4a::Man(3pm)>,
=head1 AUTHORS
Index: Xml.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Xml.pm,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- Xml.pm 29 Jul 2004 01:26:27 -0000 1.5
+++ Xml.pm 30 Jul 2004 00:17:41 -0000 1.6
@@ -148,7 +148,7 @@
the tag hierarchy. For example, you can put 'w' (wrap) or 'W' (don't wrap)
to override the default behavior specified by the global "wrap" option.
-Example: W<chapter><title>
+Example: WE<lt>chapterE<gt><title>
=item attributes (TODO)
@@ -331,7 +331,7 @@
# breaking => 1,
# f_translate => \&tag_trans_procins},
{ beginning => "!DOCTYPE",
- end => "]",
+ end => "",
breaking => 1,
f_extract => \&tag_extract_doctype,
f_translate => \&tag_trans_doctype},
@@ -1025,7 +1025,7 @@
=head1 SEE ALSO
-L<po4a(7)>, L<Locale::Po4a::TransTranctor(3pm)>.
+L<po4a(7)>, L<Locale::Po4a::TransTractor(3pm)>.
=head1 AUTHORS
Index: Man.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Man.pm,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- Man.pm 21 Jul 2004 00:45:02 -0000 1.20
+++ Man.pm 30 Jul 2004 00:17:41 -0000 1.21
@@ -219,7 +219,7 @@
=head1 SEE ALSO
-L<po4a(7)>, L<Locale::Po4a::TransTranctor(3pm)>,
+L<po4a(7)>, L<Locale::Po4a::TransTractor(3pm)>,
L<Locale::Po4a::Pod(3pm)>.
=head1 AUTHORS
Index: Chooser.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Chooser.pm,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- Chooser.pm 29 Jul 2004 01:27:51 -0000 1.14
+++ Chooser.pm 30 Jul 2004 00:17:41 -0000 1.15
@@ -87,7 +87,7 @@
=item About po4a:
L<po4a(7)>,
-L<Locale::Po4a::TransTranctor(3pm)>,
+L<Locale::Po4a::TransTractor(3pm)>,
L<Locale::Po4a::Po(3pm)>
=item About modules:
20 years, 5 months
[Po4a-devel][CVS] po4a/doc po4a.7.pod,1.23,1.24
by Jordi Vilalta
Update of /cvsroot/po4a/po4a/doc
In directory haydn:/tmp/cvs-serv13107
Modified Files:
po4a.7.pod
Log Message:
Some errors and cleanings that I've found while translating it.
Index: po4a.7.pod
===================================================================
RCS file: /cvsroot/po4a/po4a/doc/po4a.7.pod,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- po4a.7.pod 29 Jul 2004 01:27:51 -0000 1.23
+++ po4a.7.pod 30 Jul 2004 00:11:20 -0000 1.24
@@ -30,8 +30,8 @@
=item 2 How to use po4a?
This chapter is a sort of reference manual, trying to answer the users'
-questions and to give you a better understanding of the whole process. It
-introduce how to do things with po4a and serve as an introduction to the
+questions and to give you a better understanding of the whole process. This
+introduces how to do things with po4a and serve as an introduction to the
documentation of specific tools.
=over
@@ -75,8 +75,8 @@
encounter when translating stuff in this module, or the rules you should
follow in your original document to make translators' life easier.
-Actually, this section in not really part of this document. Instead, it is
-placed in each documentations' modules. This help ensuring that the
+Actually, this section is not really part of this document. Instead, it is
+placed in each module's documentation. This helps ensuring that the
informations are up to date by keeping the documentation and the code
together.
@@ -185,7 +185,7 @@
documentation of compilation options for the 2.4.x kernels or the diagrams
produced by the dia tool. Adding a new one is often very easy and the main
task is to come up with a parser of your target format. See
-L<Locale::Po4a::Transtractor(3pm)> for more information about this.
+L<Locale::Po4a::TransTractor(3pm)> for more information about this.
=head2 Unsupported formats
@@ -219,8 +219,8 @@
=head1 How to use po4a?
This chapter is a sort of reference manual, trying to answer the users'
-questions and giving a better understanding of the whole process. It
-introduce how to do things with po4a and serve as an introduction to the
+questions and to give you a better understanding of the whole process. This
+introduces how to do things with po4a and serve as an introduction to the
documentation of specific tools.
=head2 Graphical overview
@@ -233,28 +233,28 @@
for all modules. Each part of the picture will be detailed in the next
sections.
- fr.sgml original.sgml ---->--------+------>----------->-------+
- | | | |
- V V { update of original } |
- | | | |
+ fr.sgml original.sgml ---->--------+------>----------->-------+
+ | | | |
+ V V { update of original } |
+ | | | |
+--<---<--+ V |
- | | original.new.sgml----->------->----+
- V V | |
- [po4a-gettextize] +--->---->---+ |
- | | | V |
- | | | [po4a-updatepo] |
- | V ^ | V
- V original.pot | V |
- | | | fr.po |
- | | | (fuzzy) |
- | { translation } | | |
- | | ^ V V
- | | | {manual editing} |
- V V | | |
- | | | V V
+ | | original.new.sgml----->------->----+
+ V V | |
+ [po4a-gettextize] +--->---->---+ |
+ | | | V |
+ | | | [po4a-updatepo] |
+ | V ^ | V
+ V original.pot | V |
+ | | | fr.po |
+ | | | (fuzzy) |
+ | { translation } | | |
+ | | ^ V V
+ | | | {manual editing} |
+ V V | | |
+ | | | V V
| | +--<--- fr.po addendum original.sgml
+---->----+---->------->---> (up-to-date) (optional) (up-to-date)
- | | |
+ | | |
v v v
+------>-----+------<------+
|
@@ -274,7 +274,7 @@
didn't change are found, and previous translation are used. Parts which
where partially modified are also connected to the previous translation, but
with a specific marker indicating that the translation must be updated. The
-bottom of the figure shows how a formatted document is builded.
+bottom of the figure shows how a formatted document is built.
Actually, as a translator, the only manual operation you have to do is the
part marked {manual editing}. Yeah, I'm sorry, but po4a helps you translate.
@@ -738,7 +738,7 @@
This chapter gives you a brief overview of the po4a internals, so that you
may feel more confident to help us maintaining and improving it. It may also
help you understanding why it does not do what you expected, and how to
-solve your problem.
+solve your problems.
=head2 What's the big picture here?
@@ -755,7 +755,7 @@
the input po). Here is a graphical representation of this:
Input document --\ /---> Output document
- \ Transtractor:: / (translated)
+ \ TransTractor:: / (translated)
+-->-- parse() --------+
/ \
Input po --------/ \---> Output po
@@ -767,7 +767,7 @@
both input and disregard the output po, you get po4a-translate.
TransTractor::parse() is a virtual function implemented by each module. Here
-is a little example to show you how it works. It parses a list of paragraph,
+is a little example to show you how it works. It parses a list of paragraphs,
each of them beginning with <p>
1 sub parse {
@@ -828,7 +828,7 @@
paragraph paragraph
For that, po4a parsers are used on both the original and the translation
-files to extract po files, and then a third po file is builded from them
+files to extract po files, and then a third po file is built from them
taking strings from the second as translation of strings from the first. In
order to check that the strings we put together are actually the
translations of each other, document parsers in po4a should put informations
20 years, 5 months
[Po4a-devel][CVS] po4a/lib/Locale/Po4a Chooser.pm,1.13,1.14 Po.pm,1.13,1.14 Sgml.pm,1.25,1.26 TransTractor.pm,1.26,1.27
by Martin Quinson
Update of /cvsroot/po4a/po4a/lib/Locale/Po4a
In directory haydn:/tmp/cvs-serv2239/lib/Locale/Po4a
Modified Files:
Chooser.pm Po.pm Sgml.pm TransTractor.pm
Log Message:
Fix pod syntax
Index: Sgml.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Sgml.pm,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -d -r1.25 -r1.26
--- Sgml.pm 19 Jul 2004 10:21:12 -0000 1.25
+++ Sgml.pm 29 Jul 2004 01:27:51 -0000 1.26
@@ -82,6 +82,8 @@
optimisation. It can be useful if the document contains a construction like
"<title>&Acute;</title>", even if I doubt such things to ever happen...
+=back
+
=head1 STATUS OF THIS MODULE
The result is perfect. Ie, the generated documents are exactly the
Index: TransTractor.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/TransTractor.pm,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- TransTractor.pm 19 Jul 2004 10:21:12 -0000 1.26
+++ TransTractor.pm 29 Jul 2004 01:27:51 -0000 1.27
@@ -118,7 +118,6 @@
$my ($paragraph,$pararef,$line,$lref)=("","","","");
$my $first=1;
while (($line,$lref)=$document->shiftline() && defined($line)) {
- ($line,$lref)=$document->shiftline();
if ($line =~ m/<p>/ && !$first--; ) {
# Not the first time we see <p>.
# Reput the current line in input,
@@ -606,6 +605,7 @@
return 1;
}
+=back
=head1 INTERNAL FUNCTIONS used to write derivated parsers
@@ -752,8 +752,6 @@
Returns if the verbose option was passed during the creation of the
TransTractor.
-
-=back
=cut
Index: Po.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Po.pm,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- Po.pm 19 Jul 2004 20:31:17 -0000 1.13
+++ Po.pm 29 Jul 2004 01:27:51 -0000 1.14
@@ -333,6 +333,49 @@
}
return $pores;
}
+
+=item select_file()
+
+This function extract a catalog from an existing one. Only the entries having a
+reference in the given file will be placed in the resulting catalog.
+
+=cut
+
+sub select_file {
+ my $self=shift;
+ my $file=shift;
+
+ my $res;
+ $res = Locale::Po4a::Po->new();
+
+ for (my $cpt=(0) ;
+ $cpt<$self->count_entries();
+ $cpt) {
+
+ my ($msgid,$ref,$msgstr,$flags,$type,$comment,$automatic);
+
+ $msgid = $self->msgid($cpt);
+ $ref=$self->{po}{$msgid}{'reference'};
+ next unless ($ref =~ / $file:/);
+
+ $msgstr= $self->{po}{$msgid}{'msgstr'};
+ $flags = $self->{po}{$msgid}{'flags'};
+ $type = $self->{po}{$msgid}{'type'};
+ $comment = $self->{po}{$msgid}{'comment'};
+ $automatic = $self->{po}{$msgid}{'automatic'};
+
+ $res->push_raw('msgid' => $msgid,
+ 'msgstr' => $msgstr,
+ 'flags' => $flags,
+ 'type' => $type,
+ 'reference' => $ref,
+ 'comment' => $comment,
+ 'automatic' => $automatic);
+
+ }
+ return $res;
+}
+
=back
=head1 Functions to use a message catalogs for translations
Index: Chooser.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Chooser.pm,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- Chooser.pm 16 Jul 2004 04:13:39 -0000 1.13
+++ Chooser.pm 29 Jul 2004 01:27:51 -0000 1.14
@@ -99,6 +99,8 @@
L<Locale::Po4a::Html(3pm)>,
L<Locale::Po4a::Dia(3pm)>.
+=back
+
=head1 AUTHORS
Denis Barbier <barbier(a)linuxfr.org>
20 years, 5 months
[Po4a-devel][CVS] po4a po4a,1.12,1.13
by Martin Quinson
Update of /cvsroot/po4a/po4a
In directory haydn:/tmp/cvs-serv2239
Modified Files:
po4a
Log Message:
Fix pod syntax
Index: po4a
===================================================================
RCS file: /cvsroot/po4a/po4a/po4a,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -d -r1.12 -r1.13
--- po4a 19 Jul 2004 20:28:59 -0000 1.12
+++ po4a 29 Jul 2004 01:27:51 -0000 1.13
@@ -159,6 +159,8 @@
use Pod::Usage qw(pod2usage);
+use File::Temp;
+
use Locale::gettext;
use POSIX; # Needed for setlocale()
@@ -178,9 +180,10 @@
exit 0;
}
-my ($help,$type,$debug,@verbose,$quiet,@options);
+my ($help,$type,$debug,@verbose,$quiet,@options,$split);
@verbose = ();
$debug = 0;
+$split = 0;
my ($threshold)=(80);
Getopt::Long::config('bundling', 'no_getopt_compat', 'no_auto_abbrev');
GetOptions(
@@ -188,6 +191,7 @@
'verbose|v' => \@verbose,
'debug|d' => \$debug,
'quiet|q' => \$quiet,
+ 'split|s' => \$split,
'keep|k=s' => \$threshold,
'version|V' => \&show_version
) or pod2usage(1);
@@ -298,11 +302,11 @@
# make a big pot
if (-e $pot_filename) {
- print sprintf(gettext("Updating %s:")."\n",$pot_filename)
- if $verbose;
+ print sprintf(gettext("Updating %s:"),$pot_filename)
+ if $verbose;
} else {
- print sprintf(gettext("Creating %s:")."\n",$pot_filename)
- if $verbose;
+ print sprintf(gettext("Creating %s:"),$pot_filename)
+ if $verbose;
}
my $potfile=Locale::Po4a::Po->new();
@@ -317,16 +321,58 @@
}
$potfile->write($pot_filename);
+printf (gettext(" (%d entries)")."\n",$potfile->count_entries());
+
# update all po files
my $lang;
foreach $lang (sort keys %po_filename) {
if (-e $po_filename{$lang}) {
print STDERR sprintf(gettext("Updating %s: "),$po_filename{$lang})
- if $verbose;
- system ("msgmerge -U ".$po_filename{$lang}." $pot_filename ".($verbose?"":">/dev/null 2>/dev/null"))
- && die sprintf(gettext("Error while running msgmerge: %s"),$!)."\n";
- system "msgfmt --statistics -v -o /dev/null ".$po_filename{$lang}
- if $verbose;
+ if ($verbose);
+ if ($split) {
+ my ($pot_filename,$po_filename,$bigpo_filename);
+ (undef,$pot_filename)=File::Temp->tempfile("po4aXXXX",
+ DIR => "/tmp",
+ SUFFIX => ".pot",
+ OPEN => 0,
+ UNLINK => 0)
+ or die sprintf(gettext("Can't create a temporary pot file: %s"),$!)."\n";
+ (undef,$po_filename)=File::Temp->tempfile("po4aXXXX",
+ DIR => "/tmp",
+ SUFFIX => ".po",
+ OPEN => 0,
+ UNLINK => 0)
+ or die sprintf(gettext("Can't create a temporary po file: %s"),$!)."\n";
+ my ($poorig,$pores)=(Locale::Po4a::Po->new(),Locale::Po4a::Po->new());
+ $poorig->read($po_filename{$lang});
+
+ foreach my $master (sort keys %document) {
+ my $pot=Locale::Po4a::Po->new();
+ my $po=Locale::Po4a::Po->new();
+ print " $master:";
+ print "(pot)";
+ $pot=$potfile->select_file($master);
+ print "(po) ";
+ $po=$poorig->select_file($master);
+ unlink($pot_filename) if -e $pot_filename;
+ unlink($po_filename) if -e $po_filename;
+
+ $pot->write($pot_filename);
+ $po->write($po_filename);
+ system ("msgmerge -U $po_filename $pot_filename")
+ && die sprintf(gettext("Error while running msgmerge: %s"),$!)."\n";
+ $pores->read($po_filename);
+ }
+ $pores->write($po_filename{$lang}.".new");
+ unlink($pot_filename) if -e $pot_filename;
+ unlink($po_filename) if -e $po_filename;
+
+ } else {
+ system ("msgmerge -U ".$po_filename{$lang}." $pot_filename ".($verbose?"":">/dev/null 2>/dev/null"))
+ && die sprintf(gettext("Error while running msgmerge: %s"),$!)."\n";
+ system "msgfmt --statistics -v -o /dev/null ".$po_filename{$lang}
+ if $verbose;
+ }
} else {
print STDERR sprintf(gettext("Creating %s:")."\n",$po_filename{$lang})
if $verbose;
@@ -334,7 +380,6 @@
die sprintf(gettext("Error while copying the po file: %s"),$!)."\n";
}
}
-
# update all translations
foreach $lang (sort keys %po_filename) {
20 years, 5 months
[Po4a-devel][CVS] po4a/doc po4a.7.pod,1.22,1.23
by Martin Quinson
Update of /cvsroot/po4a/po4a/doc
In directory haydn:/tmp/cvs-serv2239/doc
Modified Files:
po4a.7.pod
Log Message:
Fix pod syntax
Index: po4a.7.pod
===================================================================
RCS file: /cvsroot/po4a/po4a/doc/po4a.7.pod,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -r1.22 -r1.23
--- po4a.7.pod 28 Jul 2004 11:28:49 -0000 1.22
+++ po4a.7.pod 29 Jul 2004 01:27:51 -0000 1.23
@@ -624,8 +624,11 @@
I<boundary> matching the I<end of a section>, so that the I<insertion point>
comes after it. In the latter case, you want to make a I<boundary> matching
the I<beginning of next section>, so that the I<insertion point> comes just
-before it. This can seem obscure, but hopefully, the next examples will
-enlighten you.
+before it.
+
+=back
+
+This can seem obscure, but hopefully, the next examples will enlighten you.
=over 2
20 years, 5 months
[Po4a-devel][CVS] po4a/lib/Locale/Po4a Html.pm,1.6,1.7 Xml.pm,1.4,1.5
by Martin Quinson
Update of /cvsroot/po4a/po4a/lib/Locale/Po4a
In directory haydn:/tmp/cvs-serv881
Modified Files:
Html.pm Xml.pm
Log Message:
Fix the pod syntax; add a big fat warning that the module is not ready for distribution yet
Index: Html.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Html.pm,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Html.pm 19 Jul 2004 10:21:12 -0000 1.6
+++ Html.pm 29 Jul 2004 01:26:27 -0000 1.7
@@ -38,6 +38,10 @@
Locale::Po4a::Html is a module to help the translation of documentation in
the HTML format into other [human] languages.
+Please note that this module is not distributed with the main po4a archive
+because we don't feel it mature enough for that. If you insist on using it
+anyway, check it from the CVS out.
+
=cut
package Locale::Po4a::Html;
Index: Xml.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Xml.pm,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- Xml.pm 25 Jul 2004 09:07:10 -0000 1.4
+++ Xml.pm 29 Jul 2004 01:26:27 -0000 1.5
@@ -40,6 +40,10 @@
other [human] languages. It can also be used as a base to build modules for
XML-based documents.
+Please note that this module is still under heavy developement, and not
+distributed in official po4a release since we don't feel it to be mature
+enough. If you insist on trying, check the CVS out.
+
=cut
package Locale::Po4a::Xml;
@@ -160,6 +164,8 @@
Space-separated list of the tags you want to treat as inline. By default,
all tags break the sequence. This follows the same syntax as the tags option.
+=back
+
=cut
sub initialize {
@@ -304,6 +310,8 @@
This function returns the translated tag (translated attributes or all needed
transformations) as a single string.
+=back
+
=cut
##### Generic XML tag types #####
@@ -494,6 +502,8 @@
=head2 WORKING WITH TAGS
+=over 4
+
=item get_path
This function returns the path to the current tag from the document's root,
@@ -657,6 +667,8 @@
matched tag options (the characters in front of the tag) or 1 (if that tag
doesn't have options).
+=back
+
=cut
sub tag_in_list {
@@ -700,10 +712,14 @@
=head2 WORKING WITH ATTRIBUTES
+=over 4
+
=item treat_attributes
TODO
+=back
+
=cut
sub treat_attributes {
@@ -851,12 +867,16 @@
=head2 WORKING WITH THE MODULE OPTIONS
+=over 4
+
=item treat_options
This function fills the internal structures that contain the tags, attributes
and inline data with the options of the module (specified in the command-line
or in the initialize function).
+=back
+
=cut
sub treat_options {
@@ -875,6 +895,8 @@
=head2 GETTING TEXT FROM THE INPUT STREAM
+=over
+
=item get_string_until
This function returns an array with the lines (and references) from the input
@@ -967,6 +989,8 @@
This function returns a simple string with the text from the argument array
(discarding the references).
+
+=back
=cut
20 years, 5 months
[Po4a-devel][CVS] po4a html-build-upload.sh,NONE,1.1
by Martin Quinson
Update of /cvsroot/po4a/po4a
In directory haydn:/tmp/cvs-serv32446
Added Files:
html-build-upload.sh
Log Message:
A little script to regenerate the documentation on http://po4a.alioth.debian.org
--- NEW FILE: html-build-upload.sh ---
#! /bin/sh
# Rebuild the documentation and upload this to the web server.
#
# it does use the Marek's implementation of the pod2html converter.
# You can find it from the CPAN, and I have a debian package of it on my
# my web page.
#
# Mt.
set -e
set -x
rm -rf html/
mkdir html/
mpod2html -dir=html doc/po4a.7.pod po4a po4a-gettextize po4a-translate po4a-updatepo po4a-normalize lib
(cd html ; ln -s podtoc.html index.html)
scp -r html/* po4a.alioth.debian.org:/var/lib/gforge/chroot/home/groups/po4a/htdocs/
20 years, 5 months
Re: [Po4a-devel][CVS] po4a/doc po4a.7.pod,1.21,1.22
by Martin Quinson
Yeah, I just updated the documentation. It's getting rather long and
complete now. Could you guys read it and report error/omissions ?
Then, I guess we should translate it. For example, I'm trying to get one
debian package converted, but the spanish translator is not sure he wants
his abits changed. It would be just really cool if you could get this to
spanish, Jordi. I know that's a lot of work, and I'd understand if you say
no. After all, it's not even in french ;)
Thanks, Mt.
--
It worries me however, to realize how tough an ass-hole I have had to be, in order
to get to stick to the principle of doing things right, rather than
"just hack it in".
--- Poul-Henning Kamp <phk(a)FreeBSD.org>
20 years, 5 months
[Po4a-devel][CVS] po4a/doc po4a.7.pod,1.21,1.22
by Martin Quinson
Update of /cvsroot/po4a/po4a/doc
In directory haydn:/tmp/cvs-serv19016
Modified Files:
po4a.7.pod
Log Message:
Major overhaul. Some parts were almost new rewritten.
I can give some gettextization tips, now that I tested it in real conditions.
The argument about "why po4a" was shorten a bit. The tool gets better, there is
less discusion about with it could be cool.
Addendum, the examples come before, showing that it's not that difficult.
Index: po4a.7.pod
===================================================================
RCS file: /cvsroot/po4a/po4a/doc/po4a.7.pod,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- po4a.7.pod 18 Jul 2004 09:23:49 -0000 1.21
+++ po4a.7.pod 28 Jul 2004 11:28:49 -0000 1.22
@@ -2,12 +2,14 @@
po4a - framework to translate documentation and other material
-=head1 DESCRIPTION
+=head1 Introduction
The po4a (po for anything) project goal is to ease translations (and more
interestingly, the maintenance of translations) using gettext tools on areas
where they were not expected like documentation.
+=cut
[...1462 lines suppressed...]
-the developer are very limited.
+The biggest issue (beside missing modules) is the encoding handling. Adding
+a UTF8 perl pragma and then recoding the strings on output is the way to go,
+but it's not done yet.
-To do the same, we should allow translators to put their addendum in the po
-file itself, as comment.
+We would also like to factorise some code (about file insertion) of the sgml
+module back into the TransTractor so that all module can benefit of this,
+but this is not user visible.
=head1 AUTHORS
- Denis Barbier <barbier(a)linuxfr.org>
- Martin Quinson <martin.quinson(a)tuxfamily.org>
+ Denis Barbier <barbier,linuxfr.org>
+ Martin Quinson <martin.quinson,tuxfamily.org>
=cut
20 years, 5 months
Re: [Po4a-devel][CVS] po4a/lib/Locale/Po4a Xml.pm,NONE,1.1
by Denis Barbier
On Sat, Jul 17, 2004 at 06:19:39PM +0000, Jordi Vilalta wrote:
[...]
> The goal po4a [po for anything] project is to ease translations (and more
> interestingly, the maintenance of translation) using gettext tools on areas
> where they were not expected like documentation.
Hi there,
This paragraph appears on every piece of documentation. My feeling is
that this is not plain English, so I rewrote it into something like:
The po4a (po for anything) project goal is to ease translations (and
more interestingly, the maintenance of translations) using gettext
tools on areas where they were not expected like documentation.
Other people made other fixes, so there are now 4 slightly different
paragraphs in po/pod/po4a-pod.pot, it would be nice if someone fluent in
English could propose a better wording so that all instances get fixed.
> use Locale::Po4a::TransTractor;
> use Locale::gettext qw(gettext);
> #is there any better (or more standard) package than this to recode strings?
> #use Locale::Recode;
IIRC Encode is now the standard way. About XML attributes, I read
posts from Daniel Veillard telling that good DTDs should never make
attributes translatable in XML, human readable data have to appear in
tag's body. Unfortunately I have no pointer, but this made sense to me.
Denis
20 years, 5 months
