[Po4a-devel]Sharing bold/emphasis marker between modules

Martin Quinson mquinson@ens-lyon.fr
Tue, 20 Jul 2004 21:00:12 -0700


> > > > But if I had to redo the man module now, I'd go for docbook-like tag intead
> > > > of pod notation. But I don't plan to change that for now...
> > > 
> > > I think this isn't necessary by now.
> > 
> > It could be made an option, but the issue is that if the author makes its
> > pot with one notation and the translator with another, you'll get fuzzies.
> 
> I think we should take an arbitrary decision and don't include this 
> option, to avoid this issue about the fuzzies (and to reuse translations 
> between projects, where each one could use a different option).
> 
> Then, we should decide between one of these:
>  1) we use the same tag syntax for all the modules: this makes po4a more 
>     consistent (now that it's easy to mix more than one document format 
>     with po4a(1)), and maybe some translations could be reused between 
>     formats
>  2) each module can use its own format tagging: it makes modules easier to 
>     write
> 
> In my personal opinion, I also like the docbook tagging more than the pod 
> one. I'd like to follow the 1) option, although it's a lot of work for 
> reworking the current man/pod modules.
> 
> > Unless you implement also a on the fly convertion, but I'm not sure it
> > worths the work. 
> 
> It's an unnecesary complication.

I agree that 1) is the best, at the first glance.

It wouldn't be that difficult to do in the Man module. There is already a
conversion between the native representationS from/to the pod one. Changing
it would be rather easy.

Borrowing this into the pod module wouldn't be that hard either.

And since po4a is getting used outthere, I'd say that we do have to
implement this as an option, with the on-the-fly conversion. That's not very
difficult either.

But, you'll get ugly results if you have to mix between native formatting
and common formatting. I mean, let's say we use the pod formating. How to
deal with the (sg|x)ml "<a href=toto><b>bla</b></a>"

I know that we would not take pod as common format, and that all marker of
pod/man can be formated to ml ones, but it will change when another module
for a more complete format gets finally implemented (texinfo comes to
mind)...

Moreover, my current concern with po4a are:
 - getting new blood here. New users, new contributor, new feedback.
 - put the file inclusion into the main modules
 - encoding
 - get ride of nsgml
 - texinfo module
 ...
 

Bye, Mt.

-- 
Freedom is not free.