[OpenStack-docs] RST line length

Andreas Jaeger aj at suse.com
Mon Jun 15 06:36:23 UTC 2015


On 06/14/2015 02:37 AM, Meg McRoberts wrote:
> Are your header rows coming out bold from this output?  I tried to look
> at the Jenkins output
> but can't find this section.

It looks fine to me:

http://docs-draft.openstack.org/67/191067/6/check/gate-openstack-manuals-tox-doc-publish-checkbuild/f256d1e//publish-docs/user-guide/cli_swift_large_object_creation.html


> I think the stub-columns are for "header" columns on the left and don't
> have anything to do with
> the formatting of the header columns on top.  I did try building my
> table with stub-columns included
> and it didn't make a difference.
>
> I tried putting ** around the heading strings to bold them but that
> didn't work -- probably a bad idea
> in any event ;-)
>
> meg
>
>     ------------------------------------------------------------------------
>     *From:* Andreas Jaeger <aj at suse.com>
>     *To:* Meg McRoberts <dreidellhasa at yahoo.com>; Anne Gentle
>     <annegentle at justwriteclick.com>
>     *Cc:* "openstack-docs at lists.openstack.org"
>     <openstack-docs at lists.openstack.org>; Radoslaw Smigielski
>     <radoslaw.smigielski at alcatel-lucent.com>; Karen Bradshaw
>     <kbhawkey at gmail.com>
>     *Sent:* Saturday, June 13, 2015 2:00 AM
>     *Subject:* Re: [OpenStack-docs] RST line length
>
>     On 06/12/2015 11:27 PM, Meg McRoberts wrote:
>      > Very cool!  I just converted a table and it works quite nicely --
>      > and it should solve the checkniceness line length issues.
>      > I still do not like that the table headers look just like the body
>      > of the table but that issue is the same for either table input
>     method.
>
>     You can mark them bold, see
>     https://review.openstack.org/#/c/191067/6/doc/user-guide/source/cli_swift_large_object_creation.rst
>     <https://review.openstack.org/#/c/191067/6/doc/user-guide/source/cli_swift_large_object_creation.rst>
>     for adding stub-columns and header-rows.
>
>      > One question:  I have a little table that lists install commands
>     for the
>      > different distributions.  Karen suggested that they should use
>     :command:
>      > so I implemented this -- for example:
>      >
>      >      :command:`apt-get install rabbitmq-server rabbitmq-plugins`
>      >
>      > I did this and it works but the output looks the same as it did
>     without
>      > :command".
>      > Is that how it should be?
>
>     Could be an omission in the style we use. I suggest you file a bug.
>
>
>
>
>     Andreas
>     --
>        Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica:
>     jaegerandi
>        SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>          GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,
>              HRB 21284 (AG Nürnberg)
>          GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272
>     A126
>
>
>
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>


-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Dilip Upmanyu, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list