org-babel bug and python docs

Dashamir Hoxha dashohoxha at gmail.com
Tue May 15 07:44:44 CEST 2018


On Tue, May 15, 2018 at 7:32 AM, Dashamir Hoxha <dashohoxha at gmail.com>
wrote:

> On Tue, May 15, 2018 at 6:24 AM, Ben McGinnes <ben at adversary.org> wrote:
>
>>
>> Specifically that babel appears to break Python code examples in which
>> there are nested indent blocks.  It's fine with the first level of
>> indentation, but does not honour subsequent levels of indentation.
>> [...]
>>
>> In the mean time, a work-around was required and I figured I had two
>> options:
>>
>> Option one: port the whole thing to reStructuredText, which is used
>> for Python documentation more generally (including the official docs).
>>
>> Option two: port the whole thing to an XML format known to be capable
>> of handling technical documentation.
>>
>
> As a third work-around option, have you tried to use '#+begin_example'
> instead of '#+begin_src', for the code examples where the identation
> is broken. The code coloring will be lost, but maybe the indentation will
> be preserved.
>

By the way, since I use org-mode in combination with Jekyll, I leave
coloring
up to Jekyll, like this:

#+BEGIN_EXPORT html
{ % highlight bash %}
#!/bin/bash

. . . . . . . . . . .

{ % endhighlight %}
#+END_EXPORT
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.gnupg.org/pipermail/gnupg-devel/attachments/20180515/502126b0/attachment-0001.html>


More information about the Gnupg-devel mailing list