Exporting blocks of text completely verbatim

Exporting blocks of text completely verbatim

[Vicente Vera]

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

Hello. This discussion
https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00163.html
points out that Org tables are converted to HTML tables when exporting
through "ox-md". Leaving Markdown-related issues aside, I've stumbled
upon this problem a while back.

It is suggested that wrapping the table within a "#+(BEGIN|END)_EXPORT
md" should leave it as-is in the exported document but that is not the
case. The table gets converted to HTML anyway.

When skimming through the Org manual I found that
"#+(BEGIN|END)_EXPORT back-end" blocks are used to export text *only*
for the specified back-end. This appears in the ASCII back-end
documentation (does it work like this for others back-ends?).

In a general level, is there a way to keep blocks of text completely
unmodified (without indentation also) on export?

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

Re: Exporting blocks of text completely verbatim

[John Kitchin]

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

Isn't

#+BEGIN_EXAMPLE
Long block
#+END_EXAMPLE

what you want?

John

-----------------------------------
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu


On Thu, Feb 9, 2017 at 3:11 PM, Vicente Vera <vicentemvp@gmail.com> wrote:

> Hello. This discussion
> https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00163.html
> points out that Org tables are converted to HTML tables when exporting
> through "ox-md". Leaving Markdown-related issues aside, I've stumbled
> upon this problem a while back.
>
> It is suggested that wrapping the table within a "#+(BEGIN|END)_EXPORT
> md" should leave it as-is in the exported document but that is not the
> case. The table gets converted to HTML anyway.
>
> When skimming through the Org manual I found that
> "#+(BEGIN|END)_EXPORT back-end" blocks are used to export text *only*
> for the specified back-end. This appears in the ASCII back-end
> documentation (does it work like this for others back-ends?).
>
> In a general level, is there a way to keep blocks of text completely
> unmodified (without indentation also) on export?
>
>

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

Re: Exporting blocks of text completely verbatim

[Vicente Vera]

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

Hmm nope. Still some modifications are introduced depending on the
back-end. Example blocks are generally indented.

There are cases where those changes makes sense such as in HTML export
but for ASCII and ASCII-based markups truly verbatim blocks would make
sense I believe.

For example, one could edit an Org document and keep some text blocks
completely unchanged so later another processing tool (such as Pandoc)
could deal with them accordingly.


2017-02-09 14:27 GMT+00:00 John Kitchin <jkitchin@andrew.cmu.edu>:

> Isn't
>
> #+BEGIN_EXAMPLE
> Long block
> #+END_EXAMPLE
>
> what you want?
>
> John
>
> -----------------------------------
> Professor John Kitchin
> Doherty Hall A207F
> Department of Chemical Engineering
> Carnegie Mellon University
> Pittsburgh, PA 15213
> 412-268-7803
> @johnkitchin
> http://kitchingroup.cheme.cmu.edu
>
>
> On Thu, Feb 9, 2017 at 3:11 PM, Vicente Vera <vicentemvp@gmail.com> wrote:
>
>> Hello. This discussion
>> https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00163.html
>> points out that Org tables are converted to HTML tables when exporting
>> through "ox-md". Leaving Markdown-related issues aside, I've stumbled
>> upon this problem a while back.
>>
>> It is suggested that wrapping the table within a "#+(BEGIN|END)_EXPORT
>> md" should leave it as-is in the exported document but that is not the
>> case. The table gets converted to HTML anyway.
>>
>> When skimming through the Org manual I found that
>> "#+(BEGIN|END)_EXPORT back-end" blocks are used to export text *only*
>> for the specified back-end. This appears in the ASCII back-end
>> documentation (does it work like this for others back-ends?).
>>
>> In a general level, is there a way to keep blocks of text completely
>> unmodified (without indentation also) on export?
>>
>>
>

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

Re: Exporting blocks of text completely verbatim

[Charles C. Berry]

On Thu, 9 Feb 2017, Vicente Vera wrote:

> Hello. This discussion
> https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00163.html
> points out that Org tables are converted to HTML tables when exporting
> through "ox-md". Leaving Markdown-related issues aside, I've stumbled
> upon this problem a while back.
>
> It is suggested that wrapping the table within a "#+(BEGIN|END)_EXPORT
> md" should leave it as-is in the exported document but that is not the
> case. The table gets converted to HTML anyway.
>

Not in recent versions of org. Here is an example of a table that is 
exported as a table without any html-ization:

#+BEGIN_SRC emacs-lisp :results raw
   (org-export-string-as
    "
   ,#+begin_export md
   | a |
   | b |
   ,#+end_export"
    'md t)

#+END_SRC

#+RESULTS:
| a |
| b |


Of course, the comma escapes are stripped before `org-export-string-as' 
sees the string.

HTH,

Chuck

Re: Exporting blocks of text completely verbatim

[Vicente Vera]

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

You're absolutely right. The MWE I made had a nasty typo that blew
everything up! I'm sorry for the noise.

The information in the manual still looks misleading to me:

#+BEGIN_EXPORT ascii
All lines in this block will appear only when using this back-end.
#+END_EXPORT

(Taken from "12.7 ASCII/Latin-1/UTF-8 export")

This doesn't seem to be related to verbatim text.

2017-02-09 19:19 GMT+00:00 Charles C. Berry <ccberry@ucsd.edu>:

> On Thu, 9 Feb 2017, Vicente Vera wrote:
>
> Hello. This discussion
>> https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00163.html
>> points out that Org tables are converted to HTML tables when exporting
>> through "ox-md". Leaving Markdown-related issues aside, I've stumbled
>> upon this problem a while back.
>>
>> It is suggested that wrapping the table within a "#+(BEGIN|END)_EXPORT
>> md" should leave it as-is in the exported document but that is not the
>> case. The table gets converted to HTML anyway.
>>
>>
> Not in recent versions of org. Here is an example of a table that is
> exported as a table without any html-ization:
>
> #+BEGIN_SRC emacs-lisp :results raw
>   (org-export-string-as
>    "
>   ,#+begin_export md
>   | a |
>   | b |
>   ,#+end_export"
>    'md t)
>
> #+END_SRC
>
> #+RESULTS:
> | a |
> | b |
>
>
> Of course, the comma escapes are stripped before `org-export-string-as'
> sees the string.
>
> HTH,
>
> Chuck
>

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