<div dir="ltr"><div>I believe that :: is defaulting to python console (pycon) highlighting. This would make sense, as python doc tests were all the rage back when sphinx was created.</div><div><br></div><div>If you are using the <span style="color:rgb(0,0,0);font-size:12.8000001907349px">.. code-block:: you can get a full list of supported lexers using </span><font color="#000000"><span style="font-size:12.8000001907349px">pygmentize -L and there is a highlighting test here <a href="http://pygments.org/demo/">http://pygments.org/demo/</a></span></font><br></div><div><font color="#000000"><span style="font-size:12.8000001907349px"><br></span></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px">It looks like you can set the default highlighting to use for all :: blocks using the .. highlight: directive <a href="http://sphinx-doc.org/markup/code.html">http://sphinx-doc.org/markup/code.html</a></span></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px"><br></span></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px">so if you are documenting all console sessions in a file, you should add this to the top of your file.</span></font></div><div><pre style="font-family:Consolas,'DejaVu Sans Mono','Bitstream Vera Sans Mono',monospace;font-size:13px;letter-spacing:0.015em;line-height:15.6000003814697px;padding:0.5em;border:1px solid rgb(204,204,204);border-radius:2px;color:rgb(0,0,0);background-color:rgb(248,248,248)"><span class="">..</span> <span class="" style="font-weight:bold">highlight</span><span class="">::</span> console</pre></div><div><font color="#000000"><span style="font-size:12.8000001907349px">Then any subsequent :: blocks will use console highlighting by default.</span></font></div><div><br></div><div><font color="#000000"><span style="font-size:12.8000001907349px">If you spot any problems, I can have a crack at fixing the problem but your best bet is to submit a bug here <a href="https://bitbucket.org/birkenfeld/pygments-main/issues?status=new&status=open">https://bitbucket.org/birkenfeld/pygments-main/issues?status=new&status=open</a> most of the lexers rely heavily on regular expressions so there are likely some edge cases. One is in the python console mode if you are missing a space after the >>> prompt it won't highlight correctly.</span></font></div><div><br></div><div>Shell (console) highlighting</div><div><font color="#000000"><span style="font-size:12.8000001907349px"><a href="http://pygments.org/demo/2034953/">http://pygments.org/demo/2034953/</a></span><br></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px"><br></span></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px">Python (pycon) highlighting</span></font></div><div><font color="#000000"><span style="font-size:12.8000001907349px"><a href="http://pygments.org/demo/2034997/">http://pygments.org/demo/2034997/</a></span><br></font></div></div><div class="gmail_extra"><br><div class="gmail_quote">On 30 June 2015 at 08:21, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Mon, Jun 29, 2015 at 3:38 PM, Matt Kassawara <span dir="ltr"><<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">I just use "Blah blah blah::" in the networking guide and it seems to handle both config files and CLI.</div><div><div><div class="gmail_extra"><br></div></div></div></blockquote><div><br></div></span><div>Interesting data point Matt, and observation Karen. </div><div><br></div><div>So, what she's pointing out can be seen by looking at <a href="http://docs.openstack.org/networking-guide/misc_libvirt.html" target="_blank">http://docs.openstack.org/networking-guide/misc_libvirt.html</a></div><div>and then looking at the RST source:</div><div><a href="https://raw.githubusercontent.com/openstack/openstack-manuals/master/doc/networking-guide/source/misc_libvirt.rst" target="_blank">https://raw.githubusercontent.com/openstack/openstack-manuals/master/doc/networking-guide/source/misc_libvirt.rst</a><br></div><div><br></div><div>She's asking, why does # virsh net list not have italics but #virsh net net-destroy default is not italicized? Both use the :: convention in the prior paragraph. That's where we may need another convention to use ..code-block:: console throughout books like the Networking Guide. </div><div><br></div><div>What do you think, change conventions to use the ..code-block:: console for those guides?</div><div>Anne</div><div><div class="h5"><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div><div class="gmail_extra"><div class="gmail_quote">On Mon, Jun 29, 2015 at 2:33 PM, Gauvain Pocentek <span dir="ltr"><<a href="mailto:gauvain.pocentek@objectif-libre.com" target="_blank">gauvain.pocentek@objectif-libre.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div>Le 2015-06-29 22:12, Karen Bradshaw a écrit :<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
Hi. I have been looking into the use of :: vs .. code-block::<br>
in the newly converted RST guides. I have found some inconsistencies. <br>
I found that using a root-privileged python executable with the pound sign, gets<br>
<br>
formatted like a python comment (italicized). <br>
If there is output shown after the command<br>
then the cmd and output are not italicized but treated as literal<br>
text; the single colon directive is used in this case. <br>
Using the dollar prompt, everything works as expected (not italicized).<br>
We use the literal block directive, double colon, throughout the RST guides.<br>
One way I found to get around this is to always use the dollar prompt.<br>
Another way is .. code-block::java. It is a hack, but it generates the correct<br>
output for the pound sign <python cmd>.<br>
May be someone can shed some light on this problem.<br>
</blockquote>
<br></div></div>
You probably want to use '.. code-block:: console' for interactive shell sessions (a prompt and a command followed by its output). This will show a different color for the prompt and for shell builtin commands.<br>
<br>
If I'm not mistaken :: always uses python syntax highlighting (so italic after a # sign is normal behavior), unless you specified another lexer to use in your document.<br>
<br>
Gauvain Pocentek<br>
<br>
Objectif Libre - Infrastructure et Formations Linux<br>
<a href="http://www.objectif-libre.com" rel="noreferrer" target="_blank">http://www.objectif-libre.com</a><br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br></div>
</div></div><br>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div></div></div><span class="HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr"><div>Anne Gentle</div><div>Rackspace</div><div>Principal Engineer</div><div><a href="http://www.justwriteclick.com" target="_blank">www.justwriteclick.com</a></div></div></div>
</font></span></div></div>
<br>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a 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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr">Cheers,<br>Russell Sim</div></div>
</div>