docutils-develop

[Docutils-develop] Functionnal LaTeX writer

[Julien T. L. <me...@fr...>]

Hi list,

I decided that I loved reST a few days ago, and that I'd love it even
more if it could output LaTeX. So I found this preliminary LaTeX
writer file in Engelbert Gruber's sandbox directory, and I improved it (that
is, made it a bit more functionnal).

I don't know if this fits somewhere in your developement process, but anyways,
here's my current version of the thing. I'm using it against my daily docutils
CVS checkout.

Tell me if you find it useful ;)

Cheers,
-- 
Julien T. Letessier     email: co...@me...
ENSIMAG Student         web: http://www.mezis.net

Re: [Docutils-develop] Functionnal LaTeX writer

[<eng...@ss...>]

On Thu, 19 Sep 2002, Julien T. Letessier wrote:

> Hi list,
>
> I decided that I loved reST a few days ago, and that I'd love it even
> more if it could output LaTeX. So I found this preliminary LaTeX
> writer file in Engelbert Gruber's sandbox directory, and I improved it (that
> is, made it a bit more functionnal).
>
> I don't know if this fits somewhere in your developement process, but anyways,
> here's my current version of the thing. I'm using it against my daily docutils
> CVS checkout.
>
> Tell me if you find it useful ;)

of course.

* what is your input ?
* how does your style.tex look like ?

my article class does not support subtitle ?
"""
Document
========

and this
--------
"""
tries to put subtitle{and this}

* why did verbatim not work for you.

sorry the server did not respond.

-- 
 BINGO: This left unindentionally unblank
 --- Engelbert Gruber -------+
 SSG Fintl,Gruber,Lassnig   /
 A6410 Telfs Untermarkt 9  /
 Tel. ++43-5262-64727 ----+

Re: [Docutils-develop] Functionnal LaTeX writer

[David G. <go...@us...>]

Julien T. Letessier wrote:
> I decided that I loved reST a few days ago, and that I'd love it
> even more if it could output LaTeX. So I found this preliminary
> LaTeX writer file in Engelbert Gruber's sandbox directory, and I
> improved it (that is, made it a bit more functionnal).

Julien, merci!

Engelbert, are you planning on continuing development of the LaTeX
writer or the PDF writer in the near future?  Or would it be OK if
Julien or someone else took over?

Engelbert and Julien, would either or both of you be willing to
complete the writer?  "Complete" doesn't mean it has to be perfect,
just that it handles all Docutils constructs, as the current
html4css1.py does.  Once complete, I'd like to put it into the main
source tree.  Try running it over tools/test.txt to see where the
issues are.

I've been maintaining the HTML writer.  Once the LaTeX writer is in
place, it will be maintained as well, hopefully with the assistance of
people with more TeX knowledge than I.

A technical issue: please don't use hard tabs in the source files.
Use 4 spaces per indent level instead.  See:

    http://docutils.sf.net/spec/notes#coding-conventions

> I don't know if this fits somewhere in your developement process,

The process is loose and flexible.  For details of the development
process as it stands, please read:

    http://docutils.sf.net/spec/notes#project-policies

> Tell me if you find it useful ;)

I'm sure some people will.  With more format writers, Docutils will
become more useful, and its audience will become broader.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/

Re: [Docutils-develop] Functionnal LaTeX writer

[<gr...@us...>]

On Thu, 19 Sep 2002, David Goodger wrote:

> Julien T. Letessier wrote:
> > I decided that I loved reST a few days ago, and that I'd love it
> > even more if it could output LaTeX. So I found this preliminary
> > LaTeX writer file in Engelbert Gruber's sandbox directory, and I
> > improved it (that is, made it a bit more functionnal).
>
> Julien, merci!
>
> Engelbert, are you planning on continuing development of the LaTeX
> writer or the PDF writer in the near future?  Or would it be OK if
> Julien or someone else took over?
i am willing to continue, but i have no time for theoretical work
means the writer is finished as sson as it fullfills what is needed

and i can see some problem s coming up,
interesting for all the project, because this would be the
second writer, but bigger ones, because the first writer and
the whole thing is targeted at html.

html for instances has no page length and no pagewidth, latex needs
this.

if it is ok for julien he could use my sandbox too
, if he needs his own for this, this is ok too

