Sorry about that, now that I think about it, that requires the following in
your preamble:
\usepackage{array,ragged2e}
Sorry about that, it is difficult to remember all of the requirements.
Does that help?
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" <[email protected]>
> 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 [email protected].
> > > To post to this group, send email to [email protected].
>
> > > 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 [email protected].
> > > To post to this group, send email to [email protected].
>
> > > 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 [email protected] <javascript:>.
> > To post to this group, send email to [email protected]
> <javascript:>.
> > 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 [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
