docutils-users Mailing List for Docutils: Documentation Utilities

Tibs (Tony J. Ibbs) wrote:
 > But...

I think that's got it now.  If you're following docutils-checkins, I'm
much more sure of the code now.  Please exercise it every way you can
think.

BTW, it's a milestone: Docutils now contains 700 unit tests.

 > (incidentally, and entirely separately, where do those "colwidth"
 > values come from? If they are indeed just the width in characters of
 > the table entries,

You got it.

 > then the width of the ".. include::" statement is clearly being used
 > for the left column, which is both a mistake and (I'd guess) a pain
 > to fix.)

I don't know if it's a mistake, but it certainly would be a pain to
fix.  It'd be easier to remove all colwidth info.  I'll wait for
convincing arguments and suggestions on how to tackle it.

-- 
David Goodger    http://starship.python.net/~goodger
For hire: http://starship.python.net/~goodger/cv
Docutils: http://docutils.sourceforge.net/
(includes reStructuredText: http://docutils.sf.net/rst.html)

But...

I now have a file, index2.txt containing::

  Something before.

  +--------------------------+
  | .. include:: ./left1.txt |
  +--------------------------+

  Something afterwards.

whilst file left1.txt contains::

  This text.

When I now run html.py on index2.txt, with output to index2.html, I
don't get the "Something afterwards".

Attempting to study this a little further: using quicktest -p on said
file, the result is::

  <document source="index2.txt">
      <paragraph>
          Something before.
      <table>
          <tgroup cols="1">
              <colspec colwidth="26">
              <tbody>
                  <row>
                      <entry>
                          <paragraph>
                              This text.

which matches what I am observing in the HTML result (i.e., it's not the
Writer that is at fault).

(incidentally, and entirely separately, where do those "colwidth" values
come from? If they are indeed just the width in characters of the table
entries, then the width of the ".. include::" statement is clearly being
used for the left column, which is both a mistake and (I'd guess) a pain
to fix.)

Unfortunately, it's now my bedtime, so I can't look any further tonight,
and shan't have time to try to explore tomorrow (family commitments). I
*shall* understand entirely if you put this aside for the moment as a
not-terribly-urgent issue, and maybe (I still remember that "wimp"!) I
should try to follow it through on Monday.

All the best,
	Tibs
 

On Sat, 05 Jul 2003 15:48:04 -0400 David Goodger <go...@py...> wrote:
> Try it now.

Thanks - that now works, as does the slightly more complex example I was
actually trying for.

>  > and at that point I get lost in a maze of little callbacks, and punt
>  > to David.
> 
> Wimp ;-)

Oh, definitely - I reckon knowing when to give up and bring in the big
guns is a useful life skill.

> This was actually pretty tricky to debug, but the code is cleaner now.

So thanks (as ever) for the quick response.

All the best,
	Tibs

Tibs (Tony J. Ibbs) wrote:
 > Innocently enough (believe it if you must), I tried including
 > another file inside a table. Specifically, I have an reST file
 > containing::
 >
 >     +-----------------------+
 >     | .. include:: left.txt |
 >     +-----------------------+
 >
 > (and only that). When I run html.py on it, it falls over.

Try it now.

 > and at that point I get lost in a maze of little callbacks, and punt
 > to David.

Wimp ;-)

This was actually pretty tricky to debug, but the code is cleaner now.

-- 
David Goodger    http://starship.python.net/~goodger
For hire: http://starship.python.net/~goodger/cv
Docutils: http://docutils.sourceforge.net/
(includes reStructuredText: http://docutils.sf.net/rst.html)