>
> Engelbert and Julien, would either or both of you be willing to
> complete the writer?  "Complete" doesn't mean it has to be perfect,
> just that it handles all Docutils constructs, as the current
> html4css1.py does.  Once complete, I'd like to put it into the main
> source tree.  Try running it over tools/test.txt to see where the
> issues are.
>
> I've been maintaining the HTML writer.  Once the LaTeX writer is in
> place, it will be maintained as well, hopefully with the assistance of
> people with more TeX knowledge than I.

>
>

-- 
 BINGO: Berichten Sie gegen den Projektplan
 --- Engelbert Gruber -------+
 SSG Fintl,Gruber,Lassnig   /
 A6410 Telfs Untermarkt 9  /
 Tel. ++43-5262-64727 ----+

Re: [Docutils-develop] Functionnal LaTeX writer

[<gr...@us...>]

> > Engelbert, are you planning on continuing development of the LaTeX
> > writer or the PDF writer in the near future?  Or would it be OK if
> > Julien or someone else took over?
actually i currently have a project where docutils with a latex
writer might help me, so i will continue.

rlpdf is on hold for several reasons
* no one needs it currently
* pdflatex should do it and would do it better as developing the
  linebreaking in python/ps seams to be heavy.
* ..

-- 
 BINGO: Remarkable bird, the Norwegian Blue.
 --- Engelbert Gruber -------+
 SSG Fintl,Gruber,Lassnig   /
 A6410 Telfs Untermarkt 9  /
 Tel. ++43-5262-64727 ----+

Re: [Docutils-develop] Functionnal LaTeX writer

[David G. <go...@us...>]

[David]
>>> Engelbert, are you planning on continuing development of the LaTeX
>>> writer or the PDF writer in the near future?  Or would it be OK if
>>> Julien or someone else took over?

[Engelbert]
> i am willing to continue, but i have no time for theoretical work
> means the writer is finished as sson as it fullfills what is needed

Let me presume to state that what is needed is to completely and
correctly process the tools/test.txt file.  That's all! ;-)

> and i can see some problem s coming up, interesting for all the
> project, because this would be the second writer, but bigger ones,
> because the first writer and the whole thing is targeted at html.

Docutils is not targeted at HTML.  It's just that the HTML writer is
the only one of real significance.  The XML writer is trivial, and
easily ignored.  Until there's another major Writer, it's easy to
understand the mistaken perception that Docutils is HTML-oriented.

> html for instances has no page length and no pagewidth, latex needs
> this.

The LaTeX writer can define its own command-line options and config
file settings.

> actually i currently have a project where docutils with a latex
> writer might help me, so i will continue.

Great!  I hope you and Julien can work together on this.  It would be
wonderful to get another major Writer in Docutils.

> rlpdf is on hold for several reasons
> * no one needs it currently

I don't know about that.  If it existed, I'm sure there would be
users.  I've seen requests several times for PDF output.  However:

> * pdflatex should do it and would do it better as developing the
>   linebreaking in python/ps seams to be heavy.

If that's a better route, then by all means pursue it.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/

Re: [Docutils-develop] Functionnal LaTeX writer

[Julien T. L. <me...@fr...>]

Hi list,
Hi Engelbert,

> * what is your input ?

The Docutils README.txt.
But I'm going to try it with test.txt, as suggested ;)

> * how does your style.tex look like ?

It just sets a few lengths. It was supposed (as you probably guessed) to be
used as the equivalent of a CSS.

> my article class does not support subtitle ?
> """
> Document
> ========
>
> and this
> --------
> """
> tries to put subtitle{and this}

I don't know about this construct... But I'll try to solve the problem.

> * why did verbatim not work for you.

Because of encode(): since all of the text inside nodes finally gets
encode()d, I had to encode underscores, ampersands, etc., which get
interpreted as erroneous math-mode characters by TeX.

But then, if I use verbatim, stuff like {\_} appear in the output (of course);
the \obeylines\obeyspaces substitute seemed to work fairly well, and I
couldn't think of a better solution...

I'm improving latex2e.py a lot today; I want it to transform tools/test.txt
about correctly. I'll post the new version once I'm done :)

Cheers,
-- 
Julien T. Letessier     email: co...@me...
ENSIMAG Student         web: http://www.mezis.net