<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:16px"><div id="yui_3_16_0_1_1433759163996_332333">I don't personally love the scrolling bars but they are sometimes necessary...</div><div id="yui_3_16_0_1_1433759163996_332447"><br></div><div>It would be nice if it were possible to reduce the point size for a table or a long command</div><div dir="ltr">line -- often that is enough.</div><div dir="ltr"><br></div><div dir="ltr">And the markup guide should specify the max number of characters that can be displayed</div><div dir="ltr">with the current tools. It seems that RST formats tables to fit but, for command lines, one</div><div dir="ltr">can always put a \ at the end of first lines so the text is continued on a second line, and</div><div dir="ltr">define how we format it -- I prefer that the "continuation" lines be indented a few spaces</div><div id="yui_3_16_0_1_1433759163996_332449" dir="ltr">so one sees at a glance that it is not a free-standing second command.</div><div dir="ltr"><br></div><div dir="ltr">I noticed that the RST tables are a little dull -- it would be nice if the headers were formatted</div><div dir="ltr">differently than the rest of the table.</div><div dir="ltr"><br></div><div dir="ltr">meg<br></div><div id="yui_3_16_0_1_1433759163996_332291"><span></span></div><br> <blockquote id="yui_3_16_0_1_1433759163996_332455" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1433759163996_332454" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1433759163996_332453" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1433759163996_332452" dir="ltr"> <hr size="1"> <font id="yui_3_16_0_1_1433759163996_332451" face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> Karen Bradshaw <kbhawkey@gmail.com><br> <b><span style="font-weight: bold;">To:</span></b> "openstack-docs@lists.openstack.org" <OpenStack-docs@lists.openstack.org> <br> <b><span style="font-weight: bold;">Sent:</span></b> Monday, June 8, 2015 8:12 AM<br> <b><span style="font-weight: bold;">Subject:</span></b> [OpenStack-docs] formatting, styling of RST content<br> </font> </div> <div id="yui_3_16_0_1_1433759163996_332460" class="y_msg_container"><br><div id="yiv3411721416"><div id="yui_3_16_0_1_1433759163996_332459" dir="ltr">Hi. I am wondering if anyone is thinking about or working on<div id="yui_3_16_0_1_1433759163996_332458">styling tables or python/curl script output for the RST docs. </div><div>I noticed the install guide contains a number of scrolling areas.</div><div>The docs generated from DocBook provide scrolling of content for long curl commands or tables that do not necessarily fit in the specified margin. </div><div><br></div><div>What do you think about adding scrolling to control big tables and large string commands? Is it possible to change the stylesheets/theme to permit scrolling or write a Sphinx extension to help with the table formatting?</div><div>Are there other areas to look at for improving navigation, formatting of RST content?<br></div><div>Thanks.<br></div><div>-Karen </div><div><br></div><div>-----------------------------</div><div>Karen Bradshaw</div><div><a rel="nofollow" ymailto="mailto:kbhawkey@gmail.com" target="_blank" href="mailto:kbhawkey@gmail.com">kbhawkey@gmail.com</a></div><div><br></div></div></div><br>_______________________________________________<br>OpenStack-docs mailing list<br><a ymailto="mailto:OpenStack-docs@lists.openstack.org" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br><br><br></div> </div> </div> </blockquote> </div></body></html>