On Tue, Oct 24, 2006 at 03:54:08PM +0200, Gour wrote:
> On Tue, 2006-10-24 at 01:11 +0200, Nicolas wrote:
>
>
> > I RTFM about texinfo, and indeed, it's possible to get nice pdf and html
> > outputs from texinfo.
>
> It's possible.
>
> > Gour was hesitating about the possibility to get a
> > nice pdf from the cinelerra.texi shipped with HV Cinelerra.
>
> LaTeX produces better output.
>
> > IMO, we should use texinfo, because it's far easier to use than latex. The
> > syntax is far easier to write and read. The manual won't contain math
> > formulas or complicated formatting, so texinfo should be sufficient.
>
> I don't agree.
>
> Is \chapter{SHORT CONTENTS} so complicated in comparison with:
>
> @chapter SHORT CONTENTS ?
>
> You cannot judge latex markup based on the job done by texi2latex
> script.
>
> I'd like to show you output of latex2texi script, but it does not exist
> 'cause it is probably not easy to convert latex stuff to texi 'cause
> latex supports more tex stuff.
>
> Besides that, my preference for latex is not due to capability to handle
> math-formulas - I did only classical books with it.
>
> otoh, who knows what will future bring - maybe you'll have to write
> formulas explaining conversion from one color space to another :-)
>
> Moreover, I told you about LyX (LaTeX front-end) which makes writing
> even more easy - for simple layout there is almost no need to use
> latex-code for tweaking the output.
>
> New LyX (1.4.x) has option for Change tracking
> (http://wiki.lyx.org/LyX/NewInLyX14#toc3)
>
> which makes collaboration very snappy.
>
>
> > Any comment and participation is welcome. ;-)
>
> From your emails and talk on IRC it looks you are also not familiar with
> texinfo format, so it means that both of us should learn new markup for
> working on cinelerra which makes me not so enthusiastic to work on it -
> I won't use texinfo for any other project 'cause lyx/latex are
> satisfying all my typesetting needs since '99.
>
> What is your main objective against lyx/latex ?
>
> My pros are:
>
> - superior typesetting & pdf output
> - runs on multi-platforms and used by large community
> - easy to use front-end (lyx) with collaboration feature which makes it
> easy for people to join the team
>
>
> Sincerely,
> Gour
Gour,
> - superior typesetting & pdf output
IMO, the result with texinfo is quite nice:
http://www.europephoto.com/info/cinelerra/200610/cinelerra.pdf
The problem was that the original cinelerra.texi texinfo file contained
a lot of missing commands and errors, which made it not ready to be
converted to a .pdf file.
There was also a problem with some .png images, which I solved.
Here are the files which can be used to get the .pdf file:
http://www.europephoto.com/info/cinelerra/200610/20061024_1_Cinelerra_Manual.tgz
For those of you who would like to convert the texinfo file to a pdf
file, all you need is to use that command:
texi2pdf -q --pdf cinelerra.texi
The .pdf file is generated without any error. ;-)
> - runs on multi-platforms and used by large community
Texinfo is a standard GNU tool. The manual is here:
http://www.gnu.org/software/texinfo/manual/texinfo/
I think tools available on www.gnu.org are used on a lot of plateform.
Texinfo is 200% stable since several years.
Its syntax is quite easy as I said. It's so simple that you don't need
any GUI at all to edit it.
I'm a "vim guy", but for those of you who use Emacs, that (GNU) tool is
perfect for editing texinfo files.
> - easy to use front-end (lyx) with collaboration feature which makes it
> easy for people to join the team
IMO, people who would like to help maintaining the manual won't get any
problem to edit a text file.
Here's a message I got from Karl Berry who is the official maintainer of
texinfo since 2003, and participated in writing the texinfo official
manual. I asked him some advice about the format to choose.
"I would encourage you to keep it in Texinfo, because (a) that will make
it easier for you to import changes in the "official" manual, and (b) it
is lot easier to generate decent html (and plain text and info and xml)
from Texinfo than from LaTeX, and no harder to generate pdf."
I'm now working on the html output. It can be splited over several
files. That would allow Hermanr to use them in a contextual help.
Nicolas.
_______________________________________________
Cinelerra mailing list
[email protected]
https://init.linpro.no/mailman/skolelinux.no/listinfo/cinelerra
