Re: [Docutils-users] Literal code blocks ...

[Wol <ant...@yo...>]

Now this gets really weird ...

I've put in a second literal block and what does it do? Lays it out as 
plain text, EXACTLY AS I WOULD EXPECT! Apart from the background, which 
I don't really want.

But, forgetting all the grief so far, how would YOU recommend me to 
achieve what I'm actually aiming for, which is plain text laid out in 
columns? Thing is, a lot of what I'm doing is I'm starting with two 
columns, and then splitting up the second column in two, that sort of 
thing ...

(I want it to look modern, proportional fonts, etc etc, but while it is 
a table I DON'T want it to LOOK like it's been laid out as a table...)

Cheers,
Wol

On 21/02/2022 20:20, Wol wrote:
> Literal blocks
> 
> Literal code blocks (ref) are introduced by ending a paragraph with the 
> special marker ::. The literal block must be indented (and, like all 
> paragraphs, separated from the surrounding ones by blank lines):
> 
> This is a normal text paragraph. The next paragraph is a code sample::
> 
>     It is not processed in any way, except
>     that the indentation is removed.
> 
>     It can span multiple lines.
> 
> This is a normal text paragraph again.
> 
> The handling of the :: marker is smart:
> 
> -------------------------------------------------------------------------
> 
> That's basically copied straight out of the documentation. So why, when 
> I declare a code block, has it been formatted?
> 
> If it's not processed in any way, why have I got colour-highlighting, 
> and bold text? Dunno what else it'll do ...
> 
> Or is trying to use Sphinx to write documentation just an exercise in 
> frustration? Okay, it has printed it cleanly in a fixed-width font, but 
> it certainly doesn't appear to have done what the documentation says it 
> does!
> 
> Cheers,
> Wol
> 
> 
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
> 
> Please use "Reply All" to reply to the list.