[issue4145] tabulary entries in PDF documentation

[Georg Brandl]

Changes by Georg Brandl :


--
assignee: georg.brandl -> 

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Ezio Melotti]

Changes by Ezio Melotti ezio.melo...@gmail.com:


--
stage:  - needs patch
versions: +Python 2.7, Python 3.3, Python 3.4 -Python 2.6, Python 3.0

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Changes by Winfried Plappert [EMAIL PROTECTED]:


--
components: +Documentation tools (Sphinx) -Documentation

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

Here is the screenshot: ABCs-2.png

Added file: http://bugs.python.org/file11835/ABCs-2.png

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

There are some 200 tables in the 2.6 documentation, 150 alone in
library.tex - and a few less in the 3.0rc1 documentation. So may suggest
a course of action: since most of these tables produces reasonable
results by using your automatic layout, there are only a few to tackle
manually. You could invent a new keyword e.g. relativecolumnwidth,
which then renders the table in the above style, based on effective
paper width and based on column widths in the *.rst files.

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

An the PDF view of the same table

Added file: http://bugs.python.org/file11828/Screenshot-library.pdf - Adobe 
Reader.png

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

New submission from Winfried Plappert [EMAIL PROTECTED]:

I wonder if the readabiliy of tables in PDFs can be improved. I take the
example of ABCs. The online documentation can be found at
http://docs.python.org/library/collections.html, the rst source is at
/Doc/library/collections.rst. I'll enclose two png files, which show the
table in HTML format and in PDF format. My PDF reader is Adobe Acrobat
Reader 8.1.2 (Ubuntu), but I also tried xpdf and Evince Document Viewer
2.22.2. The result is the same that the coulumn width is somehow not
calculated correctly. Any ideas?

PS.: Since I can only upload one file at a time, there will be another
entry soon.

--
assignee: georg.brandl
components: Documentation
files: Screenshot-collections — High-performance container datatypes — Python 
v2.6 documentation - Mozilla Firefox.png
messages: 74969
nosy: georg.brandl, wplappert
severity: normal
status: open
title: tabulary entries in PDF documentation
type: behavior
versions: Python 2.6, Python 3.0
Added file: http://bugs.python.org/file11827/Screenshot-collections — 
High-performance container datatypes — Python v2.6 documentation - Mozilla 
Firefox.png

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Georg Brandl]

Georg Brandl [EMAIL PROTECTED] added the comment:

The only way to get this right for arbitrary tables is to hand-select
the column widths with a tabularcolumns directive.

I'll keep this issue open and optimize these columns step by step.

--
priority:  - normal

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

Oh, what a pain, if you have to do it by hand! Is there no other way of
doing it by counting record lengths (in a column) - see below?

Just for the grins of it, I modified collections.html a bit to show more
on the first page. Then I printed a PDF copy of the online web pages. I
include that print as reference. 

When looking at the HTML source, I find the following lines at the
beginning of the relevant table:

table border=1 class=docutils
colgroup
col width=21% /
col width=18% /
col width=18% /
col width=43% /
/colgroup

And the the first table line follows:
thead valign=bottom
trth class=headABC/th
th class=headInherits/th
th class=headAbstract Methods/th
th class=headMixin Methods/th
/tr
/thead

So somebody is calculating the column width :) And this somebody - I
guess - is Sphinx? Is is possible to do the same for latex? Hmmm.

Added file: http://bugs.python.org/file11829/collections_pdf.png

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

I probed a bit more into HTML output and the column width of tabulary
entries is always present in the HTML output. I don't yet know where
these relative widths are calculated, but I do roughly know how they are
calculated: from the width of table definition in the *.rst files. This
information should be sufficient to define a (relative) width instead of
the generic latex command \begin{tabulary}{\textwidth}{|L|L|L|L|}.

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Georg Brandl]

Georg Brandl [EMAIL PROTECTED] added the comment:

The advantage of HTML here is that the browser dynamically adjusts the
column widths to prevent things like in your screenshot from happening.
LaTeX does no such thing. If you tell it that the column width 20%, the
column will not be enlarged to fit if the contained text is longer.

Standard LaTeX tables don't even bother with relative widths: if you
don't explicitly set a width for a column, the column will be stretched
so that all text fits in one line, no matter how wide the table gets.

The L tabulary entry is the best compromise I could find for automatic
handling: it calculates widths based on cell contents. But as said
above, no handling of overlapping text is done, and I couldn't find a
package that helps with that problem.

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

Hi Georg,
the only thing I could find on the net is a reference to:
\begin{tabular}{p{1in}p{2in}} at
http://www.cs.cornell.edu/Info/Misc/LaTeX-Tutorial/Tables.html. Assuming
that one knows the effective width of the whole table, one then should
be able to calculate the width of a column based on previous information
in the *.rst files. Since I really don't know anything about LaTeX - and
you certainly do, I should better shut up and don't say anything more.
But indeed, this table business in LaTeX seems to be a bit messy.

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Winfried Plappert [EMAIL PROTECTED] added the comment:

Hi Georg,
I tried to find a few bones and came up with the following little demo.
I pinched the first few lines from
http://www.latex-community.org/viewtopic.php?f=5t=910 and set up a
table with defined column widths - see attached file.

Added file: http://bugs.python.org/file11833/test_latex-2.tex

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue4145] tabulary entries in PDF documentation

[Winfried Plappert]

Changes by Winfried Plappert [EMAIL PROTECTED]:


Added file: http://bugs.python.org/file11834/test_latex-2.tex

___
Python tracker [EMAIL PROTECTED]
http://bugs.python.org/issue4145
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com