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" <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 <javascript:>. > > To post to this group, send email to sphinx...@googlegroups.com > <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 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.