5:09 a.m.
Wine's DobBook documentation is in SGML but I also tried the DocBook.pm
module on it. The nice thing is that it translates the 'lang' attribute.
The bad thing is that it does not handle including files using entities
and this is extensively used in Wine's documentation :-(.
Anyway, during this test I added the XML prologue recommended by the
DocBook documentation:
http://www.docbook.org/tdg/en/html/ch02.html#ch02-makexml
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//Norman Walsh//DTD DocBk XML V3.1.4//EN"
"http://nwalsh.com/docbook/xml/3.1.4/db3xml.dtd">
This caused the Xml.pm module to emit some 'Use of uninitialized value'
warnings because the <?xml> tag did not specify the encoding. That was
(or seemed) easy to fix so here's an hopefully correct patch:
Changelog:
* po4a/lib/Locale/Po4a/Xml.pm
Francois Gouget <fgouget(a)free.fr>
Append the encoding attribute if it is not defined in the <?xml> tag.
--
Francois Gouget fgouget(a)free.fr http://fgouget.free.fr/
$live{free} || die "";
11:13 a.m.
Hi,
On Thu, 19 May 2005, Francois Gouget wrote:
Wine's DobBook documentation is in SGML but I also tried the
DocBook.pm
module on it. The nice thing is that it translates the 'lang' attribute. The
bad thing is that it does not handle including files using entities and this
is extensively used in Wine's documentation :-(.
One solution would be to use configuration files (see po4a(1)) to
translate the files separated, and obtain a hierarchy like the original
document's one.
If it's very annoying (if there are lots of files to insert into the
config file...) I'll try to implement the file inclusion this summer. (I'm
out of time currently)
Anyway, during this test I added the XML prologue recommended by the
DocBook
documentation:
[...]
This caused the Xml.pm module to emit some 'Use of uninitialized value'
warnings because the <?xml> tag did not specify the encoding. That was (or
seemed) easy to fix so here's an hopefully correct patch:
I've just commited the attached patch.
Regards,
Jordi Vilalta
7:02 a.m.
New subject: [Po4a-devel]File inclusion belongs to TransTractor directly
On Sat, May 21, 2005 at 06:13:56PM +0200, Jordi Vilalta wrote:
Hi,
On Thu, 19 May 2005, Francois Gouget wrote:
>Wine's DobBook documentation is in SGML but I also tried the DocBook.pm
>module on it. The nice thing is that it translates the 'lang' attribute.
>The bad thing is that it does not handle including files using entities
>and this is extensively used in Wine's documentation :-(.
One solution would be to use configuration files (see po4a(1)) to
translate the files separated, and obtain a hierarchy like the original
document's one.
If it's very annoying (if there are lots of files to insert into the
config file...) I'll try to implement the file inclusion this summer. (I'm
out of time currently)
File inclusion should be easy to implement outside the Sgml.pm module.
That's indeed a shame that this is implemented in the module where it's the
more complicated (using an external parser requires a load of bookkeeping to
indicate the right position on error messages) and not in the others.
I guess that we just need a include_file(filename) function in TransTractor.pm
Its action would be much like the read() function already there. You only
need to read into a new array instead of @{$self->{TT}{doc_in}} Then, when
you got all the file,
while (defined(my ($l,$ref) = pop @newarray) {
$self->unshiftline($l,$ref);
}
or so. Ie, insert the content of the new file in the working spaces. I'll do
the trick for all modules using the popline function. Ie, Man.pm and Xml.pm
(for now. One day, Sgml.pm will be in this list).
I hope it makes sense to someone with more free time than me ;) If you want
to proceed and implement this, please go ahead.
Bye, Mt.
7:17 a.m.
New subject: [Po4a-devel]File inclusion belongs to TransTractor directly
On Tue, May 24, 2005 at 02:02:54PM +0200, Martin Quinson wrote:
I hope it makes sense to someone with more free time than me ;) If
you want
to proceed and implement this, please go ahead.
I will try to see if what was done in the TeX module can be extracted and
used by other modules (IIRC, it adds some hook in Transtractor's read)
--
Nekral
12:31 p.m.
On Sat, 21 May 2005, Jordi Vilalta wrote:
[...]
One solution would be to use configuration files (see po4a(1)) to
translate
the files separated, and obtain a hierarchy like the original document's one.
If it's very annoying (if there are lots of files to insert into the config
file...) I'll try to implement the file inclusion this summer. (I'm out of
time currently)
Thanks for the offer but for now I think I'll stick with the Sgml module
as Wine's documentation is not yet XML-based anyway.
> Anyway, during this test I added the XML prologue recommended by
the
> DocBook documentation:
> [...]
> This caused the Xml.pm module to emit some 'Use of uninitialized value'
> warnings because the <?xml> tag did not specify the encoding. That was (or
> seemed) easy to fix so here's an hopefully correct patch:
I've just commited the attached patch.
Cool. Thanks!
--
Francois Gouget fgouget(a)free.fr http://fgouget.free.fr/
RFC 2549: ftp://ftp.isi.edu/in-notes/rfc2549.txt
IP over Avian Carriers with Quality of Service
7121
days inactive
7126
days old
4 comments
4 participants
participants (4)
-
Francois Gouget -
Jordi Vilalta -
Martin Quinson -
Nicolas François