Re: [docs] [PATCH 3/3] brief-yoctoprojectqs/index.rst: switch shell block to to console lexer

["Antonin Godard" <antonin.godard@bootlin.com>]

On Fri Nov 28, 2025 at 2:11 PM CET, Antonin Godard wrote:
> Hi,
>
> On Thu Nov 27, 2025 at 5:47 PM CET, Quentin Schulz via lists.yoctoproject.org wrote:
> [...]
>>>   #. Choose a configuration (for example, ``poky-master``):
>>>   
>>> -   .. code-block:: shell
>>> +   .. code-block:: console
>>>   
>>
>> Neither shell nor console. I would suggest to simply use a literal block 
>> (::), c.f. 
>> https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#rst-literal-blocks
>
> Thanks, I'll change that.
>
> I just noticed but I think the default lexer for literal blocks is Python unless
> you explicitly set it to something else in the global configuration[1]. I think
> it makes sense to change it to "text" as the rendering looks odd in most places
> where it thinks it's Python code, whereas most of the time it's either text
> snippets or bitbake assignments.

Forgot the link :)

[1]: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks

End of the paragraph:

Code highlighting can be enabled for these literal blocks on a document-wide
basis using the highlight directive and on a project-wide basis using the
highlight_language configuration option. The code-block directive can be used to
set highlighting on a block-by-block basis.

Antonin