[OpenStack-docs] Improving tables for RST guides

Meg McRoberts dreidellhasa at yahoo.com
Sun Nov 15 22:24:02 UTC 2015


Yeah, RST tables suck.  I'm finding that using list-table is a lot easier andat least allows me to specify the column widths.  For example:
.. list-table::  :widths: 25 25 50  :header-rows: 1
Gives three columns; each of the first two columns consume 25% of the pagewidth and the third column consumes the remaining 50%.
Andreas told me about list-tables to solve the line length problems in thesource files but I'm finding they solve other problems as well.

 
      From: Lana Brindley <openstack at lanabrindley.com>
 To: openstack-docs at lists.openstack.org 
 Sent: Sunday, November 15, 2015 1:45 PM
 Subject: Re: [OpenStack-docs] Improving tables for RST guides
   
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On 16/11/15 04:13, Andreas Jaeger wrote:
> On 11/15/2015 06:16 PM, Gauvain Pocentek wrote:
>> Hello all,
>>
>> This is a request for help :)
>>
>> Tables genereated in RST guides are not very nice at the moment (at
>> least in the config-ref, see
>> http://docs.openstack.org/draft/config-ref-rst/firewalls-default-ports.html
>> for instance).
>>
>> Do we already have a way to generate nicer tables, or do we have a CSS
>> expert who could maybe update the theme? I'd be happy to do it myself
>> but I'm *really* bad at that kind of things.
> 
> There's one change for better padding unreleased, see
> I25dc93686e45fdbc1522cded7ab413cc9d4bb0b8
> 
> But that's just one small piece of the problem,

Tables in RST generally are pretty awful. The padding will help, but I'm not sure what else can be done.

L

- -- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCAAGBQJWSP0FAAoJELppzVb4+KUyvscH/jmVjoN9YstFdYrR3VtLg5zj
zZoJGoxHfRDO14/MDBlridAGCw2ZsonUUP1RoB7qRRdNiS8PMbQPjmLEvIbiEG3a
z/xGECsIhCpV7dbMzGrU11hXjlTOHZHsGQ2hknpaPCF11INuJo+N5sEpTMOrUdSw
+a22kvsEcifLgMqHhFtcU7bBqwc+Cq1p3LDIPXbcZyhHMSIT70lrWm3a8goaTQ2j
xfOCKFBs3Gbd4kgYkprsiCmP/NXeOSr1kRGm31+T9wzg7odb5uktMTyx7kWA3Fe8
wEKfTFQWyZxMCTlRDAQws6S98w7DVK/jol2+11dca56eeUIjC//XAbh0zgUV0Cc=
=PH0f
-----END PGP SIGNATURE-----



_______________________________________________
OpenStack-docs mailing list
OpenStack-docs at lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs


   
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20151115/1b965494/attachment.html>


More information about the OpenStack-docs mailing list