org-html-publish-to-html fails to recognize BEGIN_EXAMPLE/END_EXAMPLE blocks when exporting an example containing org-mode heading

org-html-publish-to-html fails to recognize BEGIN_EXAMPLE/END_EXAMPLE blocks when exporting an example containing org-mode heading

[Iannis Zannos]

[-- Attachment #1: Type: text/plain, Size: 1085 bytes --]

Hello,

when trying to export as html an example which contains org-mode headings,
the example is not "quoted" in mono-space as it should be. Example:

*1. Failing example: *

--------------------------------

This is a test of publishing an example which contains org mode code in
html:

#+BEGIN_EXAMPLE
* test
#+END_EXAMPLE

End of test.

--------------------------------

*2. Workaround: *

This works as expected, but only because the * headline is indented by 1
character:

--------------------------------

This is a test of publishing an example which contains org mode code in
html:

#+BEGIN_EXAMPLE
 * test
#+END_EXAMPLE

End of test.

--------------------------------

I used (meta-x) org-html-export-to-html to do the export.
Same happens with org-publish.

I am running following emacs version:
GNU Emacs 24.3.1 (x86_64-apple-darwin, NS apple-appkit-1038.36) of
2013-03-13 on bob.porkrind.org

on MacOS X 10.8.5

with org-mode version:
Org-mode version 8.0.7 (8.0.7-6-g13cb28-elpa @
/Users/iani2/.emacs.d/elpa/org-20130812/)

Is this a bug? Any suggestions?

Iannis Zannos

[-- Attachment #2: Type: text/html, Size: 1998 bytes --]

Re: org-html-publish-to-html fails to recognize BEGIN_EXAMPLE/END_EXAMPLE blocks when exporting an example containing org-mode heading

[Sebastien Vauban]

Iannis Zannos,

Iannis Zannos wrote:
> Hello,
>
> when trying to export as html an example which contains org-mode headings,
> the example is not "quoted" in mono-space as it should be. Example:
>
> *1. Failing example: *
>
> --------------------------------
>
> This is a test of publishing an example which contains org mode code in
> html:
>
> #+BEGIN_EXAMPLE
> * test
> #+END_EXAMPLE
>
> End of test.
>
> --------------------------------
>
> *2. Workaround: *
>
> This works as expected, but only because the * headline is indented by 1
> character:
>
> --------------------------------
>
> This is a test of publishing an example which contains org mode code in
> html:
>
> #+BEGIN_EXAMPLE
>  * test
> #+END_EXAMPLE
>
> End of test.

The official solution (normally automatic[1] for Org code blocks) is to have a
"," inserted before the "*"; it is removed automatically when exporting.

Best regards,
  Seb

[1] Sometimes, the "," is not automatically inserted for me, though, when
TAB'ing.

-- 
Sebastien Vauban

Re: org-html-publish-to-html fails to recognize BEGIN_EXAMPLE/END_EXAMPLE blocks when exporting an example containing org-mode heading

[Sebastien Vauban]

Hi Iannis,

Iannis Zannos wrote:
> On Thu, Sep 26, 2013 at 10:36 AM, Sebastien Vauban wrote:
>> Iannis Zannos wrote:
>> > when trying to export as html an example which contains org-mode headings,
>> > the example is not "quoted" in mono-space as it should be. Example:
>> >
>> > *1. Failing example: *
>> >
>> > This is a test of publishing an example which contains org mode code in
>> > html:
>> >
>> > #+BEGIN_EXAMPLE
>> > * test
>> > #+END_EXAMPLE
>> >
>> > End of test.
>>
>> The official solution (normally automatic for Org code blocks) is to have a
>> "," inserted before the "*"; it is removed automatically when exporting.
>
> Thank you for the answer. It is clear now.

Glad it helped!

> Perhaps the info manual of org-mode should be updated to indicate this? I
> would propose to do this in the following places in the manual:
>
> 11.3 Literal examples
> and perhaps also:
> 15.2 Easy Templates

Would you mind providing a patch?

Best regards,
  Seb

-- 
Sebastien Vauban