On Wednesday, October 26, 2016 at 4:30:07 PM UTC-7, Warren Block wrote:
On Wed, 26 Oct 2016, Peter Burdine wrote:
The following worked fine for me:
.. tabularcolumns:: |>{\RaggedRight}p{\dimexpr 0.3\linewidth-2\tabcolsep}
|>{\RaggedRight}p{\dimexpr 0.4\linewidth-2\tabcolsep}
|>{\RaggedLeft}p{\dimexpr 0.3\linewidth-2\tabcolsep}|
.. _tasks_rsync_opts_tab:
.. table:: Rsync Configuration Options
:class: longtable
+------------+----------+----------------+
| Setting | Value | Description |
+------------+----------+----------------+
| Setting | Value | Description |
+------------+----------+----------------+
Not here, the same ! Undefined control sequence error as before. My
guess is this is some TeX stuff that would normally be included from a
file that is not present on my system.
Also, the commands are l, r, and c, not L, R, C. So the following also works:
.. tabularcolumns:: |r|r|l|
In fairness,
http://www.sphinx-doc.org/en/1.4.8/markup/misc.html?highlight=tabularcolumns
shows this in an ambiguous form. An example of actual usage would be
useful there. Or in so many other places in the Sphinx docs.
Actually, the more I look at that explanation, the less clear it
becomes.
(Much experimentation later...)
The "p notation" vaguely mentioned in the docs is p{}, with a width
value and unit in the brackets, like 'p{1.0in}'. Used alone, this value
specifies an absolute width for a column, with the default being
fill-justified, wrapped text in that column. Example:
.. tabularcolumns:: |p{1.0in}|p{1.2in}|p{3.8in}|
That gives a three-column table with fill-justified, wrapped text in
each column.
'l' and 'r' are used to left- or right-justify *and prevent wrapping*.
These letters can be added after the p{} width, but doing so resulted in
unpredictable column rendering. I did not find a way to get specific or
relative column widths without fill-justification and word breaks.
The upper-case letters mentioned did not work in any context I tried,
with or without the p{} width. It is not clear why they are shown at
all, or whether that is some misguided capitalization of a name that is
not actually meant to be capitalized.
See https://en.wikibooks.org/wiki/LaTeX/Tables
I always specify the width I want for PDF output to ensure that latex
doesn't do anything weird with the wrapping or have text run into the
next cell. Normally I use
list tables because I think they are easier to maintain (and contain
other nodes, like lists and admonitions), so I am not sure if the same
behavior happens with
simple tables.
On Tuesday, October 25, 2016 at 3:48:21 PM UTC-7, Warren Block wrote:
On Tue, 25 Oct 2016, Peter Burdine wrote:
>
> Please post the tabularcolumns directive you are using and
enough of the table definition to see the first header row. There
isn't enough info to see
what the issue could be.
>
> One thing to verify is that the number of columns in the
tabularcolumns directive is the same as the actual table.
Sorry, here's a bit:
.. tabularcolumns:: |R|R|L|
.. _tasks_rsync_opts_tab:
.. table:: Rsync Configuration Options
:class: longtable
+------------+----------+----------------+
| Setting | Value | Description |
This produces
! Missing # inserted in alignment preamble.
<to be read again>
\cr
l.5164 \begin{longtable}{|p{1.0cm}|p{1.0cm}|L|}
The \RaggedRight colspec produces the "undefined control sequence" shown
earlier. Using |p{1.0cm}|p{1.0cm}|L| gives
! Missing # inserted in alignment preamble.
<to be read again>
\cr
l.5164 \begin{longtable}{|p{1.0cm}|p{1.0cm}|L|}
I have no preamble, so maybe it's that. Or maybe another extension is
needed, at the moment only ifconfig and httpdomain are declared. But
without the tabularcolumns directive, it does produce a PDF.
Thanks!
> On Oct 24, 2016 4:40 PM, "Warren Block"
<wbl...@wonkity.com> wrote:
> On Mon, 10 Oct 2016, Peter Burdine wrote:
>
> Sphinx tables in latex are inconsistent at the
moment. There is a ticket open to use just one package for tables, but
right now I think it
picks 1 of 4(?) packages depending on what it thinks it best. In
all of the
> documentation we write, I always
> add :class: longtable to all of the table
definitions to allow for (what I think) is better layout, plus the
header/footer for continuations.
>
> You can format the columns and overall table width
using the tabularcolumns directive, eg
> .. tabularcolumns:: |>{\RaggedRight}p{\dimexpr
0.3\linewidth-2\tabcolsep}
> |>{\RaggedRight}p{\dimexpr
0.5\linewidth-2\tabcolsep}
> |>{\RaggedRight}p{\dimexpr
0.2\linewidth-2\tabcolsep}|
>
> Adding that everywhere tends to get annoying
quickly, plus is is difficult for most people understand what is going
on (FYI this produces a
table with 3 columns, all left aligned, with 30%, 50%, and 20% of
the page widths).
>
>
> What else is needed to use this? If I add it, PDF creation
halts in the middle, with
>
> ! Undefined control sequence.
> <template> ...inewidth -2\tabcolsep }\RaggedRight
> \ignorespaces
> l.5169 \textsf
> {\relax
> ?
>
> This is sphinx 1.4.6.
>
> --
> You received this message because you are subscribed to a topic
in the Google Groups "sphinx-users" group.
> To unsubscribe from this topic, visit
https://groups.google.com/d/topic/sphinx-users/LBGxmGESUhg/unsubscribe.
> To unsubscribe from this group and all its topics, send an
email to
sphinx-users...@googlegroups.com.
> To post to this group, send email to
sphinx...@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>
>
> --
> You received this message because you are subscribed to the
Google Groups "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from
it, send an email to
sphinx-users...@googlegroups.com.
> To post to this group, send email to
sphinx...@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>
>
--
You received this message because you are subscribed to the Google
Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to
sphinx-users...@googlegroups.com.
To post to this group, send email to
sphinx...@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google
Groups "sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to
sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to
sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.